astrapdf 0.1.0__py3-none-any.whl

astrapdf-0.1.0.dist-info/METADATA

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: astrapdf
+Version: 0.1.0
+Summary: A private, local-first PDF toolkit and browser studio
+Author: AstraPDF contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: local,merge,ocr,pdf,pdf-editor,private
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Multimedia :: Graphics :: Editors
+Requires-Python: >=3.10
+Requires-Dist: cryptography<47,>=43
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: pillow<13,>=10.0
+Requires-Dist: pypdf<7,>=5.0
+Requires-Dist: pypdfium2<6,>=4.30
+Requires-Dist: pytesseract<1,>=0.3.13
+Requires-Dist: python-multipart<1,>=0.0.12
+Requires-Dist: reportlab<5,>=4.2
+Requires-Dist: uvicorn[standard]<1,>=0.30
+Provides-Extra: dev
+Requires-Dist: build<2,>=1.2; extra == 'dev'
+Requires-Dist: twine<7,>=5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AstraPDF
+
+A local-first PDF toolkit with a Python API and browser-based desktop studio. PDF files remain on the machine running the library; the web UI binds to localhost by default.
+
+## Install and launch
+
+```bash
+python -m pip install astrapdf
+astrapdf
+```
+
+Open the local address printed by the command. AstraPDF asks the operating system for an available port by default, so it can run even when another app is using a common port. To choose a specific port: `astrapdf --port 9000`. Do not expose this development server directly to the internet. The default listener is loopback only.
+
+## Python API
+
+```python
+from pathlib import Path
+from pdfstudio import PDFStudio
+
+studio = PDFStudio()
+merged = studio.merge(["cover.pdf", "report.pdf", "photo.png"])
+Path("combined.pdf").write_bytes(merged)
+
+pages = studio.extract("combined.pdf", [0, 2, 3])
+Path("selection.pdf").write_bytes(pages)
+```
+
+Inputs can be paths, bytes, or binary file objects. Document methods return PDF bytes unless documented otherwise; all page indices in the library are zero-based.
+
+See the feature table below for implemented operations and boundaries. Redaction annotations and whiteout overlays are visual covers; they do not remove underlying PDF text. Permanent redaction is intentionally not offered.
+
+## License and PDF compatibility
+
+The Python package is MIT licensed. PDFium is distributed in the pypdfium2 wheels under its upstream BSD-style license; see the installed dependency's third-party notices. OCR also requires the Tesseract executable to be installed separately; `pip` installs AstraPDF's Python dependencies, but cannot install that operating-system program. Supported behavior follows the file format and versions of the bundled libraries. Digital signing, general damaged-PDF repair, XFA forms, and secure redaction are not included.

astrapdf-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+pdfstudio/__init__.py,sha256=W-KMl5mLZTRZmKnYCsAC0x7V8UtTqXUavWenLNiEWcc,158
+pdfstudio/cli.py,sha256=mnIaD8CzsAEdsD2MtQoH9tvWyPU9qso-t3Es7NUUhG8,1789
+pdfstudio/core.py,sha256=FwyHpxhN2g00tVGziGT2M_03IkgS55iZp-O3XmIT5kw,30164
+pdfstudio/webapp.py,sha256=_4lCB2wWVWs6MkgfV9oUvTFtv8wSeGF0qnSeLMx6qQA,19425
+pdfstudio/web/app.js,sha256=SgkcWIhzQNs1pTurvstjrP0UexpfHL9sj8iRSqOmKI0,33222
+pdfstudio/web/index.html,sha256=Ya73fo030L9OGVYF0ivju9VFFhTGFlj-Hasnd256uDg,7986
+pdfstudio/web/style.css,sha256=3SV6EKOJ-sQWZKdjAaz5OT95xLysLl9xwtNTtlBcQz0,9494
+pdfstudio/web/viewer-fixes.css,sha256=FGlFPwjN1UAhf0jQ3egHS7bvnUB2O3pnCp7LHYR2DTU,1418
+astrapdf-0.1.0.dist-info/METADATA,sha256=4z5LB8MjZLInPWb2AMFjlQJDwsPqLEoPtsrfy0cSWy4,3141
+astrapdf-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+astrapdf-0.1.0.dist-info/entry_points.txt,sha256=pR-tBLmX4BofQSGnHnJ5Tq2Uo7bTTW1oGcHqlYnYnJw,48
+astrapdf-0.1.0.dist-info/licenses/LICENSE,sha256=8WgnI7DORBqkX6BwuUO1vbVpHyVUXsyN3Ks0Vljo50o,1086
+astrapdf-0.1.0.dist-info/RECORD,,

astrapdf-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

astrapdf-0.1.0.dist-info/entry_points.txt

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

astrapdf-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PDF Studio Local contributors
+
+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.

pdfstudio/__init__.py

@@ -0,0 +1,6 @@
+"""Local-first PDF tools and browser studio."""
+
+from .core import PDFStudio, PDFStudioError
+
+__all__ = ["PDFStudio", "PDFStudioError"]
+__version__ = "0.1.0"

pdfstudio/cli.py

@@ -0,0 +1,48 @@
+"""Command line entry point for `astrapdf`."""
+
+from __future__ import annotations
+
+import argparse
+import socket
+import webbrowser
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="astrapdf", description="Run the private AstraPDF web app")
+    parser.add_argument("--host", default="127.0.0.1", help="Listen address (default: 127.0.0.1; avoid public interfaces)")
+    parser.add_argument("--port", type=int, default=0, help="Listen port (default: choose an available port)")
+    parser.add_argument("--no-browser", action="store_true", help="Print the address without opening a browser")
+    args = parser.parse_args()
+    if args.host not in {"127.0.0.1", "localhost", "::1"}:
+        parser.error("Only loopback addresses are supported; keep the local document server private.")
+    import uvicorn
+
+    family = socket.AF_INET6 if args.host == "::1" else socket.AF_INET
+    listener = socket.socket(family, socket.SOCK_STREAM)
+    try:
+        listener.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        listener.bind((args.host, args.port))
+        listener.listen(2048)
+        listener.setblocking(False)
+        port = listener.getsockname()[1]
+        display_host = f"[{args.host}]" if family == socket.AF_INET6 else args.host
+        url = f"http://{display_host}:{port}"
+
+        config = uvicorn.Config(
+            "pdfstudio.webapp:app",
+            host=args.host,
+            port=port,
+            log_level="warning",
+            access_log=False,
+        )
+        server = uvicorn.Server(config)
+        if not args.no_browser:
+            webbrowser.open(url)
+        print(f"AstraPDF is running at {url} (Ctrl-C to stop).")
+        server.run(sockets=[listener])
+    finally:
+        listener.close()
+
+
+if __name__ == "__main__":
+    main()