py-chocolatey
=============

Python |package_bold| package provides API for Chocolatey,
the Package Manager for Windows.

Overview
========

TBD...

`PyPI record`_.

`Documentation`_.

Usage
-----

TBD...

Installation
============

Prerequisites:

+ Python 3.11 or higher

  * https://www.python.org/
  * ATTENTION: currently works and is only tested under Windows.

+ pip

  * https://pypi.org/project/pip/

To install run:

  .. parsed-literal::

    python -m pip install --upgrade |package|

Development
===========

Prerequisites:

+ Development is strictly based on *nox*. To install it run::

    python -m pip install --upgrade nox

Visit `Development page`_.

Installation from sources:

clone the sources:

  .. parsed-literal::

    git clone |respository| |package|

and run:

  .. parsed-literal::

    python -m pip install ./|package|

or on development mode:

  .. parsed-literal::

    python -m pip install --editable ./|package|

License
=======

  | |copyright|
  | Licensed under the zlib/libpng License
  | https://opensource.org/license/zlib
  | Please refer to the accompanying LICENSE file.

Authors
=======

* Adam Karpierz <adam@karpierz.net>

Sponsoring
==========

| If you would like to sponsor the development of this project, your contribution
  is greatly appreciated.
| As I am now retired, any support helps me dedicate more time to maintaining and
  improving this work.

`Donate`_

.. |package| replace:: py-chocolatey
.. |package_bold| replace:: **py-chocolatey**
.. |copyright| replace:: Copyright (c) 2022-2026 Adam Karpierz
.. |respository| replace:: https://github.com/karpierz/py-chocolatey
.. _Development page: https://github.com/karpierz/py-chocolatey
.. _PyPI record: https://pypi.org/project/py-chocolatey/
.. _Documentation: https://karpierz.github.io/py-chocolatey/
.. _Donate: https://www.paypal.com/donate/?hosted_button_id=FX8L7CJUGLW7S
