edocapi 0.0.2__tar.gz → 0.1.0__tar.gz

{edocapi-0.0.2 → edocapi-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edocapi
-Version: 0.0.2
+Version: 0.1.0
 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>
@@ -54,7 +54,7 @@ Dynamic: license-file
 
 > Simple API for the developer. Powerful document processing underneath.
 
-Built on [Starlette](https://www.starlette.io/). Version **0.0.2**.
+Built on [Starlette](https://www.starlette.io/). Version **0.1.0**.
 
 ---
 
@@ -66,13 +66,13 @@ Built on [Starlette](https://www.starlette.io/). Version **0.0.2**.
 pip install edocapi
 ```
 
-**With HTML/Markdown/DOCX → PDF** (pulls in WeasyPrint):
+**With enhanced HTML/Markdown/DOCX → PDF layout** (pulls in WeasyPrint):
 
 ```bash
 pip install edocapi[html]
 ```
 
-WeasyPrint needs system libraries. On Debian/Ubuntu:
+WeasyPrint may need system libraries for enhanced layout. On Debian/Ubuntu:
 
 ```bash
 sudo apt-get install -y libcairo2 libpango-1.0-0 libpangocairo-1.0-0 \
@@ -142,7 +142,7 @@ def merge(files):
 
 @app.get("/")
 def home():
-    return {"message": "eDocAPI v0.0.2", "supported": Document.supported_types()}
+    return {"message": f"eDocAPI v{__version__}", "supported": Document.supported_types()}
 ```
 
 Run the development server:
@@ -153,6 +153,8 @@ edocapi run
 edocapi run --reload
 ```
 
+Open **http://127.0.0.1:8000** in your browser to see the eDocAPI developer dashboard for your app. It shows your registered routes, supported document types, upload limit, and available `Document` operations, with a Try it explorer for testing endpoints. The dashboard is enabled by default when you have not registered your own `GET /` route. Set `App(dashboard=False)` to disable it. The separate eDocAPI company site lives in `webapp/`; see [webapp/README.md](webapp/README.md) to run it.
+
 Upload a document to `POST /convert` and receive a PDF.
 
 ---
@@ -206,9 +208,18 @@ Document.merge([file1, file2])
 Document(file).info()                     # dict of metadata
 ```
 
+`Document(file).compress(target_size=20 * 1024, level="medium")` optionally
+targets a maximum output size in bytes. PDFs are optimized and their output
+size is checked; text-based PDFs can be rebuilt with simplified layout and
+without original graphics if needed. Image files with JPG/JPEG, PNG, or WebP
+extensions are recompressed and retain their image format. Image compression
+can reduce color detail. Some target sizes cannot be reached. Without a
+target, the compressor returns the original if recompression would make it
+larger. Other document types are not accepted by `compress()`.
+
 ---
 
-## Supported Formats (v0.0.2)
+## Supported Formats
 
 | Input     | to_pdf | to_text | to_html | to_images | Notes                  |
 |-----------|--------|---------|---------|-----------|------------------------|
@@ -234,9 +245,9 @@ The package exposes an ASGI application. In your application's `main.py`, create
 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
+Keep `debug=False` in hosted environments. HTML, Markdown, TXT, and DOCX PDF
+conversion have a Pillow text-rendering fallback; install WeasyPrint's
+operating-system libraries for richer layout. 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.
 

edocapi-0.1.0/PUBLISH.md

@@ -0,0 +1,95 @@
+# Release checklist
+
+This document describes the release process. Publishing requires the maintainer's
+PyPI credentials and is a separate step from preparing the package.
+
+## Before release
+
+This change set intentionally keeps the package version at **0.1.0**. First
+check whether that version has already been published to PyPI and whether the
+GitHub tag `v0.1.0` already exists. PyPI versions cannot be overwritten. If
+either release already exists, do not reuse its version; prepare a new version
+before publishing.
+
+1. Review the pending changes and release notes.
+2. Run the project's checks on supported Python versions.
+3. Build and inspect both distributions:
+
+   ```bash
+   python -m pip install --upgrade build twine
+   python -m build
+   python -m twine check dist/*
+   ```
+
+4. Install the wheel in a clean environment and verify `import edocapi`, the
+   `edocapi --version` command, and the documented optional extras.
+5. Build and verify a candidate locally. Upload to TestPyPI only if you want a
+   separate pre-release check; it is not required for the production upload.
+
+## eDocAPI 0.1.0 release notes
+
+Use [RELEASE_NOTES_0.1.0.md](RELEASE_NOTES_0.1.0.md) as the detailed GitHub
+release description. This update includes the built-in developer dashboard,
+PDF and image compression, safer image type checking, document conversion
+fallbacks, and improvements to the separate example company web application.
+
+### GitHub release note
+
+Create a GitHub release for tag `v0.1.0` with title `eDocAPI 0.1.0` and use
+the contents of [RELEASE_NOTES_0.1.0.md](RELEASE_NOTES_0.1.0.md) as its body.
+
+### PyPI release note
+
+The source metadata remains at version 0.1.0. Confirm that this exact version
+is not already published before uploading. It includes the built-in developer
+dashboard and API explorer, target-size PDF compression, JPG/JPEG/PNG/WebP
+compression, conversion fallback support, and the standalone example company
+site under `webapp/`.
+
+### Build, check, and upload to PyPI
+
+Build from a clean distribution directory and check the files. Only upload if
+PyPI confirms `0.1.0` is still available:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+# Run only after confirming the version is not already published:
+python -m twine upload dist/*
+```
+
+Confirm the artifacts are `edocapi-0.1.0.tar.gz` and
+`edocapi-0.1.0-py3-none-any.whl`. Do not upload stale artifacts from older
+versions. If those filenames already exist on PyPI, stop and bump the package
+version for a follow-up release.
+
+## Publish
+
+Use a PyPI API token and Trusted Publishing where configured. Otherwise upload
+with Twine, entering `__token__` as the username and the token as the password:
+
+```bash
+python -m twine upload dist/*
+```
+
+Do not commit API tokens. A version already uploaded to PyPI cannot be replaced;
+increment the version for every follow-up release.
+
+For an upload, build with an empty `dist/` directory so the command cannot
+accidentally include stale artifacts from an earlier version. Verify the
+filenames match the intended release version before uploading.
+
+## Hosted deployment
+
+Create an application module exposing `app = App()` and run an ASGI server, for
+example:
+
+```bash
+uvicorn main:app.asgi --host 0.0.0.0 --port ${PORT:-8000} --workers 2
+```
+
+Use `debug=False`, configure the proxy body-size limit to match the app's upload
+limit, and install the required operating-system libraries for optional PDF
+conversions. Monitor temporary disk usage and use a queue for CPU-heavy or
+long-running document conversions.

{edocapi-0.0.2 → edocapi-0.1.0}/README.md

@@ -4,7 +4,7 @@
 
 > Simple API for the developer. Powerful document processing underneath.
 
-Built on [Starlette](https://www.starlette.io/). Version **0.0.2**.
+Built on [Starlette](https://www.starlette.io/). Version **0.1.0**.
 
 ---
 
@@ -16,13 +16,13 @@ Built on [Starlette](https://www.starlette.io/). Version **0.0.2**.
 pip install edocapi
 ```
 
-**With HTML/Markdown/DOCX → PDF** (pulls in WeasyPrint):
+**With enhanced HTML/Markdown/DOCX → PDF layout** (pulls in WeasyPrint):
 
 ```bash
 pip install edocapi[html]
 ```
 
-WeasyPrint needs system libraries. On Debian/Ubuntu:
+WeasyPrint may need system libraries for enhanced layout. On Debian/Ubuntu:
 
 ```bash
 sudo apt-get install -y libcairo2 libpango-1.0-0 libpangocairo-1.0-0 \
@@ -92,7 +92,7 @@ def merge(files):
 
 @app.get("/")
 def home():
-    return {"message": "eDocAPI v0.0.2", "supported": Document.supported_types()}
+    return {"message": f"eDocAPI v{__version__}", "supported": Document.supported_types()}
 ```
 
 Run the development server:
@@ -103,6 +103,8 @@ edocapi run
 edocapi run --reload
 ```
 
+Open **http://127.0.0.1:8000** in your browser to see the eDocAPI developer dashboard for your app. It shows your registered routes, supported document types, upload limit, and available `Document` operations, with a Try it explorer for testing endpoints. The dashboard is enabled by default when you have not registered your own `GET /` route. Set `App(dashboard=False)` to disable it. The separate eDocAPI company site lives in `webapp/`; see [webapp/README.md](webapp/README.md) to run it.
+
 Upload a document to `POST /convert` and receive a PDF.
 
 ---
@@ -156,9 +158,18 @@ Document.merge([file1, file2])
 Document(file).info()                     # dict of metadata
 ```
 
+`Document(file).compress(target_size=20 * 1024, level="medium")` optionally
+targets a maximum output size in bytes. PDFs are optimized and their output
+size is checked; text-based PDFs can be rebuilt with simplified layout and
+without original graphics if needed. Image files with JPG/JPEG, PNG, or WebP
+extensions are recompressed and retain their image format. Image compression
+can reduce color detail. Some target sizes cannot be reached. Without a
+target, the compressor returns the original if recompression would make it
+larger. Other document types are not accepted by `compress()`.
+
 ---
 
-## Supported Formats (v0.0.2)
+## Supported Formats
 
 | Input     | to_pdf | to_text | to_html | to_images | Notes                  |
 |-----------|--------|---------|---------|-----------|------------------------|
@@ -184,9 +195,9 @@ The package exposes an ASGI application. In your application's `main.py`, create
 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
+Keep `debug=False` in hosted environments. HTML, Markdown, TXT, and DOCX PDF
+conversion have a Pillow text-rendering fallback; install WeasyPrint's
+operating-system libraries for richer layout. 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.
 

{edocapi-0.0.2 → edocapi-0.1.0}/edocapi/__init__.py

@@ -8,7 +8,7 @@ Author: EMMANUEL EMMANUEL ETIM <emmanuel224etim089@gmail.com>
 Repository: https://github.com/emmanuelemmanueletim/edocApi
 """
 
-__version__ = "0.0.2"
+__version__ = "0.1.0"
 __author__ = "EMMANUEL EMMANUEL ETIM"
 __author_email__ = "emmanuel224etim089@gmail.com"
 __license__ = "MIT"

{edocapi-0.0.2 → edocapi-0.1.0}/edocapi/app.py

@@ -49,6 +49,8 @@ class App:
             **kwargs,
         )
         self._routes: list[Route] = []
+        self._dashboard_enabled = bool(kwargs.get("dashboard", True))
+        self._dashboard_endpoint: Callable | None = None
         self._temp_storage = TemporaryStorage(self.config.temp_dir)
         self._starlette: Starlette | None = None
 
@@ -74,7 +76,48 @@ class App:
         async def wrapper(request: Request) -> Response:
             return await self._dispatch(endpoint, request)
 
-        self._routes.append(Route(path, endpoint=wrapper, methods=list(methods)))
+        wrapper.__name__ = endpoint.__name__
+        wrapper.__doc__ = endpoint.__doc__
+        wrapper.__edocapi_endpoint__ = endpoint
+        self._routes.append(
+            Route(path, endpoint=wrapper, methods=list(methods), name=endpoint.__name__)
+        )
+
+    def _dashboard_response(self) -> Response:
+        """Build the interactive developer dashboard from this app's routes."""
+        from edocapi.document import Document
+        from edocapi.dashboard import render_dashboard
+
+        routes = [
+            {
+                "path": route.path,
+                "methods": sorted(route.methods or []),
+                "name": getattr(route.endpoint, "__name__", "endpoint"),
+                "description": inspect.getdoc(
+                    getattr(route.endpoint, "__edocapi_endpoint__", route.endpoint)
+                ) or "",
+                "parameters": [
+                    {
+                        "name": parameter.name,
+                        "required": parameter.default is inspect.Parameter.empty,
+                        "kind": "upload" if parameter.name in ("file", "files") else "parameter",
+                        "multiple": parameter.name == "files",
+                        "type": getattr(parameter.annotation, "__name__", "string")
+                        if parameter.annotation is not inspect.Parameter.empty
+                        else "string",
+                    }
+                    for parameter in inspect.signature(
+                        getattr(route.endpoint, "__edocapi_endpoint__", route.endpoint)
+                    ).parameters.values()
+                    if parameter.name != "request"
+                ],
+            }
+            for route in self._routes
+        ]
+        return Response(
+            render_dashboard(routes, Document.supported_types(), self.config.max_file_size),
+            media_type="text/html",
+        )
 
     def get(self, path: str) -> Callable:
         def decorator(func: Callable) -> Callable:
@@ -137,6 +180,12 @@ class App:
                     temp_storage=self._temp_storage,
                 )
 
+            form_data = None
+            if uploads and request.headers.get("content-type", "").startswith(
+                "multipart/form-data"
+            ):
+                form_data = await request.form()
+
             for name, param in sig.parameters.items():
                 if name == "request":
                     kwargs["request"] = request
@@ -150,12 +199,14 @@ class App:
                     kwargs["files"] = uploads
                 elif name in request.path_params:
                     kwargs[name] = request.path_params[name]
+                elif form_data is not None and name in form_data:
+                    kwargs[name] = form_data[name]
+                elif name in request.query_params:
+                    kwargs[name] = request.query_params[name]
                 elif param.default is not inspect.Parameter.empty:
                     continue
                 else:
-                    # Try query params as fallback
-                    if name in request.query_params:
-                        kwargs[name] = request.query_params[name]
+                    continue
 
             # Call the endpoint (sync or async)
             if inspect.iscoroutinefunction(endpoint):
@@ -192,9 +243,18 @@ class App:
         if isinstance(result, Document):
             # Document returned directly  treat as file response
             path = result.path
+            headers = {}
+            compression_mode = getattr(result, "_compression_mode", None)
+            if compression_mode:
+                headers["X-Edocapi-Compression-Mode"] = compression_mode
+            filename = path.name
+            if compression_mode == "image":
+                original_name = Path(getattr(result, "_original_name", path.name))
+                filename = f"compressed_{original_name.stem}{path.suffix.lower()}"
             return FileResponse(
                 path,
-                filename=path.name,
+                filename=filename,
+                headers=headers,
                 background=self._cleanup_callback(path, result._temp),
             )
 
@@ -232,9 +292,16 @@ class App:
     def asgi(self) -> Starlette:
         """Return the underlying Starlette ASGI application."""
         if self._starlette is None:
+            routes = list(self._routes)
+            if self._dashboard_enabled and not any(r.path == "/" and "GET" in (r.methods or []) for r in routes):
+                async def dashboard_endpoint(request: Request) -> Response:
+                    return self._dashboard_response()
+
+                self._dashboard_endpoint = dashboard_endpoint
+                routes.insert(0, Route("/", endpoint=dashboard_endpoint, methods=["GET"]))
             self._starlette = Starlette(
                 debug=self.config.debug,
-                routes=self._routes,
+                routes=routes,
                 exception_handlers={
                     Exception: self._global_exception_handler,
                 },

edocapi-0.1.0/edocapi/dashboard.py

@@ -0,0 +1,46 @@
+"""Interactive API explorer dashboard for eDocAPI applications."""
+
+from __future__ import annotations
+
+import html
+import json
+
+
+def render_dashboard(routes: list[dict], formats: list[str], max_file_size: int) -> str:
+    from edocapi import __version__
+
+    version = __version__
+    route_rows = "".join(
+        "<tr>"
+        f'<td><span class="method">{html.escape(", ".join(route["methods"]))}</span></td>'
+        f'<td><code>{html.escape(route["path"])}</code></td>'
+        f'<td>{html.escape(route["name"])}</td>'
+        f'<td><button class="try" data-route="{index}">Try it ↗</button></td></tr>'
+        for index, route in enumerate(routes)
+    ) or '<tr><td colspan="4" class="empty">No custom routes registered yet.</td></tr>'
+    formats_html = "".join(
+        f'<span class="format">{html.escape(kind.upper())}</span>' for kind in formats
+    )
+    size = f"{max_file_size / 1024 / 1024:g} MB"
+    route_json = json.dumps(routes).replace("<", "\\u003c").replace(">", "\\u003e").replace("&", "\\u0026")
+    return f'''<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="theme-color" content="#101411"><title>eDocAPI · API Explorer</title>
+<style>
+:root{{--bg:#101411;--panel:#171d19;--line:#29332d;--muted:#94a399;--text:#edf5ef;--green:#a8f078;--mint:#6ee7b7;--orange:#ffc078}}
+*{{box-sizing:border-box}}body{{margin:0;background:radial-gradient(ellipse at 82% 0%,#24392c 0,transparent 36%),var(--bg);color:var(--text);font:15px/1.5 Inter,ui-sans-serif,system-ui,-apple-system,"Segoe UI",sans-serif}}a{{color:var(--green);text-decoration:none}}.shell{{max-width:1180px;margin:auto;padding:28px 24px 60px}}header{{display:flex;align-items:center;justify-content:space-between;margin-bottom:58px}}.brand{{display:flex;gap:12px;align-items:center;font-weight:750;font-size:19px}}.mark{{width:38px;height:38px;border-radius:12px;background:linear-gradient(135deg,var(--green),var(--mint));color:#102016;display:grid;place-items:center;font-weight:900}}.badge,.format{{border:1px solid var(--line);border-radius:99px;padding:6px 12px;color:var(--muted);font-size:12px}}.hero{{max-width:760px;margin-bottom:34px}}.eyebrow{{color:var(--green);font-size:12px;text-transform:uppercase;font-weight:800;letter-spacing:.15em}}h1{{font-size:clamp(38px,6vw,66px);line-height:1.02;letter-spacing:-.065em;margin:13px 0 17px}}h1 span,.code{{color:var(--green)}}.lead{{color:#aab8ae;font-size:17px;max-width:630px}}.actions{{display:flex;gap:10px;margin-top:24px;flex-wrap:wrap}}.button,.try{{border:1px solid var(--line);border-radius:9px;padding:9px 13px;background:#1d2720;color:var(--text);font-weight:650;cursor:pointer}}.button.primary{{background:var(--green);color:#122014}}.stats{{display:grid;grid-template-columns:repeat(3,1fr);gap:14px;margin:32px 0}}.stat,.panel{{background:linear-gradient(145deg,#1a211c,#151a17);border:1px solid var(--line);border-radius:15px}}.stat{{padding:18px 20px}}.stat small,.muted{{color:var(--muted)}}.stat strong{{display:block;font-size:27px;margin-top:4px}}.grid{{display:grid;grid-template-columns:1.15fr .85fr;gap:16px}}.panel{{padding:22px}}.panel h2{{font-size:16px;margin:0 0 12px}}table{{width:100%;border-collapse:collapse;text-align:left}}th{{color:var(--muted);font-size:11px;text-transform:uppercase;letter-spacing:.1em}}td,th{{padding:12px 8px;border-bottom:1px solid var(--line)}}td{{font-size:13px}}td code,.code{{font-family:ui-monospace,Consolas,monospace}}.method{{font-size:10px;font-weight:800;color:var(--mint);background:#16352c;padding:4px 7px;border-radius:5px}}.try{{font-size:11px;color:var(--green);padding:6px 9px}}.empty{{color:var(--muted)}}.formats{{display:flex;gap:7px;flex-wrap:wrap;margin:15px 0 24px}}.format{{border-radius:7px;background:#202a23;color:#c4d7c8;padding:5px 9px;font-weight:750}}.codebox{{background:#0e120f;border:1px solid var(--line);border-radius:10px;padding:14px;margin-top:13px;overflow:auto;color:#c5d3c8;font:12px/1.8 ui-monospace,Consolas,monospace}}.span2{{grid-column:1/-1}}.footer{{color:#718078;font-size:12px;margin-top:26px;display:flex;justify-content:space-between;gap:12px}}.explorer{{display:none;position:fixed;inset:0;z-index:5;background:#000b;place-items:center;padding:20px}}.explorer.open{{display:grid}}.dialog{{width:min(760px,100%);max-height:90vh;overflow:auto;background:#171d19;border:1px solid #35433a;border-radius:16px;padding:24px;box-shadow:0 25px 100px #0009}}.dialog-head{{display:flex;justify-content:space-between;gap:16px}}.close{{background:none;border:0;color:var(--muted);font-size:24px;cursor:pointer}}.field{{display:grid;gap:6px;margin:14px 0;color:#b6c4ba;font-size:13px}}.field input{{width:100%;background:#0e120f;border:1px solid var(--line);padding:10px;border-radius:8px;color:var(--text)}}.requestline{{display:flex;gap:10px;align-items:center;margin:18px 0}}.result{{white-space:pre-wrap;word-break:break-word;max-height:300px;overflow:auto}}.send{{background:var(--green);border:0;border-radius:9px;color:#142014;padding:11px 18px;font-weight:800;cursor:pointer}}@media(max-width:760px){{header{{margin-bottom:38px}}.grid{{grid-template-columns:1fr}}.span2{{grid-column:auto}}.shell{{padding:20px 16px 40px}}.route-table{{overflow:auto}}}}
+</style></head><body><main class="shell">
+<header><div class="brand"><div class="mark">e</div><span>eDocAPI <span class="muted">/ explorer</span></span></div><div class="badge">DOCUMENT API FRAMEWORK · v{html.escape(version)}</div></header>
+<section class="hero"><div class="eyebrow">Your document workflow, at a glance</div><h1>Build APIs.<br><span>Move documents.</span></h1><p class="lead">Explore your endpoints, send live requests, and inspect responses from one developer console.</p><div class="actions"><a class="button primary" href="#routes">Explore endpoints ↓</a><a class="button" href="https://github.com/emmanuelemmanueletim/edocApi">Framework docs ↗</a></div></section>
+<section class="stats"><div class="stat"><small>Registered routes</small><strong>{len(routes):02d}</strong></div><div class="stat"><small>Supported formats</small><strong>{len(formats):02d}</strong></div><div class="stat"><small>Upload limit</small><strong>{html.escape(size)}</strong></div></section>
+<section class="grid"><div class="panel" id="routes"><h2>⌘ &nbsp;Your API routes</h2><p class="muted" style="font-size:13px">Choose an endpoint to try it and view its response.</p><div class="route-table"><table><thead><tr><th>Method</th><th>Path</th><th>Handler</th><th></th></tr></thead><tbody>{route_rows}</tbody></table></div></div>
+<div class="panel"><h2>▧ &nbsp;Supported formats</h2><div class="formats">{formats_html}</div><h2>✳ &nbsp;Document toolkit</h2><div class="codebox">to_pdf() · to_text() · to_html()<br>to_images() · extract_text() · info()<br><span style="color:var(--orange)">PDF:</span> compress() · split() · extract_pages()<br>rotate() · Document.merge(files)</div></div>
+<div class="panel span2"><h2>⚡ &nbsp;Quick start</h2><div class="codebox">from edocapi import App, Document<br><br>app = App()<br><br>@app.post("/convert")<br>def convert(file):<br>&nbsp;&nbsp;&nbsp;&nbsp;return Document(file).to_pdf()<br><br># Terminal: py -m edocapi.cli.main run --reload</div></div></section>
+<footer class="footer"><span>eDocAPI · Simple API for the developer. Powerful document processing underneath.</span><span>Auto-generated from your app configuration</span></footer></main>
+<div class="explorer" id="explorer" role="dialog" aria-modal="true" aria-labelledby="dialog-title"><div class="dialog"><div class="dialog-head"><div><div class="eyebrow">API explorer</div><h2 id="dialog-title" style="font-size:24px;margin:6px 0"></h2><p id="dialog-description" class="muted"></p></div><button class="close" id="close" aria-label="Close">×</button></div><div class="requestline"><span id="dialog-method" class="method"></span><code id="dialog-path" class="code"></code></div><form id="request-form"><div id="fields"></div><button class="send" type="submit">Send request</button></form><div id="response-wrap" hidden><h3>Result <span id="response-status" class="muted"></span></h3><details><summary>Show response details</summary><div class="codebox result" id="response-body"></div></details></div></div></div>
+<script type="application/json" id="edocapi-routes">{route_json}</script><script>
+const routes=JSON.parse(document.getElementById('edocapi-routes').textContent),modal=document.getElementById('explorer');let active=null;
+document.querySelectorAll('.try').forEach(button=>button.addEventListener('click',()=>openExplorer(routes[Number(button.dataset.route)])));
+function openExplorer(route){{active=route;document.getElementById('dialog-title').textContent=route.name;document.getElementById('dialog-description').textContent=route.description||'Send a request and inspect the endpoint response.';document.getElementById('dialog-method').textContent=route.methods.join(', ');document.getElementById('dialog-path').textContent=route.path;const fields=document.getElementById('fields');fields.replaceChildren();for(const p of route.parameters||[]){{const wrap=document.createElement('label');wrap.className='field';wrap.textContent=['target_size','target_size_value'].includes(p.name)?'Preferred maximum size (optional)':p.name+(p.required?' *':'');let input;if(p.name==='target_unit'){{input=document.createElement('select');for(const unit of ['KB','MB']){{const option=document.createElement('option');option.value=unit;option.textContent=unit;input.appendChild(option)}}input.value='MB'}}else{{input=document.createElement('input');if(p.kind==='upload'){{input.type='file';if(p.multiple)input.multiple=true}}else{{input.type='text';input.placeholder=p.required?'Required value':'Optional value';if(p.required)input.required=true;if(['target_size','target_size_value'].includes(p.name)){{input.type='number';input.min='1';input.placeholder='Enter target size'}}}}}}input.name=p.name;wrap.appendChild(input);fields.appendChild(wrap)}}document.getElementById('response-wrap').hidden=true;modal.classList.add('open')}}
+document.getElementById('close').onclick=()=>modal.classList.remove('open');modal.addEventListener('click',e=>{{if(e.target===modal)modal.classList.remove('open')}});document.addEventListener('keydown',e=>{{if(e.key==='Escape')modal.classList.remove('open')}});
+document.getElementById('request-form').addEventListener('submit',async e=>{{e.preventDefault();const values=new FormData(e.currentTarget),url=new URL(active.path,location.origin),pathParams=new Set((active.path.match(/{{[^}}]+}}/g)||[]).map(x=>x.slice(1,-1))),upload=[];for(const p of active.parameters||[]){{const v=values.getAll(p.name);if(p.kind==='upload'){{for(const f of v)if(f&&f.size)upload.push([p.name,f])}}else if(v[0]){{if(pathParams.has(p.name))url.pathname=url.pathname.replace('{{'+p.name+'}}',encodeURIComponent(v[0]));else url.searchParams.set(p.name,v[0])}}}}const method=active.methods.includes('GET')?'GET':active.methods.includes('POST')?'POST':active.methods[0],options={{method}};if(upload.length){{const body=new FormData();for(const [key,file]of upload)body.append(key,file,file.name);options.body=body}}document.getElementById('response-wrap').hidden=false;const status=document.getElementById('response-status'),output=document.getElementById('response-body');status.textContent='Sending…';output.textContent='';try{{const response=await fetch(url,options),type=response.headers.get('content-type')||'',body=type.includes('json')?JSON.stringify(await response.json(),null,2):await response.text();status.textContent=response.ok?response.status+' OK':'HTTP '+response.status+' '+response.statusText;output.textContent=body||'(empty response)'}}catch(error){{status.textContent='Request failed';output.textContent=String(error)}}}});
+</script></body></html>'''

{edocapi-0.0.2 → edocapi-0.1.0}/edocapi/document.py

@@ -146,8 +146,15 @@ class Document:
             out_path = self._processor().to_pdf()
             return Document(out_path, temp_storage=self._temp)
         except Exception as exc:
+            message = str(exc)
+            if "libgobject" in message.lower() or "cannot load library" in message.lower():
+                message = (
+                    "WeasyPrint's native GTK libraries are missing. On Windows, "
+                    "install the GTK3 runtime, add its bin directory to PATH, "
+                    "then restart the terminal and server."
+                )
             raise ConversionError(
-                str(exc), source=self.type, target="pdf"
+                message, source=self.type, target="pdf"
             ) from exc
 
     def to_text(self) -> str:
@@ -215,15 +222,28 @@ class Document:
                 "mime_type": self.mime_type,
             }
 
-    def compress(self, level: str = "medium") -> "Document":
-        """Compress a PDF. Returns a new Document."""
+    def compress(self, level: str = "medium", target_size: int | None = None) -> "Document":
+        """Compress a PDF or supported raster image; optionally set a byte target."""
+        if self.type in {"jpeg", "jpg", "png", "webp"}:
+            from edocapi.processors.image import ImageProcessor
+
+            proc = ImageProcessor(self.path, temp_storage=self._temp)
+            out = proc.compress(level=level, target_size=target_size)
+            result = Document(out, temp_storage=self._temp)
+            result._original_name = self.name
+            result._compression_mode = "image"
+            return result
         if self.type != "pdf":
-            raise ProcessingError("compress() is only available for PDF documents.")
+            raise ProcessingError(
+                "compress() supports PDF, JPG, JPEG, PNG, and WebP files only."
+            )
         from edocapi.processors.pdf import PDFProcessor
 
         proc = PDFProcessor(self.path, temp_storage=self._temp)
-        out = proc.compress(level=level)
-        return Document(out, temp_storage=self._temp)
+        out = proc.compress(level=level, target_size=target_size)
+        result = Document(out, temp_storage=self._temp)
+        result._compression_mode = getattr(proc, "_last_compression_mode", "optimized")
+        return result
 
     def split(self) -> list["Document"]:
         """Split a PDF into individual pages."""

{edocapi-0.0.2 → edocapi-0.1.0}/edocapi/processors/docx.py

@@ -82,18 +82,17 @@ class DOCXProcessor(BaseProcessor):
         html = self.to_html()
         try:
             from weasyprint import HTML
-        except ImportError as exc:
-            raise ConversionError(
-                "DOCX -> PDF requires weasyprint. "
-                "Install with: pip install edocapi[html]",
-                source="docx",
-                target="pdf",
-            ) from exc
+        except (ImportError, OSError):
+            HTML = None
 
         storage = self.temp_storage or TemporaryStorage()
         out = storage.create_file(suffix=".pdf", prefix="docx_")
-        HTML(string=html).write_pdf(str(out))
-        return out
+        from edocapi.processors.simple_pdf import html_to_text, render_html_pdf, render_text_pdf
+
+        fallback_text = self.to_text()
+        if HTML is None:
+            return render_text_pdf(fallback_text, out)
+        return render_html_pdf(html, out, fallback_text or html_to_text(html))
 
     def info(self) -> dict[str, Any]:
         core = self._doc.core_properties

{edocapi-0.0.2 → edocapi-0.1.0}/edocapi/processors/html.py

@@ -38,18 +38,18 @@ class HTMLProcessor(BaseProcessor):
         """Convert HTML to PDF using WeasyPrint."""
         try:
             from weasyprint import HTML
-        except ImportError as exc:
-            raise ConversionError(
-                "HTML -> PDF requires weasyprint. "
-                "Install with: pip install edocapi[html]",
-                source="html",
-                target="pdf",
-            ) from exc
+        except (ImportError, OSError):
+            HTML = None
 
         storage = self.temp_storage or TemporaryStorage()
         out = storage.create_file(suffix=".pdf", prefix="html_")
-        HTML(filename=str(self.path)).write_pdf(str(out))
-        return out
+        from edocapi.processors.simple_pdf import html_to_text, render_html_pdf, render_text_pdf
+
+        source = self.path.read_text(encoding="utf-8", errors="replace")
+        text = html_to_text(source)
+        if HTML is None:
+            return render_text_pdf(text, out)
+        return render_html_pdf(source, out, text)
 
     def info(self) -> dict[str, Any]:
         content = self.path.read_text(encoding="utf-8", errors="replace")