PyMuPDF 1.22.3__tar.gz → 1.23.0rc1__tar.gz

{PyMuPDF-1.22.3 → PyMuPDF-1.23.0rc1}/PKG-INFO

@@ -1,15 +1,11 @@
 Metadata-Version: 2.1
 Name: PyMuPDF
-Version: 1.22.3
-Summary: Python bindings for the PDF toolkit and renderer MuPDF
-Home-page: https://github.com/pymupdf/PyMuPDF
+Version: 1.23.0rc1
+Summary: Rebased Python bindings for the PDF toolkit and renderer MuPDF
+Description-Content-Type: text/markdown
 Author: Artifex
 Author-email: support@artifex.com
 License: GNU AFFERO GPL 3.0
-Project-URL: Documentation, https://pymupdf.readthedocs.io/
-Project-URL: Source, https://github.com/pymupdf/pymupdf
-Project-URL: Tracker, https://github.com/pymupdf/PyMuPDF/issues
-Project-URL: Changelog, https://pymupdf.readthedocs.io/en/latest/changes.html
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
@@ -17,21 +13,25 @@ Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: C
+Classifier: Programming Language :: C++
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Utilities
 Classifier: Topic :: Multimedia :: Graphics
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: COPYING
+Requires-Python: >=3.8
+Project-URL: Documentation, https://pymupdf.readthedocs.io/
+Project-URL: Source, https://github.com/pymupdf/pymupdf
+Project-URL: Tracker, https://github.com/pymupdf/PyMuPDF/issues
+Project-URL: Changelog, https://pymupdf.readthedocs.io/en/latest/changes.html
 
