add python paper muncher package

Author: Flotchet

meta/bindings/python/.doctrees/environment.pickle

@@ -0,0 +1,15 @@
+extensions = [
+    "myst_parser",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+]
+extensions.append("sphinx_markdown_builder")
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+master_doc = 'readme'
+exclude_patterns = [
+    'examples.rst',
+    'framework_examples.rst'
+] 

meta/bindings/python/.doctrees/examples.doctree

@@ -0,0 +1,70 @@
+================
+Functional Usage
+================
+Paper Muncher includes both synchronous and asynchronous functional APIs.
+
+.. literalinclude:: ../examples/sync_example.py
+    :language: python
+    :linenos:
+    :lines: 1-13
+    :caption: Synchronous example
+    :name: sync_example
+
+**N.B.** The synchronous API is based on a per-OS integration for IO timeouts.
+
+#. For POSIX systems, it relies on `selectors`.
+#. For Windows with Python 3.12+, it puts the file in non-blocking mode.
+#. For Windows with Python < 3.12, it falls back to a potentially blocking read without timeout.
+
+.. literalinclude:: ../examples/async_example.py
+    :language: python
+    :linenos:
+    :lines: 1-13
+    :caption: Asynchronous example
+    :name: async_example
+
+In addition to that it also includes a context based approach to automatically
+handle synchronous and asynchronous code execution.
+
+.. literalinclude:: ../examples/auto_mode_example.py
+    :language: python
+    :linenos:
+    :lines:  1-22
+    :caption: Auto Switching example
+    :name: auto_example
+
+
+=====================
+Context Manager Usage
+=====================
+Paper Muncher includes both synchronous and asynchronous context manager APIs.
+
+.. literalinclude:: ../examples/sync_cm_example.py
+    :language: python
+    :linenos:
+    :lines: 1-14
+    :caption: Synchronous Context Manager example
+    :name: sync_cm_example
+
+**N.B.** The synchronous API is based on a per-OS integration for IO timeouts.
+
+#. For POSIX systems, it relies on `selectors`.
+#. For Windows with Python 3.12+, it puts the file in non-blocking mode.
+#. For Windows with Python < 3.12, it falls back to a potentially blocking read without timeout.
+
+.. literalinclude:: ../examples/async_cm_example.py
+    :language: python
+    :linenos:
+    :lines: 1-15
+    :caption: Asynchronous Context Manager example
+    :name: async_cm_example
+
+In addition to that it also includes a context based approach to automatically
+handle synchronous and asynchronous code execution.
+
+.. literalinclude:: ../examples/auto_mode_cm_example.py
+    :language: python
+    :linenos:
+    :lines: 1-26
+    :caption: Auto Switching example
+    :name: auto_cm_example

meta/bindings/python/.doctrees/framework_examples.doctree

@@ -0,0 +1,66 @@
+Paper Muncher comes with pre-made integration with some
+of the most popular frameworks as well!
+
+* Flask
+* Quart
+* Fast API
+* Django
+
+Your favorite framework is not in the list?
+No worries! Some general implementation are also
+present! 
+
+* agnostic WSGI integration
+* agnostic ASGI integration
+
+
+=====
+Flask
+=====
+.. literalinclude:: ../examples/flask_example.py
+    :language: python
+    :linenos:
+    :lines: 1-12
+    :caption: Flask example
+    :name: flask_example
+
+=====
+Quart
+=====
+.. literalinclude:: ../examples/quart_example.py
+    :language: python
+    :linenos:
+    :lines: 1-12
+    :caption: Quart example
+    :name: quart_example
+
+=======
+FastAPI
+=======
+.. literalinclude:: ../examples/fastapi_example.py
+    :language: python
+    :linenos:
+    :lines: 1-12
+    :caption: Fast API example
+    :name: fastapi_example
+
+======
+Django
+======
+WSGI.
+
+.. literalinclude:: ../examples/django_wsgi_example.py
+    :language: python
+    :linenos:
+    :lines: 1-36
+    :caption: Django (WSGI) example
+    :name: django_wsgi_example
+
+ASGI.
+
+.. literalinclude:: ../examples/django_asgi_example.py
+    :language: python
+    :linenos:
+    :lines: 1-39
+    :caption: Django (ASGI) example
+    :name: django_asgi_example

meta/bindings/python/.doctrees/index.doctree

@@ -0,0 +1,8 @@
+Paper Muncher Python Bindings
+=============================
+
+
+Usage examples
+--------------
+.. include:: examples.rst
+.. include:: framework_examples.rst

meta/bindings/python/.doctrees/readme.doctree

@@ -0,0 +1,20 @@
+from paper_muncher.asynchronous import rendered
+
+
+html = """
+<h1>Hello, Paper Muncher!</h1>
+<p>This is a simple example of using Paper Muncher in an asynchronous context.</p>
+"""
+
+
+async def main():
+    async with rendered(html, mode="print") as (pdf_stream_reader, std_err):
+        pdf = await pdf_stream_reader.read()
+
+    with open("output_async.pdf", "wb") as f:
+        f.write(pdf)
+
+
+if __name__ == "__main__":
+    import asyncio
+    asyncio.run(main())