edocapi 0.0.2__py3-none-any.whl

edocapi-0.0.2.dist-info/METADATA

@@ -0,0 +1,335 @@
+Metadata-Version: 2.4
+Name: edocapi
+Version: 0.0.2
+Summary: A lightweight Python framework for building document-processing and document-automation APIs.
+Author-email: EMMANUEL EMMANUEL ETIM <emmanuel224etim089@gmail.com>
+Maintainer-email: EMMANUEL EMMANUEL ETIM <emmanuel224etim089@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/emmanuelemmanueletim/edocApi
+Project-URL: Documentation, https://github.com/emmanuelemmanueletim/edocApi#readme
+Project-URL: Repository, https://github.com/emmanuelemmanueletim/edocApi.git
+Project-URL: Issues, https://github.com/emmanuelemmanueletim/edocApi/issues
+Keywords: document,api,pdf,docx,conversion,starlette,framework,document-processing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Framework :: AsyncIO
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: starlette>=0.37.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: uvicorn[standard]>=0.27.0
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: python-docx>=1.1.0
+Requires-Dist: markdown>=3.5
+Requires-Dist: Pillow>=10.0.0
+Provides-Extra: html
+Requires-Dist: weasyprint>=61.0; extra == "html"
+Provides-Extra: pdf-images
+Requires-Dist: pdf2image>=1.17.0; extra == "pdf-images"
+Provides-Extra: all
+Requires-Dist: weasyprint>=61.0; extra == "all"
+Requires-Dist: pdf2image>=1.17.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: httpx>=0.26.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# eDocAPI
+
+**A lightweight Python framework for building document-processing and document-automation APIs.**
+
+> Simple API for the developer. Powerful document processing underneath.
+
+Built on [Starlette](https://www.starlette.io/). Version **0.0.2**.
+
+---
+
+## Installation
+
+**Core** (PDF, DOCX text/HTML, images, Markdown text/HTML, uploads, CLI):
+
+```bash
+pip install edocapi
+```
+
+**With HTML/Markdown/DOCX → PDF** (pulls in WeasyPrint):
+
+```bash
+pip install edocapi[html]
+```
+
+WeasyPrint needs system libraries. On Debian/Ubuntu:
+
+```bash
+sudo apt-get install -y libcairo2 libpango-1.0-0 libpangocairo-1.0-0 \
+  libgdk-pixbuf-2.0-0 libffi-dev shared-mime-info
+```
+
+**With PDF → images** (requires poppler):
+
+```bash
+pip install edocapi[pdf-images]
+# system: sudo apt-get install -y poppler-utils
+```
+
+**Everything:**
+
+```bash
+pip install edocapi[all]
+```
+
+**Development (from source):**
+
+```bash
+pip install -e ".[dev,html]"
+```
+
+## Build and publish
+
+From the repository root, build and check the package before uploading:
+
+```powershell
+py -m pip install --upgrade build twine
+py -m build
+py -m twine check dist/*
+py -m twine upload dist/*
+```
+
+Use `__token__` as the Twine username and your PyPI API token as the password
+when prompted. Do not commit the token. See [PUBLISH.md](PUBLISH.md) for the
+full checklist.
+
+---
+
+## Quick Start
+
+Create `main.py`:
+
+```python
+from edocapi import App, Document
+
+app = App()
+
+@app.post("/convert")
+def convert(file):
+    return Document(file).to_pdf()
+
+@app.post("/compress")
+def compress(file):
+    return Document(file).compress()
+
+@app.post("/extract")
+def extract(file):
+    return {"text": Document(file).extract_text()}
+
+@app.post("/merge")
+def merge(files):
+    return Document.merge(files)
+
+@app.get("/")
+def home():
+    return {"message": "eDocAPI v0.0.2", "supported": Document.supported_types()}
+```
+
+Run the development server:
+
+```bash
+edocapi run
+# or with auto-reload:
+edocapi run --reload
+```
+
+Upload a document to `POST /convert` and receive a PDF.
+
+---
+
+## Core Concepts
+
+### Application
+
+```python
+from edocapi import App
+
+app = App(
+    debug=True,
+    max_file_size="25MB",
+)
+```
+
+### Document
+
+```python
+from edocapi import Document
+
+# From uploaded file (Path)
+doc = Document(file)
+
+# From HTML string
+doc = Document.html("<h1>Invoice</h1><p>Total: ₦50,000</p>")
+
+# From Markdown
+doc = Document.markdown("# Hello World")
+```
+
+### Conversions
+
+```python
+Document(file).to_pdf()          # → Document (PDF)
+Document(file).to_text()         # → str
+Document(file).extract_text()    # → str
+Document(file).to_html()         # → str
+Document(file).to_images()       # → list[Document]
+```
+
+### PDF Operations
+
+```python
+Document(file).compress(level="medium")
+Document(file).split()                    # list of single-page Documents
+Document(file).extract_pages(1, 5)        # 1-based inclusive
+Document(file).rotate(90, pages=[1, 2])
+Document.merge([file1, file2])
+Document(file).info()                     # dict of metadata
+```
+
+---
+
+## Supported Formats (v0.0.2)
+
+| Input     | to_pdf | to_text | to_html | to_images | Notes                  |
+|-----------|--------|---------|---------|-----------|------------------------|
+| PDF       | ✓      | ✓       | ✓*      | ✓**       | *text-based HTML       |
+| DOCX      | ✓      | ✓       | ✓       | –         |                        |
+| HTML      | ✓      | ✓       | ✓       | –         |                        |
+| Markdown  | ✓      | ✓       | ✓       | –         |                        |
+| JPG/PNG/WEBP | ✓   | –       | –       | ✓         |                        |
+| TXT       | –      | ✓       | –       | –         | via Document constructor |
+
+\* PDF→HTML is a simple text extraction wrapper, not a visual rendering.  
+\*\* PDF→Images requires optional `pdf2image` + system poppler.
+
+---
+
+
+## Deploying
+
+The package exposes an ASGI application. In your application's `main.py`, create
+`app = App()` and start it with an ASGI server. For example:
+
+```bash
+uvicorn main:app.asgi --host 0.0.0.0 --port ${PORT:-8000} --workers 2
+```
+
+Keep `debug=False` in hosted environments. If you enable HTML-to-PDF conversion,
+install WeasyPrint's operating-system libraries in the image or host as well as
+the `html` extra. Set the reverse proxy's request-body limit to match
+`max_file_size`; for larger workloads, use a worker queue and monitor temporary
+disk usage.
+
+## Configuration
+
+```python
+app = App(
+    debug=False,           # more detailed errors when True
+    max_file_size="10MB",  # "10MB", "25MB", 10485760, etc.
+    temp_dir=None,         # custom temp directory (optional)
+)
+```
+
+---
+
+## Error Handling
+
+eDocAPI raises specific exceptions that become consistent JSON responses:
+
+```json
+{
+  "error": "UnsupportedFileType",
+  "message": "The uploaded file type is not supported. (extension: .xlsx)"
+}
+```
+
+Available exceptions: `EdocAPIError`, `UnsupportedFileType`, `InvalidDocument`, `FileTooLarge`, `FileNotFound`, `ConversionError`, `ProcessingError`, `ValidationError`.
+
+---
+
+## CLI
+
+```bash
+edocapi --version
+edocapi run                  # main:app on http://0.0.0.0:8000
+edocapi run --reload
+edocapi run myapp:app --port 8080
+```
+
+---
+
+## Architecture
+
+```
+eDocAPI
+   │
+   Document abstraction
+   │
+   +───────────+───────────+
+   │           │           │
+  PDF        DOCX        Images …
+   │           │           │
+ pypdf    python-docx   Pillow
+              │
+         weasyprint (HTML/PDF)
+```
+
+Processors are registered internally and can be extended in future versions.
+
+---
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+---
+
+
+## Release status
+
+eDocAPI is alpha software. Review conversion behavior, optional system
+dependencies, and workload limits before exposing it to untrusted public
+traffic. See [PUBLISH.md](PUBLISH.md) for the release checklist.
+
+## Roadmap
+
+- **v0.1** – OpenAPI generation, more formats, plugin system  
+- **v0.2** – OCR, background jobs, cloud storage adapters  
+- **v0.3+** – Document signing, AI integrations, advanced workflows  
+
+---
+
+## Author
+
+**EMMANUEL EMMANUEL ETIM**  
+Email: [emmanuel224etim089@gmail.com](mailto:emmanuel224etim089@gmail.com)  
+GitHub: [https://github.com/emmanuelemmanueletim/edocApi](https://github.com/emmanuelemmanueletim/edocApi)
+
+---
+
+## License
+
+MIT — Copyright (c) 2026 EMMANUEL EMMANUEL ETIM

edocapi-0.0.2.dist-info/RECORD

@@ -0,0 +1,27 @@
+edocapi/__init__.py,sha256=76j1nU8qXPfe0umcte9d_-W4ZvSIn4ScdlOJgIjVktk,1246
+edocapi/app.py,sha256=dIBZkwXBDUZEgI0MzLNy3Rs_Yerdx2OzsMHXzn1rEo8,8722
+edocapi/config.py,sha256=Ex87_7yPffgtFYxV-9BBD2W2sjBcSLHzGCiqw-wNfhM,2196
+edocapi/document.py,sha256=TOXDGIjtsAJRhPfSktqpYm9VVp3xX-P9kw3Pu2jNNqY,10718
+edocapi/exceptions.py,sha256=8Zdov4QpWIMiSs7D7TLtK7Irb8y8Uv26qxuvLXKD6a8,3089
+edocapi/files.py,sha256=NBKksfDNFAJ6L2p5drJfTd_GjyeQHq96YOSsN5RK-ow,3386
+edocapi/responses.py,sha256=iQ09A5ZADPu80HAvpT7NofOvgF4MeBSSBYJLg9uayQo,2444
+edocapi/cli/__init__.py,sha256=eOJ6XuREuklX5qc3vvw2MOTXtUQdGGsRm9dDUyUQxA0,54
+edocapi/cli/main.py,sha256=giLHYQ1QdalMgN7XNg2dpzLUGlRjve8vn1C4FsvlnD4,2251
+edocapi/processors/__init__.py,sha256=9bIiez2jL8dIB8AKuTQuJyylTDUwGxdgQM7bzCnkwrc,408
+edocapi/processors/base.py,sha256=cDnOVdGc40vP_ISmMcRLI_469pghazhIanAkPwfX5hY,3224
+edocapi/processors/docx.py,sha256=H1jvy8qm9KFE1MDvGzUobxo3g29W-7hPULD3MpH9z9M,4021
+edocapi/processors/html.py,sha256=KTAyxtrFVml3P0LR-H2LiZ31wq9R47Z6gQlsk5b01AU,2278
+edocapi/processors/image.py,sha256=kg2Ydbrayf4-Pddp23oL1Ti1w3mlB7ZMPHgELIkubBo,3012
+edocapi/processors/markdown.py,sha256=z6fxEExYzglMmD3UsRu2DJMndm3nBJQJv_AC_hC91zs,2121
+edocapi/processors/pdf.py,sha256=qCcrtgsmOHXWJ1CXIjcHqWKjhnlX4zfmrZn93Ggf4xo,8836
+edocapi/processors/txt.py,sha256=LdhRxU7SxJPAy5Jxy5_L2hK0RCaWy5rNlK3UJEp6jls,1775
+edocapi/storage/__init__.py,sha256=G5NEUrYRmv2yat-MVMEBTvOOA5qMpiZjeJ5kYziO5g0,119
+edocapi/storage/temporary.py,sha256=ACljc_rZTAFxKD4kmx6tsjww-3Pwz7GvujRSSTkWt64,4160
+edocapi/validation/__init__.py,sha256=FVsXlu17O5LF4w13u19mLwdgGHjZsBEWwy5MBewpJWo,248
+edocapi/validation/files.py,sha256=dt8SZz_5PkbEEo573poSWg0YOmx3B4hHiohH6jUy3k8,5829
+edocapi-0.0.2.dist-info/licenses/LICENSE,sha256=WGyjSY_ziZJt4j230U49aIgCq3XUF-qzY6XNPGK9OXA,1079
+edocapi-0.0.2.dist-info/METADATA,sha256=qjemYu5__cgk81HqlFaFHEcwktizcnAlimAWpRMxDKY,9013
+edocapi-0.0.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+edocapi-0.0.2.dist-info/entry_points.txt,sha256=ow_kMFx2w8P-JN_1OlzAjKK5sqCBj5S3i6NXCDI97kU,50
+edocapi-0.0.2.dist-info/top_level.txt,sha256=WKc0psuAnp8XcMW1Ib6EfgNo6xa2k9mCbMQ0aH96ED4,8
+edocapi-0.0.2.dist-info/RECORD,,

edocapi-0.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

edocapi-0.0.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+edocapi = edocapi.cli.main:main

edocapi-0.0.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EMMANUEL EMMANUEL ETIM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

edocapi-0.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+edocapi