publish v1.14.20

Author: JorjMcKie

PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: PyMuPDF
-Version: 1.14.19
+Version: 1.14.20
 Author: Ruikai Liu
 Author-email: [email protected]
 Maintainer: Jorj X. McKie
@@ -9,7 +9,7 @@ Home-page: https://github.com/pymupdf/PyMuPDF
 Download-url: https://github.com/pymupdf/PyMuPDF
 Summary: PyMuPDF is a Python binding for the PDF rendering library MuPDF
 Description:
-        Release date: July 18, 2019
+        Release date: August 10, 2019
 
         Authors
         =======
@@ -20,7 +20,7 @@ Description:
         Introduction
         ============
 
-        This is **version 1.14.19 of PyMuPDF**, a Python binding for `MuPDF <http://mupdf.com/>`_ - "a lightweight PDF and XPS viewer".
+        This is **version 1.14.20 of PyMuPDF**, a Python binding for `MuPDF <http://mupdf.com/>`_ - "a lightweight PDF and XPS viewer".
 
         MuPDF can access files in PDF, XPS, OpenXPS, epub, comic and fiction book formats, and it is known for both, its top performance and high rendering quality.
 
@@ -57,7 +57,6 @@ Description:
         * `Windows CHM <https://github.com/JorjMcKie/PyMuPDF-optional-material/tree/master/doc/PyMuPDF.chm>`_
 
         * `PDF <https://github.com/pymupdf/PyMuPDF/tree/master/doc/pymupdf.pdf>`_
-        
 
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console

README.md

