| Name | docs2us-pdf-cli JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | None |
| Summary | A CLI tool for analyzing PDFs |
| upload_time | 2024-03-30 20:37:08 |
| maintainer | None |
| docs_url | None |
| author | K Boehm |
| requires_python | <4.0,>=3.10 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Docs2Us PDF CLI
Docs2Us PDF CLI tool is a tool for obtaining brief stats concerning a PDF file.
## Table of Contents
- [Docs2Us PDF CLI](#docs2us-pdf-cli)
- [Table of Contents](#table-of-contents)
- [Getting Started](#getting-started)
- [Install](#install)
- [Runn](#runn)
- [Developing](#developing)
- [Prerequisites](#prerequisites)
- [Setting up the Development Environment](#setting-up-the-development-environment)
- [Deploying](#deploying)
- [Contributing](#contributing)
## Getting Started
These instructions will guide you on how to install and use the Docs2Us PDF CLI tool.
### Install
Install with pip
```bash
pip install docs2us-pdf-cli
```
### Runn
The command is `pdf-stats`:
```bash
pdf-stats ~/path/to/your.pdf
{
"can_open": true,
"has_toc": false,
"is_pdf": true,
"password_protected": false,
"pdf_version": "1.3",
"size_bytes": 827244,
"size_pages": 12
}
```
## Developing
### Prerequisites
- Python 3.10 or higher
- Poetry (Python dependency management tool)
If you haven't installed Poetry yet, you can find the installation instructions [here](https://python-poetry.org/docs/#installation).
### Setting up the Development Environment
1. Clone the Docs2Us PDF CLI repository to your local machine.
2. Navigate to the root directory of the cloned repository.
3. Run the following command to install the necessary dependencies:
```bash
poetry install
```
4. To build the package with any changes, increase the version in `pyproject.toml` and build:
```bash
poetry build
poetry install
```
## Deploying
Test PyPi:
```bash
poetry config repositories.testpypi https://test.pypi.org/legacy/
poetry config pypi-token.testpypi YOUR_TEST_PYPI_TOKEN
poetry publish --repository testpypi
pip install --index-url https://test.pypi.org/simple/ YOUR_PACKAGE_NAME
```
## Contributing
We welcome contributions from everyone. Here are a few guidelines to help you get started:
1. **Fork the Repository**: Start by forking the Docs2Us PDF CLI repository to your own GitHub account.
2. **Clone the Repository**: Clone the forked repository to your local machine.
3. **Create a New Branch**: Always create a new branch for your changes. This keeps the commit history clean and easy to navigate.
4. **Make Your Changes**: Make your changes in the new branch. Be sure to test your changes!
5. **Commit Your Changes**: Commit your changes regularly with clear, concise commit messages.
6. **Push Your Changes**: Once you're happy with your changes, push them to your forked repository.
7. **Submit a Pull Request**: Finally, submit a pull request from your forked repository to the original Docs2Us PDF CLI repository. Be sure to provide a clear description of the changes you've made.
Before contributing, please read our [Code of Conduct](./CODE_OF_CONDUCT.md). By participating in this project, you agree to abide by its terms.
Thank you for your interest in contributing to Docs2Us!
Raw data
{
"_id": null,
"home_page": null,
"name": "docs2us-pdf-cli",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "K Boehm",
"author_email": "kevin.boehm@orangeinfusion.com",
"download_url": "https://files.pythonhosted.org/packages/b0/e8/f986fa5505b38308a1228fb4af16a7fc370bdf559cb1c81061a6dcc3c9f7/docs2us_pdf_cli-1.0.0.tar.gz",
"platform": null,
"description": "# Docs2Us PDF CLI\n\nDocs2Us PDF CLI tool is a tool for obtaining brief stats concerning a PDF file.\n\n## Table of Contents\n\n- [Docs2Us PDF CLI](#docs2us-pdf-cli)\n - [Table of Contents](#table-of-contents)\n - [Getting Started](#getting-started)\n - [Install](#install)\n - [Runn](#runn)\n - [Developing](#developing)\n - [Prerequisites](#prerequisites)\n - [Setting up the Development Environment](#setting-up-the-development-environment)\n - [Deploying](#deploying)\n - [Contributing](#contributing)\n\n## Getting Started\n\nThese instructions will guide you on how to install and use the Docs2Us PDF CLI tool.\n\n### Install\n\nInstall with pip\n\n```bash\npip install docs2us-pdf-cli\n```\n\n### Runn\n\nThe command is `pdf-stats`:\n\n```bash\npdf-stats ~/path/to/your.pdf\n{\n \"can_open\": true,\n \"has_toc\": false,\n \"is_pdf\": true,\n \"password_protected\": false,\n \"pdf_version\": \"1.3\",\n \"size_bytes\": 827244,\n \"size_pages\": 12\n}\n```\n\n## Developing\n\n### Prerequisites\n\n- Python 3.10 or higher\n- Poetry (Python dependency management tool)\n\nIf you haven't installed Poetry yet, you can find the installation instructions [here](https://python-poetry.org/docs/#installation).\n\n### Setting up the Development Environment\n\n1. Clone the Docs2Us PDF CLI repository to your local machine.\n2. Navigate to the root directory of the cloned repository.\n3. Run the following command to install the necessary dependencies:\n\n ```bash\n poetry install\n ```\n\n4. To build the package with any changes, increase the version in `pyproject.toml` and build:\n\n ```bash\n poetry build\n poetry install\n ```\n\n## Deploying\n\nTest PyPi:\n\n```bash\npoetry config repositories.testpypi https://test.pypi.org/legacy/\npoetry config pypi-token.testpypi YOUR_TEST_PYPI_TOKEN\npoetry publish --repository testpypi\npip install --index-url https://test.pypi.org/simple/ YOUR_PACKAGE_NAME\n```\n\n## Contributing\n\nWe welcome contributions from everyone. Here are a few guidelines to help you get started:\n\n1. **Fork the Repository**: Start by forking the Docs2Us PDF CLI repository to your own GitHub account.\n2. **Clone the Repository**: Clone the forked repository to your local machine.\n3. **Create a New Branch**: Always create a new branch for your changes. This keeps the commit history clean and easy to navigate.\n4. **Make Your Changes**: Make your changes in the new branch. Be sure to test your changes!\n5. **Commit Your Changes**: Commit your changes regularly with clear, concise commit messages.\n6. **Push Your Changes**: Once you're happy with your changes, push them to your forked repository.\n7. **Submit a Pull Request**: Finally, submit a pull request from your forked repository to the original Docs2Us PDF CLI repository. Be sure to provide a clear description of the changes you've made.\n\nBefore contributing, please read our [Code of Conduct](./CODE_OF_CONDUCT.md). By participating in this project, you agree to abide by its terms.\n\nThank you for your interest in contributing to Docs2Us!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A CLI tool for analyzing PDFs",
"version": "1.0.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d43c6cd03805eda2d7d519c340f7b7f9f4a3a73e1873bea6b0a22913b34fbcd5",
"md5": "bd076f6434a2df22f423075fcc6f7707",
"sha256": "9145afa454300f8966ea8fc8414730fc2238fb39d87755443635b39b47e19a99"
},
"downloads": -1,
"filename": "docs2us_pdf_cli-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bd076f6434a2df22f423075fcc6f7707",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 4916,
"upload_time": "2024-03-30T20:37:06",
"upload_time_iso_8601": "2024-03-30T20:37:06.455557Z",
"url": "https://files.pythonhosted.org/packages/d4/3c/6cd03805eda2d7d519c340f7b7f9f4a3a73e1873bea6b0a22913b34fbcd5/docs2us_pdf_cli-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b0e8f986fa5505b38308a1228fb4af16a7fc370bdf559cb1c81061a6dcc3c9f7",
"md5": "5eecf3450caaa62e7d9ff10c7288d4f0",
"sha256": "239672b83beef524ea5b5dcef7cb634c4b13136752da796cd143b380b510031a"
},
"downloads": -1,
"filename": "docs2us_pdf_cli-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "5eecf3450caaa62e7d9ff10c7288d4f0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 4048,
"upload_time": "2024-03-30T20:37:08",
"upload_time_iso_8601": "2024-03-30T20:37:08.257294Z",
"url": "https://files.pythonhosted.org/packages/b0/e8/f986fa5505b38308a1228fb4af16a7fc370bdf559cb1c81061a6dcc3c9f7/docs2us_pdf_cli-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-30 20:37:08",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "docs2us-pdf-cli"
}
