[![CI Status][ci-shield]][ci-url]
[![Coverage][coverage-shield]][coverage-url]
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
<br />
<div align="center">
<a href="https://github.com/parkermmr/plyght">
<img src="https://github.com/parkermmr/Plyght/blob/main/docs/img/logo.png?raw=true" alt="Logo" width="80" height="80">
</a>
<h3 align="center">Plyght</h3>
<p align="center">
A Python utility library made for modern, robust, industry Python applications.
<br />
<a href="https://plyght.teampixl.info"><strong>Explore the docs ยป</strong></a>
<br />
<br />
<a href="https://github.com/parkermmr/plyght">View Demo</a>
·
<a href="https://github.com/parkermmr/plyght/issues/new?labels=bug&template=bug-report---.md">Report Bug</a>
·
<a href="https://https://github.com/parkermmr/plyght/issues/new?labels=enhancement&template=feature-request---.md">Request Feature</a>
</p>
</div>
<details>
<summary>Table of Contents</summary>
<ol>
<li>
<a href="#about-the-project">About The Project</a>
<ul>
<li><a href="#built-with">Built With</a></li>
</ul>
</li>
<li>
<a href="#getting-started">Getting Started</a>
<ul>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#installation">Installation</a></li>
</ul>
</li>
<li>
<a href="#usage">Usage</a>
<ul>
<li><a href="#compendium-ci">Compendium CI</a></li>
</ul>
</li>
<li><a href="#acknowledgments">Acknowledgments</a></li>
</ol>
</details>
## About The Project
Plyght is an open-source lightweight Python utility library that provides extended capability for client services configurations, function decorations, advanced logging, format converters, and more. The premise of Plyght is to improve exisiting functionality and enhance the developer experience and readbility of code. Plyght is an opinionated Python library, prefering explicit, declarative programming. In general, its implementations are stand alone, but are best served using the entire application framework.
### Built With
<p align="center">
- [![Python][python]][python-url]
- [![Git][git]][git-url]
- [![GitHub Actions][github-actions]][github-actions-url]
- [![Docker][docker]][docker-url]
</p>
<p align="right">(<a href="#readme-top">back to top</a>)</p>
## Getting Started
To get started it best you follow the introductory guide at [Plyght](https://plyght.teampixl.info/getting-started).
### Prerequisites
This project relies on Python, Poetry, and Git. Apart from those, that's it! It is important that the correct versions of Python and Poetry are installed, otherwise all the dependencies are managed in the `pyptoject.toml` file at the root directory. The below version are relevant to the project:
```python
python=^3.13
poetry=^2.0.0
```
Additionally, the package is planned to be released on PyPi as an installation which can be done directly through poetry, pip, or any other Python package manager; opposed to installation direct from source.
### Installation
The installation of Plyght can be done through the pip or poetry using the `pyproject.toml`. Additionally, if the installation requires additional supporting functionality such as Kafka, Neo4j, OpenSearch et al, you will need to specify those in the installation step.
<details>
<summary>Poetry</summary>
```bash
#Installing without additional dependencies.
poetry install
#Installing with additional depedencies.
poetry install --extras "neo4j kafka ..."
```
</details>
<details>
<summary>Pip</summary>
```bash
#Installing without additional dependencies.
pip install .
#Installing with additional depedencies.
poetry install "[neo4j,kafka,...]"
```
</details>
### Compendium CI
The current workflow being used is a Compendium CI Python Poetry pipeline with comprehensive checks for testing, linting, style, code security and structure. Compendium is a GitHub specific CI suite fully managed [here][compendium]. It is important that before any pushes are made the code quality checks and reformatting are ran. This can be done with the following commands:
```bash
poetry run black plyght
```
This will ensure the pipeline completes successfully and all code is to an appropriate format standard. For more information on the linting configuration seek out the `pyproject.toml` configuration under `[tools.black]` as well as the `.flake8` configuration file.
### Acknowledgments:
<a href="https://github.com/parkermmr/kraken/graphs/contributors">
<img src="https://contrib.rocks/image?repo=parkermmr/kraken" alt="contrib.rocks image" />
</a>
<p align="right">(<a href="#readme-top">back to top</a>)</p>
[ci-shield]: https://img.shields.io/github/actions/workflow/status/parkermmr/plyght/compendium.yml?branch=main&style=for-the-badge
[ci-url]: https://github.com/parkermmr/plyght/actions/workflows/compendium.yml
[coverage-shield]: https://img.shields.io/codecov/c/github/parkermmr/cab320a1?style=for-the-badge
[coverage-url]: https://codecov.io/gh/parkermmr/plyght
[contributors-shield]: https://img.shields.io/github/contributors/parkermmr/plyght.svg?style=for-the-badge
[contributors-url]: https://github.com/parkermmr/plyght/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/parkermmr/plyght.svg?style=for-the-badge
[forks-url]: https://github.com/parkermmr/plyght/network/members
[stars-shield]: https://img.shields.io/github/stars/parkermmr/plyght.svg?style=for-the-badge
[stars-url]: https://github.com/parkermmr/plyght/stargazers
[issues-shield]: https://img.shields.io/github/issues/parkermmr/plyght.svg?style=for-the-badge
[issues-url]: https://github.com/parkermmr/plyght/issues
[python]: https://img.shields.io/badge/python-FFE873?style=for-the-badge&logo=python&logoColor
[python-url]: https://www.python.org/
[git]: https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=Git&logoColor=white
[git-url]: https://git-scm.com/
[github-actions]: https://img.shields.io/badge/GitHub%20Actions-2088FF?style=for-the-badge&logo=GitHub%20Actions&logoColor=white
[github-actions-url]: https://github.com/features/actions
[docker]: https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=Docker&logoColor=white
[docker-url]: https://www.docker.com/
[compendium]: https://github.com/parkermmr/compendium
Raw data
{
"_id": null,
"home_page": "https://github.com/parkermmr/plyght",
"name": "Plyght",
"maintainer": "Parker",
"docs_url": null,
"requires_python": "<4,>=3.9",
"maintainer_email": null,
"keywords": "python, utility, modern, neo4j, kafka, opensearch, s3",
"author": "Parker",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/e1/39/98039efa19bdd200a0b6fa4ef00426e6043d781c4f903b34d293a2b524f1/plyght-0.1.2.tar.gz",
"platform": null,
"description": "[![CI Status][ci-shield]][ci-url]\n[![Coverage][coverage-shield]][coverage-url]\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n\n\n<br />\n<div align=\"center\">\n <a href=\"https://github.com/parkermmr/plyght\">\n <img src=\"https://github.com/parkermmr/Plyght/blob/main/docs/img/logo.png?raw=true\" alt=\"Logo\" width=\"80\" height=\"80\">\n </a>\n\n <h3 align=\"center\">Plyght</h3>\n\n <p align=\"center\">\n A Python utility library made for modern, robust, industry Python applications.\n <br />\n <a href=\"https://plyght.teampixl.info\"><strong>Explore the docs \u00bb</strong></a>\n <br />\n <br />\n <a href=\"https://github.com/parkermmr/plyght\">View Demo</a>\n ·\n <a href=\"https://github.com/parkermmr/plyght/issues/new?labels=bug&template=bug-report---.md\">Report Bug</a>\n ·\n <a href=\"https://https://github.com/parkermmr/plyght/issues/new?labels=enhancement&template=feature-request---.md\">Request Feature</a>\n </p>\n</div>\n\n<details>\n <summary>Table of Contents</summary>\n <ol>\n <li>\n <a href=\"#about-the-project\">About The Project</a>\n <ul>\n <li><a href=\"#built-with\">Built With</a></li>\n </ul>\n </li>\n <li>\n <a href=\"#getting-started\">Getting Started</a>\n <ul>\n <li><a href=\"#prerequisites\">Prerequisites</a></li>\n <li><a href=\"#installation\">Installation</a></li>\n </ul>\n </li>\n <li>\n <a href=\"#usage\">Usage</a>\n <ul>\n <li><a href=\"#compendium-ci\">Compendium CI</a></li>\n </ul>\n </li>\n <li><a href=\"#acknowledgments\">Acknowledgments</a></li>\n </ol>\n</details>\n\n## About The Project\nPlyght is an open-source lightweight Python utility library that provides extended capability for client services configurations, function decorations, advanced logging, format converters, and more. The premise of Plyght is to improve exisiting functionality and enhance the developer experience and readbility of code. Plyght is an opinionated Python library, prefering explicit, declarative programming. In general, its implementations are stand alone, but are best served using the entire application framework.\n\n### Built With\n\n<p align=\"center\">\n \n- [![Python][python]][python-url]\n- [![Git][git]][git-url]\n- [![GitHub Actions][github-actions]][github-actions-url]\n- [![Docker][docker]][docker-url]\n\n</p>\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n## Getting Started\nTo get started it best you follow the introductory guide at [Plyght](https://plyght.teampixl.info/getting-started).\n\n### Prerequisites\nThis project relies on Python, Poetry, and Git. Apart from those, that's it! It is important that the correct versions of Python and Poetry are installed, otherwise all the dependencies are managed in the `pyptoject.toml` file at the root directory. The below version are relevant to the project:\n```python\npython=^3.13\npoetry=^2.0.0\n```\nAdditionally, the package is planned to be released on PyPi as an installation which can be done directly through poetry, pip, or any other Python package manager; opposed to installation direct from source.\n\n### Installation\nThe installation of Plyght can be done through the pip or poetry using the `pyproject.toml`. Additionally, if the installation requires additional supporting functionality such as Kafka, Neo4j, OpenSearch et al, you will need to specify those in the installation step.\n\n<details>\n<summary>Poetry</summary>\n\n```bash\n#Installing without additional dependencies.\npoetry install\n\n#Installing with additional depedencies.\npoetry install --extras \"neo4j kafka ...\"\n```\n\n</details>\n\n<details>\n<summary>Pip</summary>\n\n```bash\n#Installing without additional dependencies.\npip install .\n\n#Installing with additional depedencies.\npoetry install \"[neo4j,kafka,...]\"\n```\n\n</details>\n\n### Compendium CI\nThe current workflow being used is a Compendium CI Python Poetry pipeline with comprehensive checks for testing, linting, style, code security and structure. Compendium is a GitHub specific CI suite fully managed [here][compendium]. It is important that before any pushes are made the code quality checks and reformatting are ran. This can be done with the following commands:\n```bash\npoetry run black plyght\n```\nThis will ensure the pipeline completes successfully and all code is to an appropriate format standard. For more information on the linting configuration seek out the `pyproject.toml` configuration under `[tools.black]` as well as the `.flake8` configuration file.\n\n### Acknowledgments:\n\n<a href=\"https://github.com/parkermmr/kraken/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=parkermmr/kraken\" alt=\"contrib.rocks image\" />\n</a>\n\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\n\n[ci-shield]: https://img.shields.io/github/actions/workflow/status/parkermmr/plyght/compendium.yml?branch=main&style=for-the-badge\n[ci-url]: https://github.com/parkermmr/plyght/actions/workflows/compendium.yml\n[coverage-shield]: https://img.shields.io/codecov/c/github/parkermmr/cab320a1?style=for-the-badge\n[coverage-url]: https://codecov.io/gh/parkermmr/plyght\n[contributors-shield]: https://img.shields.io/github/contributors/parkermmr/plyght.svg?style=for-the-badge\n[contributors-url]: https://github.com/parkermmr/plyght/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/parkermmr/plyght.svg?style=for-the-badge\n[forks-url]: https://github.com/parkermmr/plyght/network/members\n[stars-shield]: https://img.shields.io/github/stars/parkermmr/plyght.svg?style=for-the-badge\n[stars-url]: https://github.com/parkermmr/plyght/stargazers\n[issues-shield]: https://img.shields.io/github/issues/parkermmr/plyght.svg?style=for-the-badge\n[issues-url]: https://github.com/parkermmr/plyght/issues\n[python]: https://img.shields.io/badge/python-FFE873?style=for-the-badge&logo=python&logoColor\n[python-url]: https://www.python.org/\n[git]: https://img.shields.io/badge/Git-F05032?style=for-the-badge&logo=Git&logoColor=white\n[git-url]: https://git-scm.com/\n[github-actions]: https://img.shields.io/badge/GitHub%20Actions-2088FF?style=for-the-badge&logo=GitHub%20Actions&logoColor=white\n[github-actions-url]: https://github.com/features/actions\n[docker]: https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=Docker&logoColor=white\n[docker-url]: https://www.docker.com/\n[compendium]: https://github.com/parkermmr/compendium\n",
"bugtrack_url": null,
"license": ".github/LICENSE",
"summary": null,
"version": "0.1.2",
"project_urls": {
"Documentation": "https://plyght.teampixl.info",
"Homepage": "https://github.com/parkermmr/plyght",
"Issues": "https://github.com/parkermmr/plyght/issues",
"Repository": "https://github.com/parkermmr/plyght"
},
"split_keywords": [
"python",
" utility",
" modern",
" neo4j",
" kafka",
" opensearch",
" s3"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9fe67e511dcee301b64e4b562e39722f982d98d25f1fa783730bf89d9504b4d7",
"md5": "eb5a13d9700770880972e833e15fde4d",
"sha256": "2f16f28c620f8c85514fc628dfd747efd55181740329a4b43314b008da7815a8"
},
"downloads": -1,
"filename": "plyght-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eb5a13d9700770880972e833e15fde4d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.9",
"size": 39685,
"upload_time": "2025-07-19T03:08:41",
"upload_time_iso_8601": "2025-07-19T03:08:41.749703Z",
"url": "https://files.pythonhosted.org/packages/9f/e6/7e511dcee301b64e4b562e39722f982d98d25f1fa783730bf89d9504b4d7/plyght-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e13998039efa19bdd200a0b6fa4ef00426e6043d781c4f903b34d293a2b524f1",
"md5": "0dc1dbb81e9a47bb7b48c91238b4763a",
"sha256": "83cc4252d87cac01b2336aafc569fc1570da6f4eaf0d747239751aa3c4c43cee"
},
"downloads": -1,
"filename": "plyght-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "0dc1dbb81e9a47bb7b48c91238b4763a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.9",
"size": 24073,
"upload_time": "2025-07-19T03:08:42",
"upload_time_iso_8601": "2025-07-19T03:08:42.951152Z",
"url": "https://files.pythonhosted.org/packages/e1/39/98039efa19bdd200a0b6fa4ef00426e6043d781c4f903b34d293a2b524f1/plyght-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-19 03:08:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "parkermmr",
"github_project": "plyght",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "plyght"
}
JSON