@@ -1,8 +1,8 @@
-# PyMuPDF 1.14.19
+# PyMuPDF 1.14.20
 
 ![logo](https://github.com/pymupdf/PyMuPDF/blob/master/demo/pymupdf.jpg)
 
-Release date: Juli 18, 2019
+Release date: August 2, 2019
 
 **Travis-CI:** [![Build Status](https://travis-ci.org/JorjMcKie/py-mupdf.svg?branch=master)](https://travis-ci.org/JorjMcKie/py-mupdf)
 
@@ -14,7 +14,7 @@ On **[PyPI](https://pypi.org/project/PyMuPDF)** since August 2016: [![](https://
 
 # Introduction
 
-This is **version 1.14.19 of PyMuPDF (formerly python-fitz)**, a Python binding with support for [MuPDF 1.14.x](http://mupdf.com/) - "a lightweight PDF, XPS, and E-book viewer".
+This is **version 1.14.20 of PyMuPDF (formerly python-fitz)**, a Python binding with support for [MuPDF 1.14.x](http://mupdf.com/) - "a lightweight PDF, XPS, and E-book viewer".
 
 MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB and FB2 (e-books) formats, and it is known for its top performance and high rendering quality.
 

demo/PIL2fitz.py

@@ -3,24 +3,26 @@
 import fitz
 from PIL import Image
 import sys
-'''
+
+print(fitz.__doc__)
+"""
 Create a Pixmap from any PIL / Pillow supported filetype
 Changes in v1.10.0
 -------------------
 - omit alpha to save image memory
-'''
+"""
 if len(sys.argv) == 2:
     pic_fn = sys.argv[1]
 else:
     pic_fn = None
 
 if pic_fn:
-    print('Reading %s' % pic_fn)
+    print("Reading %s" % pic_fn)
     pic_f = open(pic_fn, "rb")
     img = Image.open(pic_f).convert("RGB")
     samples = img.tobytes()
     pix = fitz.Pixmap(fitz.csRGB, img.size[0], img.size[1], samples, 0)
-    outputFileName = pic_fn + '-from-PIL.png'
-    print('Writing %s' % outputFileName)
+    outputFileName = pic_fn + "-from-PIL.png"
+    print("Writing %s" % outputFileName)
     pix.writePNG(outputFileName)
     pic_f.close()

demo/README.md

@@ -2,31 +2,22 @@
 
 Program | Purpose
 ------- | -------
-annot-tests.py | produce a PDF with assorted annotations
 caustic.py | demo producing a PDF with the catacaustic
-list-fields.py | prints field information for a Form PDF
+curly-polygon.py | demo draw regular polygon with curly border
+decrypt.py | create a decrypted copy of a PDF file
 demo.py | demonstrates a broad range of PyMuPDF high-level functions
 demo-lowlevel.py | demonstrates PyMuPDF low-level functions
 draw-sines.py | draw sine / cosine functions
-extract-img1.py | PDF only: extracts all **page-referenced** images as PNG files
-extract-img2.py | PDF only: extracts **all** (valid) images as PNG files
-extract-img3.py | PDF only: extracts page images using raw image buffers (variable extensions)
-extract-img4.py | Any Document type: extracts page images (with variable extensions) using the v1.13.1 getText("dict") method
 fitz2PIL.py | save a pixmap as a PIL / Pillow supported file
-PIL2fitz.py | create a pixmap from any PIL / Pillow supported file
+fitz-logo.py | put any document as logo an each PDF page.
 numpy2fitz.py | how to create pixmaps from NumPy arrays
+pdf-converter.py | convert arbitrary documents (XPS, EPUB, CBZ, etc.) to PDF
 PDFdisplay.py | display a document using wxPython
 pdfviewer(wx).py | alternative wxPython viewer
-pencil.py | create the pencil of the ReportLab User Guide with PyMuPDF
-piechart1.py | create a circular pie chart
-piechart2.py | create a semi-circular pie chart
+PIL2fitz.py | create a pixmap from any PIL / Pillow supported file
 pixmap-tiles.py | use pixmap to create tiled copies of an image file
-decrypt.py | create a decrypted copy of a PDF file
 sierpinski.py | create a Sierpinski carpet (fractal) fast with pixmaps
 splitter.py | split a PDF into its pages (1 PDF per page)
-fitz-logo.py | put any document as logo an each PDF page.
-svg-logo.py | put an SVG as logo an each PDF page.
 spumoni.py | create the ReportLab drawing on page 26 with PyMuPDF
+svg-logo.py | put an SVG as logo an each PDF page.
 text2pdf.py | convert a text file to PDF
-wavy-polygon.py | draw a regular polygon with curly borders
-pdf-converter.py | convert arbitrary documents (XPS, EPUB, CBZ, etc.) to PDF

demo/caustic.py

@@ -3,7 +3,10 @@
 import fitz
 from fitz.utils import getColor
 import gzip
+
 """
+@Copyright 2017-2019, Jorj McKie, mailto:<[email protected]>
+
 @created: 2017-06-18 10:00:00
 
 @author: (c) Jorj X. McKie
@@ -26,42 +29,48 @@
 The resulting picture is save in three image formats: PDF, PNG and SVG / SVGZ
 
 """
+print(fitz.__doc__)
+
+
 def pvon(a):
     """Starting point of a reflected sun ray, given an angle a."""
-    return(math.cos(a), math.sin(a))
+    return (math.cos(a), math.sin(a))
+
 
 def pbis(a):
     """End point of a reflected sun ray, given an angle a."""
-    return(math.cos(3*a - math.pi), (math.sin(3*a - math.pi)))
+    return (math.cos(3 * a - math.pi), (math.sin(3 * a - math.pi)))
+
 
-fileprfx = "catacaustic"                         # filename prefix
-coffee = getColor("coffee")                      # color: latte macchiato?
-yellow = getColor("yellow")                      # color of sun rays
-blue   = getColor("blue")                        # color cup border
-doc = fitz.open()                                # new empty PDF 
-page = doc.newPage(-1, width = 800, height = 800)# create square sized page
-center = fitz.Point(page.rect.width / 2,         # center of circle on page
-                    page.rect.height / 2)
+fileprfx = "catacaustic"  # filename prefix
+coffee = getColor("coffee")  # color: latte macchiato?
+yellow = getColor("yellow")  # color of sun rays
+blue = getColor("blue")  # color cup border
+doc = fitz.open()  # new empty PDF
+page = doc.newPage(-1, width=800, height=800)  # create square sized page
+center = fitz.Point(
+    page.rect.width / 2, page.rect.height / 2  # center of circle on page
+)
 
-radius = page.rect.width / 2 - 20                # leave a border of 20 pixels
+radius = page.rect.width / 2 - 20  # leave a border of 20 pixels
 
 img = page.newShape()
 img.drawCircle(center, radius)
-img.finish(color = coffee, fill = coffee)        # fill coffee into the cup
+img.finish(color=coffee, fill=coffee)  # fill coffee into the cup
 
-count = 200                                      # how many sun rays we draw
-interval = math.pi / count                       # angle fraction
+count = 200  # how many sun rays we draw
+interval = math.pi / count  # angle fraction
 for i in range(1, count):
-    a = -math.pi / 2 + i * interval              # go from -90 to +90 degrees
+    a = -math.pi / 2 + i * interval  # go from -90 to +90 degrees
     von = fitz.Point(pvon(a)) * radius + center  # start point adjusted
     bis = fitz.Point(pbis(a)) * radius + center  # end point adjusted
     img.drawLine(von, bis)
-    
-img.finish(width = 1, color = yellow, closePath = False) # a ray is a fine yellow line
+
+img.finish(width=1, color=yellow, closePath=False)  # a ray is a fine yellow line
 
 img.drawCircle(center, radius)
-img.finish(color = blue)                         # cup border is blue
-page.setCropBox(img.rect)                        # adjust visible page
+img.finish(color=blue)  # cup border is blue
+page.setCropBox(img.rect)  # adjust visible page
 img.commit()
 doc.save(fileprfx + ".pdf")
 
@@ -76,4 +85,4 @@ def pbis(a):
 fout.close()
 fout = open(fileprfx + ".svgz", "wb")
 fout.write(svgz)
-fout.close()
+fout.close()

demo/curly-polygon.py

@@ -1,7 +1,7 @@
 """
 Created on 2017-09-06
 
-@author: (c) 2017, Jorj X. McKie
+Copyright 2017-2019, Jorj McKie, mailto:<[email protected]>
 
 License: GNU GPL V3
 
@@ -22,17 +22,20 @@
 """
 
 import fitz
+
+print(fitz.__doc__)
+
 fname1 = "curly-polygon"
-doc     = fitz.open()
-page    = doc.newPage()
-img     = page.newShape()
-nedge   = 5                            # number of polygon edges
-breadth = 2                            # wave amplitude
-beta    = -1.0 * 360 / nedge           # our angle, drawn clockwise
-center = fitz.Point(300,300)           # center of circle
-p0     = fitz.Point(300,200)           # start here (1st edge = north)
-p1     = +p0                           # save as last edge to add
-points = [p0]                          # to store the polygon edges
+doc = fitz.open()
+page = doc.newPage()
+img = page.newShape()
+nedge = 5  # number of polygon edges
+breadth = 2  # wave amplitude
+beta = -1.0 * 360 / nedge  # our angle, drawn clockwise
+center = fitz.Point(300, 300)  # center of circle
+p0 = fitz.Point(300, 200)  # start here (1st edge = north)
+p1 = +p0  # save as last edge to add
+points = [p0]  # to store the polygon edges
 
 # we only use this to calculate the polygon edges
 # we will delete the resp. draw commands
@@ -41,14 +44,14 @@
     points.append(p0)
 
 # erase previous draw commands in contents buffer
-img.contents = ""
+img.draw_cont = ""
 
-points.append(p1)                      # add starting point to edges list
+points.append(p1)  # add starting point to edges list
 # now draw the lines along stored edges
 for i in range(nedge):
-    img.drawSquiggle(points[i], points[i+1], breadth = breadth)
+    img.drawSquiggle(points[i], points[i + 1], breadth=breadth)
 
-img.finish(color = (0,0,1), fill = (1,1,0), closePath = False)
+img.finish(color=(0, 0, 1), fill=(1, 1, 0), closePath=False)
 
 # adjust visible page to dimensions of the drawing
 page.setCropBox(img.rect)

demo/decrypt.py

@@ -1,4 +1,6 @@
 """
+Copyright 2016-2019, Jorj McKie, mailto:<[email protected]>
+
 This demo will open an encrypted PDF document, decrypt it with the provided
 password and save as a new PDF document.
 
@@ -7,17 +9,21 @@
 import fitz
 import sys
 
-assert len(sys.argv) == 4, \
- 'Usage: %s <input file> <password> <output file>' % sys.argv[0]
+print(fitz.__doc__)
+assert len(sys.argv) == 4, (
+    "Usage: %s <input file> <password> <output file>" % sys.argv[0]
+)
 
 doc = fitz.Document(sys.argv[1])
-#the document should be password protected
+# the document should be password protected
 assert doc.needsPass, sys.argv[0] + " not password protected"
 
-#decrypt the document
-#return non-zero if failed
-assert doc.authenticate(sys.argv[2]), \
- 'cannot decrypt %s with password "%s"' % (sys.argv[1], sys.argv[2])
+# decrypt the document
+# return non-zero if failed
+assert doc.authenticate(sys.argv[2]), 'cannot decrypt %s with password "%s"' % (
+    sys.argv[1],
+    sys.argv[2],
+)
 
-#save as a new PDF
-doc.save(sys.argv[3], decrypt=True) # decrypt=False is default
+# save as a new PDF
+doc.save(sys.argv[3], decrypt=True)  # decrypt=False is default