Metadata-Version: 2.4
Name: eboekhouden-python
Version: 0.4.1
Summary: This is a simple API client for the E-boekhouden.nl API. It is written in Python and uses the ZEEP library.
Project-URL: Homepage, https://github.com/dennisbakhuis/eboekhouden-python
Project-URL: Repository, https://github.com/dennisbakhuis/eboekhouden-python
Author-email: Dennis Bakhuis <pypi@bakhuis.nu>
License: MIT
License-File: LICENSE
Keywords: api,client,e-boekhouden,eboekhouden,python,soap,zeep
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: zeep>=4.3.1
Provides-Extra: dev
Requires-Dist: coverage>=7.6.10; extra == 'dev'
Requires-Dist: jupyter>=1.1.1; extra == 'dev'
Requires-Dist: jupyterlab>=4.3.4; extra == 'dev'
Requires-Dist: packaging>=23.0; extra == 'dev'
Requires-Dist: pre-commit>=4.0.1; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest>=8.3.4; extra == 'dev'
Requires-Dist: tomli>=2.2.1; extra == 'dev'
Description-Content-Type: text/markdown

# E-boekhouden-Python API client
This is a simple API client for the E-boekhouden.nl API. It is written in Python and uses the ZEEP library. This library is partly inspired by work of Roel van den Boom.

## Installation and basic configuration
To install the library, simply run the following command:

```bash
pip install eboekhouden-python
```

To use the library, you need to configure it with your API credentials. While you can add these credentials as parameters to the class constructor, it is recommended to use environment variables. The following environment variables are automatically recognized by the library:

```bash
EBOEKHOUDEN_USERNAME=your_username
EBOEKHOUDEN_CODE1=your_code_1
EBOEKHOUDEN_CODE2=your_code_2
```

## Usage
The library is very simple to use. The following example shows how to retrieve a list of all mutations:

```python
from eboekhouden_python import EboekhoudenClient

client = EboekhoudenClient()
mutations = client.get_mutaties()
```

## Development
Feel free to extend the library, pull requests are welcome. For a development environment, you can use the following commands:

```bash
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies and create virtual environment
uv sync --extra dev

# Install pre-commit hooks
uv run pre-commit install
```