-# PyMuPDF 1.22.3
+# PyMuPDF 1.23.0rc1
 
 ![logo](https://artifex.com/images/logos/py-mupdf-github-icon.png)
 
 
-Release date: May 10, 2023
+Release date: August 10, 2023
+
 
 On **[PyPI](https://pypi.org/project/PyMuPDF)** since August 2016: [![Downloads](https://static.pepy.tech/personalized-badge/pymupdf?period=total&units=international_system&left_color=black&right_color=orange&left_text=Downloads)](https://pepy.tech/project/pymupdf)
 
@@ -42,9 +42,9 @@ On **[PyPI](https://pypi.org/project/PyMuPDF)** since August 2016: [![Downloads]
 
 PyMuPDF adds Python bindings and abstractions to [MuPDF](https://mupdf.com/), a lightweight PDF, XPS, and eBook viewer, renderer, and toolkit. Both PyMuPDF and MuPDF are maintained and developed by Artifex Software, Inc.
 
-MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB and FB2 (eBooks) formats, and it is known for its top performance and exceptional rendering quality.
+MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB, MOBI and FB2 (eBooks) formats, and it is known for its top performance and exceptional rendering quality.
 
-With PyMuPDF you can access files with extensions like `.pdf`, `.xps`, `.oxps`, `.cbz`, `.fb2` or `.epub`. In addition, about 10 popular image formats can also be handled like documents: `.png`, `.jpg`, `.bmp`, `.tiff`, etc.
+With PyMuPDF you can access files with extensions like `.pdf`, `.xps`, `.oxps`, `.cbz`, `.fb2`, `.mobi` or `.epub`. In addition, about 10 popular image formats can also be handled like documents: `.png`, `.jpg`, `.bmp`, `.tiff`, `.svg` etc.
 
 # Usage
 For all supported document types (i.e. **_including images_**) you can
@@ -94,9 +94,9 @@ The latest changelog can be viewed [here](https://pymupdf.readthedocs.io/en/late
 
 # Installation
 
-PyMuPDF **requires Python 3.7 or later**.
+PyMuPDF **requires Python 3.8 or later**.
 
-For versions 3.7 and up, Python wheels exist for **Windows** (32bit and 64bit), **Linux** (64bit, Intel and ARM) and **Mac OSX** (64bit, Intel only), so it can be installed from [PyPI](https://pypi.org/search/?q=pymupdf) in the usual way. To ensure pip support for the latest wheel platform tags, we strongly recommend to always upgrade pip first.
+For versions 3.8 and up, Python wheels exist for **Windows** (32bit and 64bit), **Linux** (64bit, Intel and ARM) and **Mac OSX** (64bit, Intel only), so it can be installed from [PyPI](https://pypi.org/search/?q=pymupdf) in the usual way. To ensure pip support for the latest wheel platform tags, we strongly recommend to always upgrade pip first.
 
     python -m pip install --upgrade pip
     python -m pip install --upgrade pymupdf
@@ -113,11 +113,61 @@ Older wheels - also with support for older Python versions - can be found [here]
 
 > **Note:** If `pip` cannot find a wheel that is compatible with your platform, it will automatically build and install from source using the PyMuPDF sdist; this requires only that SWIG is installed on your system.
 
+
+# Alternative 'rebased' implementation.
+
+A new implementation of PyMuPDF is available as module `fitz_new`.
+
+*
+  Uses the [MuPDF C++ and Python
+  APIs](https://mupdf.readthedocs.io/en/latest/language-bindings.html)
+  instead of the MuPDF C API.
+
+* Use as a drop-in replace with: `import fitz_new as fitz`
+
+## Benefits
+
+* Access to the underlying MuPDF Python API.
+
+  The MuPDF Python API is available as `fitz_new.mupdf` - this is not possible
+  with native PyMuPDF, and can give useful flexibility to the user.
+
+* Simplified implementation.
+
+  The underlying MuPDF C++/Python APIs' automated reference counting, automatic
+  contexts, and native C++ and Python exceptions, make the implementation
+  simpler than classic PyMuPDF.
+
+  This also simplifies development of new PyMuPDF functionality.
+
+* Optional tracing of MuPDF C function calls using environment variables.
+
+  This is a feature of the MuPDF C++ and Python APIs, which can be
+  very useful during development and when reporting bugs. See:
+  <https://mupdf.readthedocs.io/en/latest/language-bindings.html#environmental-variables>
+
+* Possible future support for multithreaded use.
+
+  Classic PyMuPDF is explicitly single-threaded, but the MuPDF C++/Python APIs
+  have automated per-thread contexts.
+
+
+## Known issues
+
+*
+  `import fitz_new` is known to fail with a SEGV on Windows with Python-3.10.
+
+# Secondary wheel `PyMuPDFb`
+
+Installation of PyMuPDF with pip will automatically install a second
+wheel called `PyMuPDFb` containing Python-independent libraries.
+
+
 # License and Copyright
 
 PyMuPDF and MuPDF are available under both, open-source AGPL and commercial license agreements.
 
-Please read the full text of the [AGPL license agreement](https://www.gnu.org/licenses/agpl-3.0.html) (which is also included here in file COPYING) to ensure that your use case complies with the guidelines of this license. If you determine you cannot meet the requirements of the AGPL, please contact [Artifex](https://artifex.com/contact/) for more information regarding a commercial license.
+Please read the full text of the [AGPL license agreement](https://www.gnu.org/licenses/agpl-3.0.html) (which is also included here in file COPYING) to ensure that your use case complies with the guidelines of this license. If you determine you cannot meet the requirements of the AGPL, please contact [Artifex](https://artifex.com/contact/pymupdf-inquiry.php) for more information regarding a commercial license.
 
 Artifex is the exclusive commercial licensing agent for MuPDF.
 

PyMuPDF-1.22.3/PyMuPDF.egg-info/PKG-INFO → PyMuPDF-1.23.0rc1/README.md

@@ -1,37 +1,10 @@
-Metadata-Version: 2.1
-Name: PyMuPDF
-Version: 1.22.3
-Summary: Python bindings for the PDF toolkit and renderer MuPDF
-Home-page: https://github.com/pymupdf/PyMuPDF
-Author: Artifex
-Author-email: support@artifex.com
-License: GNU AFFERO GPL 3.0
-Project-URL: Documentation, https://pymupdf.readthedocs.io/
-Project-URL: Source, https://github.com/pymupdf/pymupdf
-Project-URL: Tracker, https://github.com/pymupdf/PyMuPDF/issues
-Project-URL: Changelog, https://pymupdf.readthedocs.io/en/latest/changes.html
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: C
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Utilities
-Classifier: Topic :: Multimedia :: Graphics
-Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: COPYING
-
-# PyMuPDF 1.22.3
+# PyMuPDF 1.23.0rc1
 
 ![logo](https://artifex.com/images/logos/py-mupdf-github-icon.png)
 
 
-Release date: May 10, 2023
+Release date: August 10, 2023
+
 
 On **[PyPI](https://pypi.org/project/PyMuPDF)** since August 2016: [![Downloads](https://static.pepy.tech/personalized-badge/pymupdf?period=total&units=international_system&left_color=black&right_color=orange&left_text=Downloads)](https://pepy.tech/project/pymupdf)
 
@@ -42,9 +15,9 @@ On **[PyPI](https://pypi.org/project/PyMuPDF)** since August 2016: [![Downloads]
 
 PyMuPDF adds Python bindings and abstractions to [MuPDF](https://mupdf.com/), a lightweight PDF, XPS, and eBook viewer, renderer, and toolkit. Both PyMuPDF and MuPDF are maintained and developed by Artifex Software, Inc.
 
-MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB and FB2 (eBooks) formats, and it is known for its top performance and exceptional rendering quality.
+MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB, MOBI and FB2 (eBooks) formats, and it is known for its top performance and exceptional rendering quality.
 
-With PyMuPDF you can access files with extensions like `.pdf`, `.xps`, `.oxps`, `.cbz`, `.fb2` or `.epub`. In addition, about 10 popular image formats can also be handled like documents: `.png`, `.jpg`, `.bmp`, `.tiff`, etc.
+With PyMuPDF you can access files with extensions like `.pdf`, `.xps`, `.oxps`, `.cbz`, `.fb2`, `.mobi` or `.epub`. In addition, about 10 popular image formats can also be handled like documents: `.png`, `.jpg`, `.bmp`, `.tiff`, `.svg` etc.
 
 # Usage
 For all supported document types (i.e. **_including images_**) you can
@@ -94,9 +67,9 @@ The latest changelog can be viewed [here](https://pymupdf.readthedocs.io/en/late
 
 # Installation
 
-PyMuPDF **requires Python 3.7 or later**.
+PyMuPDF **requires Python 3.8 or later**.
 
-For versions 3.7 and up, Python wheels exist for **Windows** (32bit and 64bit), **Linux** (64bit, Intel and ARM) and **Mac OSX** (64bit, Intel only), so it can be installed from [PyPI](https://pypi.org/search/?q=pymupdf) in the usual way. To ensure pip support for the latest wheel platform tags, we strongly recommend to always upgrade pip first.
+For versions 3.8 and up, Python wheels exist for **Windows** (32bit and 64bit), **Linux** (64bit, Intel and ARM) and **Mac OSX** (64bit, Intel only), so it can be installed from [PyPI](https://pypi.org/search/?q=pymupdf) in the usual way. To ensure pip support for the latest wheel platform tags, we strongly recommend to always upgrade pip first.
 
     python -m pip install --upgrade pip
     python -m pip install --upgrade pymupdf
@@ -113,11 +86,61 @@ Older wheels - also with support for older Python versions - can be found [here]
 
 > **Note:** If `pip` cannot find a wheel that is compatible with your platform, it will automatically build and install from source using the PyMuPDF sdist; this requires only that SWIG is installed on your system.
 
+
+# Alternative 'rebased' implementation.
+
+A new implementation of PyMuPDF is available as module `fitz_new`.
+
+*
+  Uses the [MuPDF C++ and Python
+  APIs](https://mupdf.readthedocs.io/en/latest/language-bindings.html)
+  instead of the MuPDF C API.
+
+* Use as a drop-in replace with: `import fitz_new as fitz`
+
+## Benefits
+
+* Access to the underlying MuPDF Python API.
+
+  The MuPDF Python API is available as `fitz_new.mupdf` - this is not possible
+  with native PyMuPDF, and can give useful flexibility to the user.
+
+* Simplified implementation.
+
+  The underlying MuPDF C++/Python APIs' automated reference counting, automatic
+  contexts, and native C++ and Python exceptions, make the implementation
+  simpler than classic PyMuPDF.
+
+  This also simplifies development of new PyMuPDF functionality.
+
+* Optional tracing of MuPDF C function calls using environment variables.
+
+  This is a feature of the MuPDF C++ and Python APIs, which can be
+  very useful during development and when reporting bugs. See:
+  <https://mupdf.readthedocs.io/en/latest/language-bindings.html#environmental-variables>
+
+* Possible future support for multithreaded use.
+
+  Classic PyMuPDF is explicitly single-threaded, but the MuPDF C++/Python APIs
+  have automated per-thread contexts.
+
+
+## Known issues
+
+*
+  `import fitz_new` is known to fail with a SEGV on Windows with Python-3.10.
+
+# Secondary wheel `PyMuPDFb`
+
+Installation of PyMuPDF with pip will automatically install a second
+wheel called `PyMuPDFb` containing Python-independent libraries.
+
+
 # License and Copyright
 
 PyMuPDF and MuPDF are available under both, open-source AGPL and commercial license agreements.
 
-Please read the full text of the [AGPL license agreement](https://www.gnu.org/licenses/agpl-3.0.html) (which is also included here in file COPYING) to ensure that your use case complies with the guidelines of this license. If you determine you cannot meet the requirements of the AGPL, please contact [Artifex](https://artifex.com/contact/) for more information regarding a commercial license.
+Please read the full text of the [AGPL license agreement](https://www.gnu.org/licenses/agpl-3.0.html) (which is also included here in file COPYING) to ensure that your use case complies with the guidelines of this license. If you determine you cannot meet the requirements of the AGPL, please contact [Artifex](https://artifex.com/contact/pymupdf-inquiry.php) for more information regarding a commercial license.
 
 Artifex is the exclusive commercial licensing agent for MuPDF.
 

PyMuPDF-1.23.0rc1/READMErb.md

@@ -0,0 +1,6 @@
+# PyMuPDF 1.23.0rc1
+
+This wheel contains MuPDF shared libraries for use by PyMuPDF.
+
+This wheel is shared by PyMuPDF wheels that are spcific to different Python
+versions, significantly reducing the total size of a release.