# Monday.com API Client
[](https://monday-client.readthedocs.io/en/latest/?badge=latest)
[](https://badge.fury.io/py/monday-client)
[](https://pypi.org/project/monday-client/)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/LeetCyberSecurity/monday-client/issues)
[](https://github.com/LeetCyberSecurity/monday-client/commits/main)
This Python library provides an **asynchronous** client to interact with the [Monday.com API](https://developer.monday.com/api-reference/reference/about-the-api-reference).
## Documentation
For detailed documentation, please visit the [official documentation site](https://monday-client.readthedocs.io).
## Key Features
- **Asynchronous API calls** using `asyncio` and `aiohttp` for efficient I/O operations.
- **Automatic handling of API rate limits and query limits** following Monday.com's rate limit policies.
- **Built-in retry logic** for handling rate limit exceptions, ensuring smooth operation without manual intervention.
- **Easy-to-use methods** for common Monday.com operations.
- **Fully customizable requests** with all Monday.com method arguments and fields available to the user.
## Installation
```bash
pip install monday-client
```
## Quick Start
```python
import asyncio
from monday import MondayClient
async def main():
client = MondayClient(api_key='your_api_key_here')
boards = await client.boards.query(board_ids=[1234567890, 1234567891])
items_page = await client.items.items_page(board_ids=[1234567890, 1234567891])
asyncio.run(main())
```
## Usage
### Asynchronous Operations
All methods provided by the `MondayClient` are asynchronous and should be awaited. This allows for efficient concurrent execution of API calls.
### Rate Limiting and Retry Logic
The client automatically handles rate limiting in compliance with Monday.com's API policies. When a rate limit is reached, the client will wait for the specified reset time before retrying the request. This ensures that your application doesn't need to manually handle rate limit exceptions and can operate smoothly.
### Error Handling
Custom exceptions are defined for handling specific error cases:
- `MondayAPIError`: Raised when an error occurs during API communication with Monday.com.
- `PaginationError`: Raised when item pagination fails during a request.
- `QueryFormatError`: Raised when there is a query formatting error.
These exceptions are handled internally by the client during retries. If the maximum number of retries is exceeded, the client will return an error response.
- `ComplexityLimitExceeded`: Raised when the complexity limit is exceeded.
- `MutationLimitExceeded`: Raised when the mutation limit is exceeded.
### Logging
The client uses a logger named `monday_client` for all logging operations. By default, a `NullHandler` is added to suppress logging output. To enable logging, you can configure the logger in your application:
```python
import logging
logger = logging.getLogger('monday_client')
logger.setLevel(logging.INFO)
handler = logging.StreamHandler()
handler.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))
logger.addHandler(handler)
```
## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](https://github.com/LeetCyberSecurity/monday-client/blob/main/LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/LeetCyberSecurity/monday-client",
"name": "monday-client",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "monday, monday.com, api, client, async, rate-limiting, complexity-limiting",
"author": "Dan Hollis",
"author_email": "Dan Hollis <dh@leetsys.com>",
"download_url": "https://files.pythonhosted.org/packages/ac/8b/a2b34c0f613fe146701941a718999ba71850c4b06a00ea93da29dc4ab29a/monday_client-0.1.52.tar.gz",
"platform": null,
"description": "# Monday.com API Client\n\n\n\n[](https://monday-client.readthedocs.io/en/latest/?badge=latest)\n[](https://badge.fury.io/py/monday-client)\n[](https://pypi.org/project/monday-client/)\n[](https://www.gnu.org/licenses/gpl-3.0)\n[](https://github.com/LeetCyberSecurity/monday-client/issues)\n[](https://github.com/LeetCyberSecurity/monday-client/commits/main)\n\nThis Python library provides an **asynchronous** client to interact with the [Monday.com API](https://developer.monday.com/api-reference/reference/about-the-api-reference).\n\n## Documentation\n\nFor detailed documentation, please visit the [official documentation site](https://monday-client.readthedocs.io).\n\n## Key Features\n\n- **Asynchronous API calls** using `asyncio` and `aiohttp` for efficient I/O operations.\n- **Automatic handling of API rate limits and query limits** following Monday.com's rate limit policies.\n- **Built-in retry logic** for handling rate limit exceptions, ensuring smooth operation without manual intervention.\n- **Easy-to-use methods** for common Monday.com operations.\n- **Fully customizable requests** with all Monday.com method arguments and fields available to the user.\n\n## Installation\n\n```bash\npip install monday-client\n```\n\n## Quick Start\n\n```python\nimport asyncio\n\nfrom monday import MondayClient\n\nasync def main():\n client = MondayClient(api_key='your_api_key_here')\n boards = await client.boards.query(board_ids=[1234567890, 1234567891])\n items_page = await client.items.items_page(board_ids=[1234567890, 1234567891])\n\nasyncio.run(main())\n```\n\n\n## Usage\n\n### Asynchronous Operations\n\nAll methods provided by the `MondayClient` are asynchronous and should be awaited. This allows for efficient concurrent execution of API calls.\n\n### Rate Limiting and Retry Logic\n\nThe client automatically handles rate limiting in compliance with Monday.com's API policies. When a rate limit is reached, the client will wait for the specified reset time before retrying the request. This ensures that your application doesn't need to manually handle rate limit exceptions and can operate smoothly.\n\n### Error Handling\n\nCustom exceptions are defined for handling specific error cases:\n\n- `MondayAPIError`: Raised when an error occurs during API communication with Monday.com.\n- `PaginationError`: Raised when item pagination fails during a request.\n- `QueryFormatError`: Raised when there is a query formatting error.\n\nThese exceptions are handled internally by the client during retries. If the maximum number of retries is exceeded, the client will return an error response.\n\n- `ComplexityLimitExceeded`: Raised when the complexity limit is exceeded.\n- `MutationLimitExceeded`: Raised when the mutation limit is exceeded.\n\n### Logging\n\nThe client uses a logger named `monday_client` for all logging operations. By default, a `NullHandler` is added to suppress logging output. To enable logging, you can configure the logger in your application:\n\n```python\nimport logging\n\nlogger = logging.getLogger('monday_client')\nlogger.setLevel(logging.INFO)\nhandler = logging.StreamHandler()\nhandler.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))\nlogger.addHandler(handler)\n```\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](https://github.com/LeetCyberSecurity/monday-client/blob/main/LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 or later (GPLv3+)",
"summary": "Python library for interacting with the monday.com API. Respects monday.com API rate limits and query complexity limits.",
"version": "0.1.52",
"project_urls": {
"Bug Reports": "https://github.com/LeetCyberSecurity/monday-client/issues",
"Documentation": "https://monday-client.readthedocs.io/",
"Homepage": "https://github.com/LeetCyberSecurity/monday-client",
"Source": "https://github.com/LeetCyberSecurity/monday-client"
},
"split_keywords": [
"monday",
" monday.com",
" api",
" client",
" async",
" rate-limiting",
" complexity-limiting"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1f51b7d793ec90a35ae93ec305979c734ccc1bca1c3888f3a60a2f26136eefb7",
"md5": "9c0780c76cd717abb7ed8d016d41d4c1",
"sha256": "4d5a15cbb86a0e9fa1344dd6f98957d8ec6859abc0df9e1dc89cf9377f736c99"
},
"downloads": -1,
"filename": "monday_client-0.1.52-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9c0780c76cd717abb7ed8d016d41d4c1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 67163,
"upload_time": "2024-11-15T17:59:59",
"upload_time_iso_8601": "2024-11-15T17:59:59.756771Z",
"url": "https://files.pythonhosted.org/packages/1f/51/b7d793ec90a35ae93ec305979c734ccc1bca1c3888f3a60a2f26136eefb7/monday_client-0.1.52-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ac8ba2b34c0f613fe146701941a718999ba71850c4b06a00ea93da29dc4ab29a",
"md5": "5bda41a062192bf45dcea79868e1a4f0",
"sha256": "9a5ecc7e06a637f3ea9cd32cd130b4ed2192c1de0df2bb48c4dae45551977d2d"
},
"downloads": -1,
"filename": "monday_client-0.1.52.tar.gz",
"has_sig": false,
"md5_digest": "5bda41a062192bf45dcea79868e1a4f0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 42359,
"upload_time": "2024-11-15T18:00:00",
"upload_time_iso_8601": "2024-11-15T18:00:00.895081Z",
"url": "https://files.pythonhosted.org/packages/ac/8b/a2b34c0f613fe146701941a718999ba71850c4b06a00ea93da29dc4ab29a/monday_client-0.1.52.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-15 18:00:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "LeetCyberSecurity",
"github_project": "monday-client",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "monday-client"
}
JSON
