Metadata-Version: 2.4
Name: grocy-py
Version: 0.0.1
Author-email: George Green <iamkarlson@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/iamkarlson/grocy-py
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: deprecation~=2.1.0
Requires-Dist: pydantic~=2.12.2
Requires-Dist: tzdata
Requires-Dist: tzlocal~=5.2
Dynamic: license-file

# grocy-py
Check out [source code reference docs](https://iamkarlson.github.io/grocy-py/)

## Installation

`pip install grocy-py`

## Usage

Import the package:

```python
from grocy import Grocy
```

Obtain a grocy instance:

```python
grocy = Grocy("https://example.com", "GROCY_API_KEY")
```

or

```python
grocy = Grocy("https://example.com", "GROCY_API_KEY", port = 9192, verify_ssl = True)
```

Get current stock:

```python
for entry in grocy.stock():
    print("{} in stock for product id {}".format(entry.available_amount, entry.id))
```

# Support

If you need help using grocy check the [discussions](https://github.com/iamkarlson/grocy-py/issues) section. Feel free to create an issue for feature requests, bugs and errors in the library.

## Development testing

You need tox and Python 3.13 to run the tests. Navigate to the root dir of `grocy` and execute `tox` to run the tests.
