Opening Files¶
Supported File Types¶
PyMuPDF¶
PyMuPDF can open files other than just PDF.
The following file types are supported:
| PDF XPS EPUB MOBI FB2 CBZ SVG TXT | |
|
JPG/JPEG, PNG, BMP, GIF, TIFF, PNM, PGM, PBM, PPM, PAM, JXR, JPX/JP2, PSD
JPG/JPEG, PNG, PNM, PGM, PBM, PPM, PAM, PSD, PS
|
PyMuPDF Pro¶
PyMuPDF Pro can open Office files.
The following file types are supported:
DOC/DOCX |
XLS/XLSX |
PPT/PPTX |
HWP/HWPX |
|---|---|---|---|
|
|
|
|
How to Open a File¶
To open a file, do the following:
doc = pymupdf.open("a.pdf")
Note
The above creates a Document. The instruction doc = pymupdf.Document("a.pdf") does exactly the same. So, open is just a convenient alias and you can find its full API documented in that chapter.
File Recognizer: Opening with a Wrong File Extension¶
If you have a document with a wrong file extension for its type, do not worry: it will still be opened correctly, thanks to the integrated file “content recognizer”.
This component looks at the actual data in the file using a number of heuristics – independent of the file extension. This of course is also true for file names without an extension.
Here is a list of details about how the file content recognizer works:
When opening from a file name, use the
filetypeparameter if your file format cannot be determined by content inspection. This is for instance the case for all text files: “txt”, “html”, “xml” or source files. If the file extension is missing or wrong or the file resides in memory, thefiletypemust be used. File formats that can successfully be recognized will be opened even without or wrong extensions, and thefiletypeparaneter will be ignored.Files based on text content do not contain unambiguously recognizable internal structures. This is true for source files (Python, C, etc.) but also HTML, XML and so on. Here, the file extensions and the
filetypeparameter continue to play a role and are used to create a “Tex” / “HTML” / … document. Correspondingly, text files with other / no extensions, can successfully be opened usingfiletype.
Opening Remote Files¶
For remote files on a server (i.e. non-local files), you will need to stream the file data to PyMuPDF.
For example use the requests library as follows:
import pymupdf
import requests
r = requests.get('https://mupdf.com/docs/mupdf_explored.pdf')
data = r.content
doc = pymupdf.Document(stream=data)
Opening Files from Cloud Services¶
For further examples which deal with files held on typical cloud services please see these Cloud Interactions code snippets.
Opening Django Files¶
Django implements a File Storage API to store files. The default is the FileSystemStorage, but the django-storages library provides a number of other storage backends.
You can open the file, move the contents into memory, then pass the contents to PyMuPDF as a stream.
import pymupdf
from django.core.files.storage import default_storage
from .models import MyModel
obj = MyModel.objects.get(id=1)
with default_storage.open(obj.file.name) as f:
data = f.read()
doc = pymupdf.Document(stream=data)
Please note that if the file you open is large, you may run out of memory.
The File Storage API works well if you’re using different storage backends in different environments. If you’re only using the FileSystemStorage, you can simply use the obj.file.name to open the file directly with PyMuPDF as shown in an earlier example.
Opening Files as Text¶
PyMuPDF has the capability to open any plain text file as a document. In order to do this you should provide the filetype parameter for the pymupdf.open function as "txt".
doc = pymupdf.open("my_program.py", filetype="txt")
In this way you are able to open a variety of file types and perform the typical non-PDF specific features like text searching, text extracting and page rendering. Obviously, once you have rendered your txt content, then saving as PDF or merging with other PDF files is no problem.
Examples¶
Opening a C# file¶
doc = pymupdf.open("MyClass.cs", filetype="txt")
Opening an XML file¶
doc = pymupdf.open("my_data.xml", filetype="txt")
Opening a JSON file¶
doc = pymupdf.open("more_of_my_data.json", filetype="txt")
And so on!
As you can imagine many text based file formats can be very simply opened and interpreted by PyMuPDF. This can make data analysis and extraction for a wide range of previously unavailable files possible.