| Name | adobe-helper JSON |
| Version |
1.2.0
JSON |
| download |
| home_page | None |
| Summary | Python client for Adobe PDF to Word conversion using Adobe's online services |
| upload_time | 2025-10-22 01:53:53 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. |
| keywords |
adobe
api
async
conversion
docx
httpx
pdf
word
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
httpx
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Adobe Helper
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
[](https://github.com/astral-sh/ruff)
**Adobe Helper** is a Python library for converting PDF files to Word (DOCX) format using Adobe's online conversion services. It provides a clean, async API with automatic session management, rate limiting, and quota tracking.
## ⚠️ Current Status
**This project is fully functional out-of-the-box!** The library includes working API endpoint patterns discovered from Adobe's online service. Simply install and start converting PDFs to Word documents.
### Recent Updates (2025-10-21)
✅ **Embedded API Endpoints** (NEW!)
- Working endpoint patterns now embedded in the codebase
- No manual endpoint discovery required for basic usage
- Library works out-of-the-box after `pip install`
- Automatic tenant ID substitution for each session
✅ **Multi-Tenant Architecture**
- Automatic tenant discovery during session initialization
- Dynamic endpoint switching per session
- Support for multiple regions and tenant IDs
- Each session discovers its own numeric tenant ID from Adobe's servers
✅ **Logging Enhancement**
- Examples now include proper logging configuration
- Real-time visibility into conversion progress
- Better debugging and troubleshooting support
Advanced users can still manually discover and configure custom endpoints if needed. See [docs/discovery/API_DISCOVERY.md](docs/discovery/API_DISCOVERY.md) for details.
## Features
✨ **Easy to Use**
- Simple async API with context manager support
- Automatic session management and rotation
- Built-in retry logic with exponential backoff
- **Bypass local usage limits** (mimics clearing browser data)
📊 **Smart Management**
- Optional usage tracking with daily limits
- Intelligent rate limiting with human-like delays
- Automatic session rotation for unlimited conversions
- Fresh session creation (like incognito mode)
🔒 **Reliable**
- Streaming upload/download for large files
- File integrity verification
- Comprehensive error handling
- Progress tracking support
🚀 **Fast**
- Async/await throughout
- HTTP/2 support via httpx
- Concurrent batch processing
## Installation
### Using uv (Recommended)
```bash
# Clone the repository
git clone https://github.com/karlorz/adobe-helper.git
cd adobe-helper
# Install with uv
uv sync --all-extras
```
### Using pip
```bash
# Clone the repository
git clone https://github.com/karlorz/adobe-helper.git
cd adobe-helper
# Install in development mode
pip install -e .
```
## Quick Start
### Basic Usage
```python
import asyncio
import logging
from pathlib import Path
from adobe import AdobePDFConverter
# Configure logging to see conversion progress
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
)
async def main():
# Convert a PDF to Word (bypasses local limits by default)
async with AdobePDFConverter(
bypass_local_limits=True # Mimics clearing browser data
) as converter:
output_file = await converter.convert_pdf_to_word(
Path("document.pdf")
)
print(f"Converted: {output_file}")
asyncio.run(main())
```
### Batch Conversion
```python
from adobe import AdobePDFConverter
async def batch_convert():
pdf_files = [
Path("doc1.pdf"),
Path("doc2.pdf"),
Path("doc3.pdf"),
]
async with AdobePDFConverter() as converter:
for pdf_file in pdf_files:
try:
output = await converter.convert_pdf_to_word(pdf_file)
print(f"✓ {pdf_file.name} -> {output.name}")
except Exception as e:
print(f"✗ {pdf_file.name}: {e}")
```
### Advanced Configuration
```python
from adobe import AdobePDFConverter
from pathlib import Path
async def advanced_convert():
# Custom configuration
converter = AdobePDFConverter(
session_dir=Path(".cache"), # Custom cache directory
use_session_rotation=True, # Enable session rotation
track_usage=True, # Track daily quota
enable_rate_limiting=True, # Rate limiting
)
try:
await converter.initialize()
# Convert with custom output path
output = await converter.convert_pdf_to_word(
Path("input.pdf"),
output_path=Path("output/converted.docx"),
)
# Check usage stats
usage = converter.get_usage_summary()
print(f"Daily usage: {usage['count']}/{usage['limit']}")
finally:
await converter.close()
```
## Endpoint Discovery CLI
Use the bundled helper to capture endpoints and keep discovery files synced:
```bash
# Show available commands
python -m adobe.cli.api_discovery_helper --help
# Create or refresh the project discovery template
python -m adobe.cli.api_discovery_helper template
# Validate captured URLs and sync project ↔ user cache copies
python -m adobe.cli.api_discovery_helper update
# Installed entry point (after `pip install .`)
adobe-api-discovery checklist
```
See [docs/discovery/API_DISCOVERY.md](docs/discovery/API_DISCOVERY.md) for the full walkthrough.
The helper stores discovered endpoints in `~/.adobe-helper` by default, but will fall back to `./.adobe-helper` (or the system temp directory) automatically when the home directory is not writable—useful for containerized or sandboxed environments.
## Architecture
### Core Components
```
adobe/
├── client.py # Main AdobePDFConverter class
├── auth.py # Session management
├── session_cycling.py # Anonymous session rotation
├── cookie_manager.py # Cookie persistence
├── upload.py # File upload handler
├── conversion.py # Conversion workflow manager
├── download.py # File download handler
├── rate_limiter.py # Rate limiting with backoff
├── usage_tracker.py # Free tier quota tracking
├── models.py # Pydantic data models
├── exceptions.py # Custom exceptions
├── constants.py # Configuration constants
├── urls.py # API endpoints
└── utils.py # Helper functions
```
### Data Flow
```
PDF File → Upload → Conversion Job → Poll Status → Download DOCX
↓ ↓ ↓ ↓
Validate Create Job Wait/Poll Stream Download
Retry Track Status Adaptive Verify
Polling Integrity
```
## Examples
See the [`examples/adobe/`](examples/adobe/) directory for complete examples:
- **basic_usage.py** - Simple conversion with bypass enabled
- **batch_convert.py** - Sequential and concurrent batch processing
- **advanced_usage.py** - Advanced configuration and error handling
Legacy bypass/reset scripts now live under `archive/docs/` for reference.
### Bypassing Usage Limits
By default, the library now bypasses local usage tracking and relies on Adobe's server-side limits with automatic session rotation:
```python
# Automatic session rotation (recommended for batch processing)
async with AdobePDFConverter(
bypass_local_limits=True, # Default: True
use_session_rotation=True, # Auto-rotate sessions
) as converter:
for pdf in pdf_files:
await converter.convert_pdf_to_word(pdf)
```
For more details, see [BYPASS_LIMITS.md](BYPASS_LIMITS.md).
**Quick reset**: Call `AdobePDFConverter.reset_session_data()` (or use `AdobePDFConverter.create_with_fresh_session()`) to clear all local state; the legacy helper script now resides in `archive/docs/`.
## API Discovery Required
⚠️ **Important**: Before this library can perform actual conversions, you need to discover Adobe's API endpoints using Chrome DevTools.
See [docs/discovery/API_DISCOVERY.md](docs/discovery/API_DISCOVERY.md) for detailed instructions.
Discovered endpoint files are cached automatically: any `discovered_endpoints.json` found in `docs/discovery/` or `archive/discovery/` is copied into `~/.adobe-helper/` on first run, and a template is generated if missing.
## Development
### Setup Development Environment
```bash
# Install UV (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone and setup
git clone https://github.com/karlorz/adobe-helper.git
cd adobe-helper
uv sync --all-extras --dev
```
### Run Tests
```bash
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=adobe --cov-report=html
# Run specific test file
uv run pytest tests/test_models.py -v
```
### Code Quality
```bash
# Format code
uv run black adobe/ tests/
# Lint code
uv run ruff check adobe/ tests/
# Type checking
uv run mypy adobe/
```
## Project Status
### ✅ Completed (Phases 1-10)
- [x] Project setup and architecture
- [x] Data models with Pydantic validation
- [x] Custom exception hierarchy
- [x] Session management and rotation
- [x] Cookie management
- [x] Rate limiting with adaptive backoff
- [x] Usage tracking
- [x] File upload handler
- [x] Conversion workflow manager
- [x] File download handler
- [x] Main client class
- [x] Example scripts with logging
- [x] Unit tests (30 tests, 100% pass rate)
- [x] Documentation
- [x] **Multi-tenant architecture with automatic discovery** ✨ NEW
- [x] **Dynamic endpoint switching per session** ✨ NEW
### 🔄 Remaining
- [ ] **API endpoint discovery** (critical - see `docs/discovery/API_DISCOVERY.md`)
- [ ] Integration tests with real API
- [ ] CLI tool (optional)
- [ ] Browser automation fallback (optional)
## Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Run code quality checks
6. Submit a pull request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Disclaimer
This library is for legitimate use only. Please respect Adobe's Terms of Service and rate limits. The library includes built-in rate limiting and quota tracking to prevent abuse.
## Acknowledgments
- Inspired by Adobe's online PDF conversion services
- Built with [httpx](https://www.python-httpx.org/), [pydantic](https://docs.pydantic.dev/), and modern Python async patterns
- Developed using [uv](https://github.com/astral-sh/uv) for fast dependency management
## Support
- 📫 Issues: [GitHub Issues](https://github.com/karlorz/adobe-helper/issues)
- 📖 Documentation: See `examples/` and `AGENTS.md`
- 💬 Discussions: [GitHub Discussions](https://github.com/karlorz/adobe-helper/discussions)
Raw data
{
"_id": null,
"home_page": null,
"name": "adobe-helper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "adobe, api, async, conversion, docx, httpx, pdf, word",
"author": null,
"author_email": "Adobe Helper Contributors <adobe-helper@example.com>",
"download_url": "https://files.pythonhosted.org/packages/52/bc/0092419279f089b35d7908238fcaf040ebaced14641c7dea3858ca584c51/adobe_helper-1.2.0.tar.gz",
"platform": null,
"description": "# Adobe Helper\n\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/psf/black)\n[](https://github.com/astral-sh/ruff)\n\n**Adobe Helper** is a Python library for converting PDF files to Word (DOCX) format using Adobe's online conversion services. It provides a clean, async API with automatic session management, rate limiting, and quota tracking.\n\n## \u26a0\ufe0f Current Status\n\n**This project is fully functional out-of-the-box!** The library includes working API endpoint patterns discovered from Adobe's online service. Simply install and start converting PDFs to Word documents.\n\n### Recent Updates (2025-10-21)\n\n\u2705 **Embedded API Endpoints** (NEW!)\n- Working endpoint patterns now embedded in the codebase\n- No manual endpoint discovery required for basic usage\n- Library works out-of-the-box after `pip install`\n- Automatic tenant ID substitution for each session\n\n\u2705 **Multi-Tenant Architecture**\n- Automatic tenant discovery during session initialization\n- Dynamic endpoint switching per session\n- Support for multiple regions and tenant IDs\n- Each session discovers its own numeric tenant ID from Adobe's servers\n\n\u2705 **Logging Enhancement**\n- Examples now include proper logging configuration\n- Real-time visibility into conversion progress\n- Better debugging and troubleshooting support\n\nAdvanced users can still manually discover and configure custom endpoints if needed. See [docs/discovery/API_DISCOVERY.md](docs/discovery/API_DISCOVERY.md) for details.\n\n## Features\n\n\u2728 **Easy to Use**\n- Simple async API with context manager support\n- Automatic session management and rotation\n- Built-in retry logic with exponential backoff\n- **Bypass local usage limits** (mimics clearing browser data)\n\n\ud83d\udcca **Smart Management**\n- Optional usage tracking with daily limits\n- Intelligent rate limiting with human-like delays\n- Automatic session rotation for unlimited conversions\n- Fresh session creation (like incognito mode)\n\n\ud83d\udd12 **Reliable**\n- Streaming upload/download for large files\n- File integrity verification\n- Comprehensive error handling\n- Progress tracking support\n\n\ud83d\ude80 **Fast**\n- Async/await throughout\n- HTTP/2 support via httpx\n- Concurrent batch processing\n\n## Installation\n\n### Using uv (Recommended)\n\n```bash\n# Clone the repository\ngit clone https://github.com/karlorz/adobe-helper.git\ncd adobe-helper\n\n# Install with uv\nuv sync --all-extras\n```\n\n### Using pip\n\n```bash\n# Clone the repository\ngit clone https://github.com/karlorz/adobe-helper.git\ncd adobe-helper\n\n# Install in development mode\npip install -e .\n```\n\n## Quick Start\n\n### Basic Usage\n\n```python\nimport asyncio\nimport logging\nfrom pathlib import Path\nfrom adobe import AdobePDFConverter\n\n# Configure logging to see conversion progress\nlogging.basicConfig(\n level=logging.INFO,\n format=\"%(asctime)s - %(name)s - %(levelname)s - %(message)s\",\n)\n\nasync def main():\n # Convert a PDF to Word (bypasses local limits by default)\n async with AdobePDFConverter(\n bypass_local_limits=True # Mimics clearing browser data\n ) as converter:\n output_file = await converter.convert_pdf_to_word(\n Path(\"document.pdf\")\n )\n print(f\"Converted: {output_file}\")\n\nasyncio.run(main())\n```\n\n### Batch Conversion\n\n```python\nfrom adobe import AdobePDFConverter\n\nasync def batch_convert():\n pdf_files = [\n Path(\"doc1.pdf\"),\n Path(\"doc2.pdf\"),\n Path(\"doc3.pdf\"),\n ]\n\n async with AdobePDFConverter() as converter:\n for pdf_file in pdf_files:\n try:\n output = await converter.convert_pdf_to_word(pdf_file)\n print(f\"\u2713 {pdf_file.name} -> {output.name}\")\n except Exception as e:\n print(f\"\u2717 {pdf_file.name}: {e}\")\n```\n\n### Advanced Configuration\n\n```python\nfrom adobe import AdobePDFConverter\nfrom pathlib import Path\n\nasync def advanced_convert():\n # Custom configuration\n converter = AdobePDFConverter(\n session_dir=Path(\".cache\"), # Custom cache directory\n use_session_rotation=True, # Enable session rotation\n track_usage=True, # Track daily quota\n enable_rate_limiting=True, # Rate limiting\n )\n\n try:\n await converter.initialize()\n\n # Convert with custom output path\n output = await converter.convert_pdf_to_word(\n Path(\"input.pdf\"),\n output_path=Path(\"output/converted.docx\"),\n )\n\n # Check usage stats\n usage = converter.get_usage_summary()\n print(f\"Daily usage: {usage['count']}/{usage['limit']}\")\n\n finally:\n await converter.close()\n```\n\n## Endpoint Discovery CLI\n\nUse the bundled helper to capture endpoints and keep discovery files synced:\n\n```bash\n# Show available commands\npython -m adobe.cli.api_discovery_helper --help\n\n# Create or refresh the project discovery template\npython -m adobe.cli.api_discovery_helper template\n\n# Validate captured URLs and sync project \u2194 user cache copies\npython -m adobe.cli.api_discovery_helper update\n\n# Installed entry point (after `pip install .`)\nadobe-api-discovery checklist\n```\n\nSee [docs/discovery/API_DISCOVERY.md](docs/discovery/API_DISCOVERY.md) for the full walkthrough.\n\nThe helper stores discovered endpoints in `~/.adobe-helper` by default, but will fall back to `./.adobe-helper` (or the system temp directory) automatically when the home directory is not writable\u2014useful for containerized or sandboxed environments.\n\n## Architecture\n\n### Core Components\n\n```\nadobe/\n\u251c\u2500\u2500 client.py # Main AdobePDFConverter class\n\u251c\u2500\u2500 auth.py # Session management\n\u251c\u2500\u2500 session_cycling.py # Anonymous session rotation\n\u251c\u2500\u2500 cookie_manager.py # Cookie persistence\n\u251c\u2500\u2500 upload.py # File upload handler\n\u251c\u2500\u2500 conversion.py # Conversion workflow manager\n\u251c\u2500\u2500 download.py # File download handler\n\u251c\u2500\u2500 rate_limiter.py # Rate limiting with backoff\n\u251c\u2500\u2500 usage_tracker.py # Free tier quota tracking\n\u251c\u2500\u2500 models.py # Pydantic data models\n\u251c\u2500\u2500 exceptions.py # Custom exceptions\n\u251c\u2500\u2500 constants.py # Configuration constants\n\u251c\u2500\u2500 urls.py # API endpoints\n\u2514\u2500\u2500 utils.py # Helper functions\n```\n\n### Data Flow\n\n```\nPDF File \u2192 Upload \u2192 Conversion Job \u2192 Poll Status \u2192 Download DOCX\n \u2193 \u2193 \u2193 \u2193\n Validate Create Job Wait/Poll Stream Download\n Retry Track Status Adaptive Verify\n Polling Integrity\n```\n\n## Examples\n\nSee the [`examples/adobe/`](examples/adobe/) directory for complete examples:\n\n- **basic_usage.py** - Simple conversion with bypass enabled\n- **batch_convert.py** - Sequential and concurrent batch processing\n- **advanced_usage.py** - Advanced configuration and error handling\n\nLegacy bypass/reset scripts now live under `archive/docs/` for reference.\n\n### Bypassing Usage Limits\n\nBy default, the library now bypasses local usage tracking and relies on Adobe's server-side limits with automatic session rotation:\n\n```python\n# Automatic session rotation (recommended for batch processing)\nasync with AdobePDFConverter(\n bypass_local_limits=True, # Default: True\n use_session_rotation=True, # Auto-rotate sessions\n) as converter:\n for pdf in pdf_files:\n await converter.convert_pdf_to_word(pdf)\n```\n\nFor more details, see [BYPASS_LIMITS.md](BYPASS_LIMITS.md).\n\n**Quick reset**: Call `AdobePDFConverter.reset_session_data()` (or use `AdobePDFConverter.create_with_fresh_session()`) to clear all local state; the legacy helper script now resides in `archive/docs/`.\n\n## API Discovery Required\n\n\u26a0\ufe0f **Important**: Before this library can perform actual conversions, you need to discover Adobe's API endpoints using Chrome DevTools.\n\nSee [docs/discovery/API_DISCOVERY.md](docs/discovery/API_DISCOVERY.md) for detailed instructions.\n\nDiscovered endpoint files are cached automatically: any `discovered_endpoints.json` found in `docs/discovery/` or `archive/discovery/` is copied into `~/.adobe-helper/` on first run, and a template is generated if missing.\n\n## Development\n\n### Setup Development Environment\n\n```bash\n# Install UV (if not already installed)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Clone and setup\ngit clone https://github.com/karlorz/adobe-helper.git\ncd adobe-helper\nuv sync --all-extras --dev\n```\n\n### Run Tests\n\n```bash\n# Run all tests\nuv run pytest\n\n# Run with coverage\nuv run pytest --cov=adobe --cov-report=html\n\n# Run specific test file\nuv run pytest tests/test_models.py -v\n```\n\n### Code Quality\n\n```bash\n# Format code\nuv run black adobe/ tests/\n\n# Lint code\nuv run ruff check adobe/ tests/\n\n# Type checking\nuv run mypy adobe/\n```\n\n## Project Status\n\n### \u2705 Completed (Phases 1-10)\n\n- [x] Project setup and architecture\n- [x] Data models with Pydantic validation\n- [x] Custom exception hierarchy\n- [x] Session management and rotation\n- [x] Cookie management\n- [x] Rate limiting with adaptive backoff\n- [x] Usage tracking\n- [x] File upload handler\n- [x] Conversion workflow manager\n- [x] File download handler\n- [x] Main client class\n- [x] Example scripts with logging\n- [x] Unit tests (30 tests, 100% pass rate)\n- [x] Documentation\n- [x] **Multi-tenant architecture with automatic discovery** \u2728 NEW\n- [x] **Dynamic endpoint switching per session** \u2728 NEW\n\n### \ud83d\udd04 Remaining\n\n- [ ] **API endpoint discovery** (critical - see `docs/discovery/API_DISCOVERY.md`)\n- [ ] Integration tests with real API\n- [ ] CLI tool (optional)\n- [ ] Browser automation fallback (optional)\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests\n5. Run code quality checks\n6. Submit a pull request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nThis library is for legitimate use only. Please respect Adobe's Terms of Service and rate limits. The library includes built-in rate limiting and quota tracking to prevent abuse.\n\n## Acknowledgments\n\n- Inspired by Adobe's online PDF conversion services\n- Built with [httpx](https://www.python-httpx.org/), [pydantic](https://docs.pydantic.dev/), and modern Python async patterns\n- Developed using [uv](https://github.com/astral-sh/uv) for fast dependency management\n\n## Support\n\n- \ud83d\udceb Issues: [GitHub Issues](https://github.com/karlorz/adobe-helper/issues)\n- \ud83d\udcd6 Documentation: See `examples/` and `AGENTS.md`\n- \ud83d\udcac Discussions: [GitHub Discussions](https://github.com/karlorz/adobe-helper/discussions)\n",
"bugtrack_url": null,
"license": "Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. \"License\" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. \"Licensor\" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. \"Legal Entity\" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, \"control\" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. \"You\" (or \"Your\") shall mean an individual or Legal Entity exercising permissions granted by this License. \"Source\" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. \"Object\" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. \"Work\" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). \"Derivative Works\" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. \"Contribution\" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, \"submitted\" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as \"Not a Contribution.\" \"Contributor\" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a \"NOTICE\" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets \"[]\" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same \"printed page\" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.",
"summary": "Python client for Adobe PDF to Word conversion using Adobe's online services",
"version": "1.2.0",
"project_urls": {
"Documentation": "https://github.com/karlorz/adobe-helper/blob/main/README.md",
"Homepage": "https://github.com/karlorz/adobe-helper",
"Issues": "https://github.com/karlorz/adobe-helper/issues",
"Repository": "https://github.com/karlorz/adobe-helper"
},
"split_keywords": [
"adobe",
" api",
" async",
" conversion",
" docx",
" httpx",
" pdf",
" word"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0e551e8e7bd1da62c78a811ca4761c6f7cc2c871990ed1eb4b3fdcebce4ffdf7",
"md5": "250524d53fb8c77f83f19568fc290141",
"sha256": "d25de8ac8458ba50a7855f3081df96815797a68d875cdbb341d2269ddf35bba0"
},
"downloads": -1,
"filename": "adobe_helper-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "250524d53fb8c77f83f19568fc290141",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 59355,
"upload_time": "2025-10-22T01:53:52",
"upload_time_iso_8601": "2025-10-22T01:53:52.601971Z",
"url": "https://files.pythonhosted.org/packages/0e/55/1e8e7bd1da62c78a811ca4761c6f7cc2c871990ed1eb4b3fdcebce4ffdf7/adobe_helper-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "52bc0092419279f089b35d7908238fcaf040ebaced14641c7dea3858ca584c51",
"md5": "8fb96420279109e0250889915397d6ad",
"sha256": "202af77d2c6a25b81c47a53c22ffbacc85cf0d46c63adc8a28e53d65fb86851b"
},
"downloads": -1,
"filename": "adobe_helper-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "8fb96420279109e0250889915397d6ad",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 182313,
"upload_time": "2025-10-22T01:53:53",
"upload_time_iso_8601": "2025-10-22T01:53:53.953305Z",
"url": "https://files.pythonhosted.org/packages/52/bc/0092419279f089b35d7908238fcaf040ebaced14641c7dea3858ca584c51/adobe_helper-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 01:53:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "karlorz",
"github_project": "adobe-helper",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "httpx",
"specs": [
[
">=",
"0.27.0"
]
]
}
],
"lcname": "adobe-helper"
}
