# PokerHistoryParser
## Description
A poker package to parse Hand histories into json objects
PokerHistoryParser is a powerful tool for analyzing and extracting data from poker hand histories.
This project is designed to help poker players and analysts better understand their performance by providing detailed
analyses of hands played.
## Table of Contents
- [Introduction](#introduction)
- [Installation](#installation)
- [Utilisation](#utilisation)
- [Contribuer](#contribuer)
- [Licence](#licence)
- [Auteurs](#auteurs)
## Introduction
Welcome to the PokerHistoryParser documentation.
This tool allows you to analyze poker hand histories.
It is designed to be easy to use and integrate into your projects.
It returns data as a dictionary or JSON file for easy use in your programs.
## Installation
To install the package, use the following command:
```sh
pip install pkrhistoryparser
```
## Usage
### Base Examples
Here are some simple examples of using PokerHistoryParser:
Parse a poker hand history to a dict to be used in a program:
```python
from pkrhistoryparser.parser import HandHistoryParser
parser = HandHistoryParser()
hand_text = parser.get_raw_text("path/to/hand/history.txt")
hand_info = parser.parse_hand(hand_text)
```
Parse a poker hand history to a JSON file:
```python
from pkrhistoryparser.parser import HandHistoryParser
parser = HandHistoryParser()
parser.parse_to_json('path/to/hand/history.txt', 'path/to/save/json/file.json')
```
For more details on usage, please refer to the [documentation](https://pkrhistoryparser.readthedocs.io/en/latest/).
### Supported Poker Sites
Currently, PokerHistoryParser supports the following poker sites:
- Winamax
### Upcoming Features
Here are some features we plan to add in future versions:
- Analysis of tournament summary files
- Analysis of CashGame files
- Support for more poker sites
## Contributing
All contributions are welcome! To contribute, please follow these steps:
1. Fork the repository
2. Create a branch for your feature (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
This project is licensed under the *MIT* license. See the [LICENSE](LICENSE.txt) file for more details.
## Authors
- **Alexandre MANGWA** a.k.a [Manggy94 on GitHub](https://github.com/manggy94) - *Main dev* -
## Associated Projects
- [PokerComponents](https://github.com/manggy94/PokerComponents)
---
For any questions or issues, feel free to open an issue in the repository or contact us directly.
Raw data
{
"_id": null,
"home_page": "https://github.com/manggy94/PokerHistoryParser",
"name": "pkrhistoryparser",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Alexandre MANGWA",
"author_email": "alex.mangwa@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4f/04/ecce94e519c3bea1a034ad85e0312b6dffb708f7f7c5849db0b150304035/pkrhistoryparser-3.0.3.tar.gz",
"platform": null,
"description": "\n# PokerHistoryParser\n\n## Description\nA poker package to parse Hand histories into json objects\n\nPokerHistoryParser is a powerful tool for analyzing and extracting data from poker hand histories. \nThis project is designed to help poker players and analysts better understand their performance by providing detailed \nanalyses of hands played.\n\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Installation](#installation)\n- [Utilisation](#utilisation)\n- [Contribuer](#contribuer)\n- [Licence](#licence)\n- [Auteurs](#auteurs)\n\n## Introduction\n\nWelcome to the PokerHistoryParser documentation. \nThis tool allows you to analyze poker hand histories. \nIt is designed to be easy to use and integrate into your projects. \nIt returns data as a dictionary or JSON file for easy use in your programs.\n\n\n## Installation\nTo install the package, use the following command:\n\n\n```sh\npip install pkrhistoryparser\n```\n\n## Usage\n\n### Base Examples\nHere are some simple examples of using PokerHistoryParser:\n\nParse a poker hand history to a dict to be used in a program:\n\n\n```python\nfrom pkrhistoryparser.parser import HandHistoryParser\n\nparser = HandHistoryParser()\nhand_text = parser.get_raw_text(\"path/to/hand/history.txt\")\nhand_info = parser.parse_hand(hand_text)\n ```\n\nParse a poker hand history to a JSON file:\n```python\nfrom pkrhistoryparser.parser import HandHistoryParser\n\nparser = HandHistoryParser()\nparser.parse_to_json('path/to/hand/history.txt', 'path/to/save/json/file.json')\n```\nFor more details on usage, please refer to the [documentation](https://pkrhistoryparser.readthedocs.io/en/latest/).\n\n### Supported Poker Sites\nCurrently, PokerHistoryParser supports the following poker sites:\n- Winamax\n\n### Upcoming Features\nHere are some features we plan to add in future versions:\n- Analysis of tournament summary files\n- Analysis of CashGame files\n- Support for more poker sites\n\n## Contributing\n\nAll contributions are welcome! To contribute, please follow these steps:\n\n1. Fork the repository\n2. Create a branch for your feature (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\n## License\n\nThis project is licensed under the *MIT* license. See the [LICENSE](LICENSE.txt) file for more details.\n\n## Authors\n\n- **Alexandre MANGWA** a.k.a [Manggy94 on GitHub](https://github.com/manggy94) - *Main dev* - \n\n## Associated Projects\n- [PokerComponents](https://github.com/manggy94/PokerComponents)\n\n---\n\nFor any questions or issues, feel free to open an issue in the repository or contact us directly.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A poker package to parse Hand histories into json objects",
"version": "3.0.3",
"project_urls": {
"Bug Tracker": "https://github.com/manggy94/PokerHistoryParser/issues",
"Documentation": "https://pkrhistoryparser.readthedocs.io/en/latest/parser/",
"Homepage": "https://github.com/manggy94/PokerHistoryParser"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6c782655a1d0ad09a8675d3c217e8e0769a3d35b486d40a8e8454ccfd85b51a1",
"md5": "a6ddd12ac51e2d714e5957467ec8cb41",
"sha256": "881c87ac5caf6fd50ca4b64a84647ed03a5b724de411639ea78599dbe5e9bf60"
},
"downloads": -1,
"filename": "pkrhistoryparser-3.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a6ddd12ac51e2d714e5957467ec8cb41",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 20889,
"upload_time": "2024-08-21T12:31:43",
"upload_time_iso_8601": "2024-08-21T12:31:43.235966Z",
"url": "https://files.pythonhosted.org/packages/6c/78/2655a1d0ad09a8675d3c217e8e0769a3d35b486d40a8e8454ccfd85b51a1/pkrhistoryparser-3.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4f04ecce94e519c3bea1a034ad85e0312b6dffb708f7f7c5849db0b150304035",
"md5": "419c9384acc7be9e52113f6cc780ed58",
"sha256": "3e6c1eccd91c1cdb87de6a644b63a1a5d706ba33121c7237c56895bbfabfe284"
},
"downloads": -1,
"filename": "pkrhistoryparser-3.0.3.tar.gz",
"has_sig": false,
"md5_digest": "419c9384acc7be9e52113f6cc780ed58",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 16389,
"upload_time": "2024-08-21T12:31:44",
"upload_time_iso_8601": "2024-08-21T12:31:44.769812Z",
"url": "https://files.pythonhosted.org/packages/4f/04/ecce94e519c3bea1a034ad85e0312b6dffb708f7f7c5849db0b150304035/pkrhistoryparser-3.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-21 12:31:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "manggy94",
"github_project": "PokerHistoryParser",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "awscli",
"specs": [
[
"==",
"1.33.27"
]
]
},
{
"name": "backports.tarfile",
"specs": [
[
"==",
"1.1.1"
]
]
},
{
"name": "boto3",
"specs": [
[
"==",
"1.34.145"
]
]
},
{
"name": "botocore",
"specs": [
[
"==",
"1.34.145"
]
]
},
{
"name": "certifi",
"specs": [
[
"==",
"2024.2.2"
]
]
},
{
"name": "cffi",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.3.2"
]
]
},
{
"name": "click",
"specs": [
[
"==",
"8.1.7"
]
]
},
{
"name": "colorama",
"specs": [
[
"==",
"0.4.6"
]
]
},
{
"name": "coverage",
"specs": [
[
"==",
"7.5.1"
]
]
},
{
"name": "cryptography",
"specs": [
[
"==",
"42.0.7"
]
]
},
{
"name": "docutils",
"specs": [
[
"==",
"0.16"
]
]
},
{
"name": "exceptiongroup",
"specs": [
[
"==",
"1.2.1"
]
]
},
{
"name": "ghp-import",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "griffe",
"specs": [
[
"==",
"0.45.1"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.7"
]
]
},
{
"name": "importlib_metadata",
"specs": [
[
"==",
"7.1.0"
]
]
},
{
"name": "iniconfig",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "jaraco.classes",
"specs": [
[
"==",
"3.4.0"
]
]
},
{
"name": "jaraco.context",
"specs": [
[
"==",
"5.3.0"
]
]
},
{
"name": "jaraco.functools",
"specs": [
[
"==",
"4.0.1"
]
]
},
{
"name": "jeepney",
"specs": [
[
"==",
"0.8.0"
]
]
},
{
"name": "Jinja2",
"specs": [
[
"==",
"3.1.4"
]
]
},
{
"name": "jmespath",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "keyring",
"specs": [
[
"==",
"25.2.1"
]
]
},
{
"name": "Markdown",
"specs": [
[
"==",
"3.6"
]
]
},
{
"name": "markdown-it-py",
"specs": [
[
"==",
"3.0.0"
]
]
},
{
"name": "MarkupSafe",
"specs": [
[
"==",
"2.1.5"
]
]
},
{
"name": "mdurl",
"specs": [
[
"==",
"0.1.2"
]
]
},
{
"name": "mergedeep",
"specs": [
[
"==",
"1.3.4"
]
]
},
{
"name": "mkdocs",
"specs": [
[
"==",
"1.6.0"
]
]
},
{
"name": "mkdocs-autorefs",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "mkdocs-get-deps",
"specs": [
[
"==",
"0.2.0"
]
]
},
{
"name": "mkdocstrings",
"specs": [
[
"==",
"0.25.1"
]
]
},
{
"name": "mkdocstrings-python",
"specs": [
[
"==",
"1.10.3"
]
]
},
{
"name": "more-itertools",
"specs": [
[
"==",
"10.2.0"
]
]
},
{
"name": "nh3",
"specs": [
[
"==",
"0.2.17"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"24.0"
]
]
},
{
"name": "pathspec",
"specs": [
[
"==",
"0.12.1"
]
]
},
{
"name": "pip-check-reqs",
"specs": [
[
"==",
"2.5.3"
]
]
},
{
"name": "pkginfo",
"specs": [
[
"==",
"1.10.0"
]
]
},
{
"name": "platformdirs",
"specs": [
[
"==",
"4.2.2"
]
]
},
{
"name": "pluggy",
"specs": [
[
"==",
"1.5.0"
]
]
},
{
"name": "pyasn1",
"specs": [
[
"==",
"0.6.0"
]
]
},
{
"name": "pycparser",
"specs": [
[
"==",
"2.22"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.18.0"
]
]
},
{
"name": "pymdown-extensions",
"specs": [
[
"==",
"10.8.1"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"8.2.1"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
"==",
"5.0.0"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.9.0.post0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "PyYAML",
"specs": [
[
"==",
"6.0.1"
]
]
},
{
"name": "pyyaml_env_tag",
"specs": [
[
"==",
"0.1"
]
]
},
{
"name": "readme_renderer",
"specs": [
[
"==",
"43.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.1"
]
]
},
{
"name": "requests-toolbelt",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "rfc3986",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "rich",
"specs": [
[
"==",
"13.7.1"
]
]
},
{
"name": "rsa",
"specs": [
[
"==",
"4.7.2"
]
]
},
{
"name": "s3transfer",
"specs": [
[
"==",
"0.10.2"
]
]
},
{
"name": "SecretStorage",
"specs": [
[
"==",
"3.3.3"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "tomli",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "twine",
"specs": [
[
"==",
"5.1.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.2.1"
]
]
},
{
"name": "watchdog",
"specs": [
[
"==",
"4.0.0"
]
]
},
{
"name": "zipp",
"specs": [
[
"==",
"3.18.2"
]
]
}
],
"lcname": "pkrhistoryparser"
}
