| Name | yajaw JSON |
| Version |
0.1.0.dev2
JSON |
| download |
| home_page | |
| Summary | Yet Another Jira API Wrapper |
| upload_time | 2024-01-29 05:51:51 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.11 |
| license | |
| keywords |
api
jira
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# YAJAW - Yet Another Jira API Wrapper
YAJAW is an intuitive Python library designed to simplify interactions with Atlassian's JIRA APIs. Aimed at developers, data analysts, and project managers, Yajaw facilitates seamless integration of JIRA's extensive API offerings into your Python projects with ease of use, concurrency support, and efficient handling of paginated resources.
[](https://pypi.org/project/yajaw)
[](https://pypi.org/project/yajaw)
[](https://yajaw.readthedocs.io/en/latest/?badge=latest)
## Features
- **Functional Paradigm**: Designed with a preference for functional programming to handle data-centric operations efficiently.
- **Concurrent Pagination**: Handles paginated resources concurrently, speeding up data retrieval.
- **Ease of Access**: Interact with both supported and unsupported JIRA REST APIs.
- **Simple Configuration**: Easy setup with a TOML configuration file.
- **Dual Support**: Supports both synchronous and asynchronous programming styles.
## Quickstart
1. **Installation**
Ensure you have Python 3.11 or later before installing Yajaw. The package can be installed via `pip` using the following command:
```bash
pip install yajaw
```
2. **Configuration**
Yajaw requires a dedicated configuration directory named `.yajaw`, located in your home directory. To ascertain the path to your home directory, run this Python script:
```python
from pathlib import Path
print(Path.home())
```
Should the `.yajaw` directory be absent, Yajaw will automatically create it and the necessary configuration files on first run. You are still responsible for providing your specific JIRA instance settings.
To configure, navigate to your home directory, open the `.yajaw` folder, and edit the `yajaw.toml` file. It contains default settings that you'll need to modify:
```toml
[jira]
token = "YOUR_PERSONAL_ACCESS_TOKEN"
base_url = "https://your-jira-domain.com"
server_api_v2 = "rest/api/2"
agile_api_v1 = "rest/agile/1.0"
greenhopper_api = "rest/greenhopper/1.0"
[retries]
tries = 10
delay = 0.0
backoff = 2.0
[requests]
timeout = 60
[concurrency]
semaphore_limit = 50
[pagination]
page_results = 40
```
Adjust the `token` and `base_url` with the correct values for your JIRA environment. If necessary, these adjustments can also be executed programmatically using the `yajaw.configuration` module. For further instructions, refer to the [User Guide](https://yajaw.readthedocs.io/en/latest/user-guide/index.html).
3. **Basic Usage**
The fundamental use of Yajaw involves importing the `yajaw.jira` module and calling one of its functions. For example:
```python
from yajaw import jira
projects = jira.fetch_all_projects()
# Displays <class 'list'>
print(type(projects))
# Displays the type of each accessed project, which is <class 'dict'>
print(*[type(project) for project in projects], sep="\t")
# Ensure to replace "ABC" with a valid project key
project = jira.fetch_project(project_key="ABC")
# Displays <class 'dict'>
print(type(project))
```
An asynchronous code example for fetching projects can be written as follows:
```python
import asyncio
from yajaw import jira
async def main():
projects = await jira.async_fetch_all_projects()
# Displays <class 'list'>
print(type(projects))
# Displays the type of each accessed project, which is <class 'dict'>
print(*[type(project) for project in projects], sep="\t")
# Ensure to replace "ABC" with a valid project key
project = await jira.async_fetch_project(project_key="ABC")
# Displays <class 'dict'>
print(f"Type: {type(project)}")
asyncio.run(main())
```
## Documentation
For more in-depth examples and usage instructions, visit the [official YAJAW documentation](https://yajaw.readthedocs.io/).
## Issues
If you encounter any issues or have suggestions for the project, please use the [GitHub Issues](https://github.com/unknown/rmrighes/issues) page.
## Contributing
Contributions are welcome! For more information on how to contribute, please refer to our contribution guidelines outlined in the documentation.
## License
YAJAW is distributed under the MIT License. See `LICENSE` for more details.
## Links
- Documentation: [https://yajaw.readthedocs.io/](https://yajaw.readthedocs.io/)
- Source Code: [https://github.com/rmrighes/yajaw](https://github.com/rmrighes/yajaw)
- Issues: [https://github.com/unknown/rmrighes/issues](https://github.com/unknown/rmrighes/issues)
Raw data
{
"_id": null,
"home_page": "",
"name": "yajaw",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "",
"keywords": "api,jira",
"author": "",
"author_email": "rmrighes <rmrighes@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/0f/99/306100a9ca3f9bf02d65dc384ea2fa93a08f50c495ff7ac9e2bb4c59fa81/yajaw-0.1.0.dev2.tar.gz",
"platform": null,
"description": "# YAJAW - Yet Another Jira API Wrapper\n\nYAJAW is an intuitive Python library designed to simplify interactions with Atlassian's JIRA APIs. Aimed at developers, data analysts, and project managers, Yajaw facilitates seamless integration of JIRA's extensive API offerings into your Python projects with ease of use, concurrency support, and efficient handling of paginated resources.\n\n[](https://pypi.org/project/yajaw)\n[](https://pypi.org/project/yajaw)\n[](https://yajaw.readthedocs.io/en/latest/?badge=latest)\n\n## Features\n\n- **Functional Paradigm**: Designed with a preference for functional programming to handle data-centric operations efficiently.\n- **Concurrent Pagination**: Handles paginated resources concurrently, speeding up data retrieval.\n- **Ease of Access**: Interact with both supported and unsupported JIRA REST APIs.\n- **Simple Configuration**: Easy setup with a TOML configuration file.\n- **Dual Support**: Supports both synchronous and asynchronous programming styles.\n\n## Quickstart\n\n1. **Installation**\n\n Ensure you have Python 3.11 or later before installing Yajaw. The package can be installed via `pip` using the following command:\n\n ```bash\n pip install yajaw\n ```\n\n2. **Configuration**\n\n Yajaw requires a dedicated configuration directory named `.yajaw`, located in your home directory. To ascertain the path to your home directory, run this Python script:\n\n ```python\n from pathlib import Path\n \n print(Path.home())\n ```\n\n Should the `.yajaw` directory be absent, Yajaw will automatically create it and the necessary configuration files on first run. You are still responsible for providing your specific JIRA instance settings.\n\n To configure, navigate to your home directory, open the `.yajaw` folder, and edit the `yajaw.toml` file. It contains default settings that you'll need to modify:\n\n ```toml\n [jira]\n token = \"YOUR_PERSONAL_ACCESS_TOKEN\"\n base_url = \"https://your-jira-domain.com\"\n server_api_v2 = \"rest/api/2\"\n agile_api_v1 = \"rest/agile/1.0\"\n greenhopper_api = \"rest/greenhopper/1.0\"\n \n [retries]\n tries = 10\n delay = 0.0\n backoff = 2.0\n \n [requests]\n timeout = 60\n \n [concurrency]\n semaphore_limit = 50\n \n [pagination]\n page_results = 40\n ```\n\n Adjust the `token` and `base_url` with the correct values for your JIRA environment. If necessary, these adjustments can also be executed programmatically using the `yajaw.configuration` module. For further instructions, refer to the [User Guide](https://yajaw.readthedocs.io/en/latest/user-guide/index.html).\n\n3. **Basic Usage**\n\n The fundamental use of Yajaw involves importing the `yajaw.jira` module and calling one of its functions. For example:\n\n ```python\n from yajaw import jira\n \n projects = jira.fetch_all_projects()\n \n # Displays <class 'list'>\n print(type(projects))\n # Displays the type of each accessed project, which is <class 'dict'>\n print(*[type(project) for project in projects], sep=\"\\t\")\n \n # Ensure to replace \"ABC\" with a valid project key\n project = jira.fetch_project(project_key=\"ABC\")\n # Displays <class 'dict'>\n print(type(project))\n ```\n\n An asynchronous code example for fetching projects can be written as follows:\n\n ```python\n import asyncio\n from yajaw import jira\n \n async def main():\n projects = await jira.async_fetch_all_projects()\n \n # Displays <class 'list'>\n print(type(projects))\n # Displays the type of each accessed project, which is <class 'dict'>\n print(*[type(project) for project in projects], sep=\"\\t\")\n \n # Ensure to replace \"ABC\" with a valid project key\n project = await jira.async_fetch_project(project_key=\"ABC\")\n # Displays <class 'dict'>\n print(f\"Type: {type(project)}\")\n \n asyncio.run(main())\n ```\n\n## Documentation\n\nFor more in-depth examples and usage instructions, visit the [official YAJAW documentation](https://yajaw.readthedocs.io/).\n\n## Issues\n\nIf you encounter any issues or have suggestions for the project, please use the [GitHub Issues](https://github.com/unknown/rmrighes/issues) page.\n\n## Contributing\n\nContributions are welcome! For more information on how to contribute, please refer to our contribution guidelines outlined in the documentation.\n\n## License\n\nYAJAW is distributed under the MIT License. See `LICENSE` for more details.\n\n## Links\n\n- Documentation: [https://yajaw.readthedocs.io/](https://yajaw.readthedocs.io/)\n- Source Code: [https://github.com/rmrighes/yajaw](https://github.com/rmrighes/yajaw)\n- Issues: [https://github.com/unknown/rmrighes/issues](https://github.com/unknown/rmrighes/issues)\n",
"bugtrack_url": null,
"license": "",
"summary": "Yet Another Jira API Wrapper",
"version": "0.1.0.dev2",
"project_urls": {
"Documentation": "https://yajaw.readthedocs.io/",
"Issues": "https://github.com/unknown/rmrighes/issues",
"Source": "https://github.com/rmrighes/yajaw"
},
"split_keywords": [
"api",
"jira"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "17d3ea01155159c24d704e69d9163519960b8e7980e597a317a6d893c163fe79",
"md5": "b432f4c3c96e2ff1b775da800d657c3b",
"sha256": "5b2b184c1138f796c0fcd8ffb8d239e9735dfce9913d4e4e65c62e046e7198e9"
},
"downloads": -1,
"filename": "yajaw-0.1.0.dev2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b432f4c3c96e2ff1b775da800d657c3b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 15292,
"upload_time": "2024-01-29T05:51:49",
"upload_time_iso_8601": "2024-01-29T05:51:49.961593Z",
"url": "https://files.pythonhosted.org/packages/17/d3/ea01155159c24d704e69d9163519960b8e7980e597a317a6d893c163fe79/yajaw-0.1.0.dev2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0f99306100a9ca3f9bf02d65dc384ea2fa93a08f50c495ff7ac9e2bb4c59fa81",
"md5": "6c14c1c76014965e00c34c6157868b33",
"sha256": "61f405365de4e3d654935bff998de9f5b21654f0742b031076f98da4def8b251"
},
"downloads": -1,
"filename": "yajaw-0.1.0.dev2.tar.gz",
"has_sig": false,
"md5_digest": "6c14c1c76014965e00c34c6157868b33",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 23370,
"upload_time": "2024-01-29T05:51:51",
"upload_time_iso_8601": "2024-01-29T05:51:51.686859Z",
"url": "https://files.pythonhosted.org/packages/0f/99/306100a9ca3f9bf02d65dc384ea2fa93a08f50c495ff7ac9e2bb4c59fa81/yajaw-0.1.0.dev2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-29 05:51:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "unknown",
"github_project": "rmrighes",
"github_not_found": true,
"lcname": "yajaw"
}
