Name | epub-simplifier JSON |
Version |
0.0.5
JSON |
| download |
home_page | None |
Summary | A command-line tool to simplify language in EPUB books |
upload_time | 2024-05-28 11:42:44 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.8 |
license | None |
keywords |
epub
language
simplification
tool
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# EPUB Simplifier
![Test](https://github.com/bubenkoff/epub-simplifier/actions/workflows/test.yml/badge.svg)
[![PyPI Version](https://img.shields.io/pypi/v/epub-simplifier.svg)
](https://pypi.python.org/pypi/epub-simplifier)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/epub-simplifier)
](https://pypi.python.org/pypi/epub-simplifier)
[![Coverage](https://img.shields.io/coveralls/bubenkoff/epub-simplifier/main.svg)
](https://coveralls.io/r/bubenkoff/epub-simplifier)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
## Description
EPUB Simplifier is a command-line tool designed to convert text within EPUB files into a simplified language at a selected proficiency level. This tool aims to make literature more accessible to language learners by simplifying complex language structures and vocabulary.
> [!WARNING]
> It uses OpenAI API and requires an API key to work, which is not provided with the package. It can also be quite expensive to use, depending on the size of the book.
## Motivation
The idea for this tool was inspired by the need to make literature more accessible to language learners. Many language learners struggle to read books in their target language due to the complexity of the language used in literature. This tool addresses this issue by simplifying the language used in books to make them more accessible to language learners at different proficiency levels.
In particular, for the Dutch language, there is a lack of literature in accessible language in electronic format. Having the text on an e-book allows using built-in dictionaries and other tools to help comprehensively understand the text.
## Installation
To install EPUB Simplifier, follow these steps:
``
pip install epub-simplifier
``
## Usage
After installation, you can use the EPUB Simplifier tool directly from your command line. The basic command structure is as follows:
``
export OPENAI_API_KEY=your_api_key
``
Optionally, set the organization ID if you have one:
``
export OPENAI_ORG_ID=your_org_id
``
Run the command:
``
epub-simplify --help
``
## Example Command
``
epub-simplify original_book.epub simplified_book.epub Dutch B1
``
This command will read `original_book.epub`, simplify its contents, and save the result as `simplified_book.epub`.
## Requirements
The dependencies will be installed automatically during the package installation process.
## Feedback and Contributions
Your feedback and contributions are welcome! If you encounter any issues or have suggestions for improvements, please feel free to open an issue on the GitHub repository or submit a pull request with your changes.
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "epub-simplifier",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "epub, language, simplification, tool",
"author": null,
"author_email": "Anatolii Bubenkov <bubenkoff@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/77/e8/b93e34e44eec9ee8a4e5298455b0c9a4facbc2ffe4c5b3bbea7771c63954/epub_simplifier-0.0.5.tar.gz",
"platform": null,
"description": "# EPUB Simplifier\n\n![Test](https://github.com/bubenkoff/epub-simplifier/actions/workflows/test.yml/badge.svg)\n[![PyPI Version](https://img.shields.io/pypi/v/epub-simplifier.svg)\n](https://pypi.python.org/pypi/epub-simplifier)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/epub-simplifier)\n](https://pypi.python.org/pypi/epub-simplifier)\n[![Coverage](https://img.shields.io/coveralls/bubenkoff/epub-simplifier/main.svg)\n](https://coveralls.io/r/bubenkoff/epub-simplifier)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n## Description\nEPUB Simplifier is a command-line tool designed to convert text within EPUB files into a simplified language at a selected proficiency level. This tool aims to make literature more accessible to language learners by simplifying complex language structures and vocabulary.\n\n> [!WARNING]\n> It uses OpenAI API and requires an API key to work, which is not provided with the package. It can also be quite expensive to use, depending on the size of the book.\n\n## Motivation\nThe idea for this tool was inspired by the need to make literature more accessible to language learners. Many language learners struggle to read books in their target language due to the complexity of the language used in literature. This tool addresses this issue by simplifying the language used in books to make them more accessible to language learners at different proficiency levels.\n\nIn particular, for the Dutch language, there is a lack of literature in accessible language in electronic format. Having the text on an e-book allows using built-in dictionaries and other tools to help comprehensively understand the text.\n\n## Installation\nTo install EPUB Simplifier, follow these steps:\n\n``\npip install epub-simplifier\n``\n\n## Usage\nAfter installation, you can use the EPUB Simplifier tool directly from your command line. The basic command structure is as follows:\n\n``\nexport OPENAI_API_KEY=your_api_key\n``\n\nOptionally, set the organization ID if you have one:\n\n``\nexport OPENAI_ORG_ID=your_org_id\n``\n\nRun the command:\n\n``\nepub-simplify --help\n``\n\n## Example Command\n\n``\nepub-simplify original_book.epub simplified_book.epub Dutch B1\n``\n\nThis command will read `original_book.epub`, simplify its contents, and save the result as `simplified_book.epub`.\n\n## Requirements\nThe dependencies will be installed automatically during the package installation process.\n\n## Feedback and Contributions\nYour feedback and contributions are welcome! If you encounter any issues or have suggestions for improvements, please feel free to open an issue on the GitHub repository or submit a pull request with your changes.\n\n## License\nMIT\n",
"bugtrack_url": null,
"license": null,
"summary": "A command-line tool to simplify language in EPUB books",
"version": "0.0.5",
"project_urls": {
"Issues": "https://github.com/bubenkoff/epub-simplifier/issues",
"Repository": "https://github.com/bubenkoff/epub-simplifier.git"
},
"split_keywords": [
"epub",
" language",
" simplification",
" tool"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cb83f1a51e8c3ca66a744e2a29dc3fecbb4eb52173c236ad71b87e379c71bb4f",
"md5": "42ee91f06fdabde205713fc9fcad5f60",
"sha256": "62e041e5851681c7a85b6233081b2370bf8722477309b4b9a37874975dd29c18"
},
"downloads": -1,
"filename": "epub_simplifier-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "42ee91f06fdabde205713fc9fcad5f60",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8331,
"upload_time": "2024-05-28T11:42:43",
"upload_time_iso_8601": "2024-05-28T11:42:43.236480Z",
"url": "https://files.pythonhosted.org/packages/cb/83/f1a51e8c3ca66a744e2a29dc3fecbb4eb52173c236ad71b87e379c71bb4f/epub_simplifier-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "77e8b93e34e44eec9ee8a4e5298455b0c9a4facbc2ffe4c5b3bbea7771c63954",
"md5": "4f23999aa164d2cc90967ac7aaf7b0a6",
"sha256": "3640e786e43a900c98a0df539cc442e461244ccdc33a326ac685e8dff7d49861"
},
"downloads": -1,
"filename": "epub_simplifier-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "4f23999aa164d2cc90967ac7aaf7b0a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 9165,
"upload_time": "2024-05-28T11:42:44",
"upload_time_iso_8601": "2024-05-28T11:42:44.699466Z",
"url": "https://files.pythonhosted.org/packages/77/e8/b93e34e44eec9ee8a4e5298455b0c9a4facbc2ffe4c5b3bbea7771c63954/epub_simplifier-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-28 11:42:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bubenkoff",
"github_project": "epub-simplifier",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "epub-simplifier"
}