Saravanan666/pypi-org huggingface dataset:
Package: pdf-toc
PDF ToCa CLI tool to easily extract / edit ToC(Table of Content, or bookmark) of pdf fileRequirementspython >= 3.7for python 3.6 support, usepdf-toc == 1.1.4PyMuPDF >= 1.19Installationinstall from pypipipinstallpdf-tocinstall from the repo directlypipinstallgit+https://github.com/HareInWeed/pdf-toc.git@master#egg=pdf-tocinstall a specific versionpipinstallgit+https://github.com/HareInWeed/pdf-toc.git@v1.1.4#egg=pdf-tocUsageusage: pdf-toc [-h] [--version] [--show-toc {json,toc}] [-t TOC] [-d DEST]
               [-T {json,toc}] [-f] [-m]
               source

pdf ToC modifier.

positional arguments:
  source                source pdf file directory

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --show-toc {json,toc}
                        print the toc info of the source file and exit
  -t TOC, --toc TOC     toc info used to embed in the result file. leave it
                        empty to read toc from stdin
  -d DEST, --dest DEST  destination directory for result file
  -T {json,toc}, --type {json,toc}
                        specify format of ToC file. leave it empty to let the
                        tool determine the format, (from file suffix)
  -f, --force           overwrite dist file if it exist
  -m, --modify          modified the original file instead of create a new oneExamplesshow the toc of file.pdf intocformatpdf-toc--show-toctocfile.pdfGenerate a new file with content of file.pdf and toc in toc.txtpdf-toc-ttoc.txt-dnew-file.pdffile.pdfReplace the toc of file.pdf with one in toc.txtpdf-toc-m-ttoc.txtfile.pdfToC fileTwo types of toc file are supportedOne is json, which mostly follow the specification of PyMuPDF, but in json format. SeePyMuPDF docsandtoc_json.mdfor detailThe other is a special data format, which provides ease of modification and additional functionalities. Check outtoc.mdfor detailLicenceMIT
Package: pdftoimg
Pdf-To-ImageSimple Command Line tool to convert PDF to Image. It is a wrapper ofpdf2image.How to Installpip install pdftoimgYou need to install poppler if you don't have already.For Windows you can install it fromhere.For MacOS you can install it fromhere.How to useOpen terminal.Runpdftoimg -hfor help.Usage:pdftoimg -i <pdf_path> -o <output_folder_path> -f <format> -d <dpi> -g <True/False>Example usage:To convert single PDF to image by specifying absolute path:pdftoimg -i /Users/starkblaze01/Bova/file_name.pdf -o /Users/starkblaze01/output_folderTo convert multiple PDFs in a directory to images in the sample folder:pdftoimg -i /Users/starkblaze01/Bova/input_folder -o /Users/starkblaze01/output_folderNote:Using this will convert all the PDFs present in input_folder directory and its sub-directories.Definitions:-i for input pdf_file path-o for output_folder path-f for image format(Default: jpeg)-d for dpi(Default: 200)-g for grayscale image(Default: False)GIFClickhereto see GIF of sample usage.
Package: pdfToJson
DATA FORMAT{
    "title": "title of a paper",
 	"authors": [
        {
            "firstName": "firstName of an author",
            "lastName": "lastName of an author "
        }
    ],
    "keywords":["keyword1","keyword2"],
    "abstract": "abstract of a paper",
    "paperContent":{
        "text": "all content of a paper (This is also a concatenation of subtexts)",
        "subtitles": ["Introduction", "Model"],
        "subtexts": ["section1Content", "section2Content"]
    },
    "references":[
        {
            "refTitle": "title of a reference paper",
            "refAuthors": [
                {
                    "firstName": "firstName of an author",
                    "lastName": "lastName of an author "
                }
            ],
            "refYear": "publised year of a reference paper",
            "refPublisher": "publised journal of a reference paper"
        }
    ]
}
Package: pdf-to-markdown
PDF To MarkdownThis is NOT a general-purpose converter.
Currently only for urban planning document in Taiwan.DemoFromthis PDF file, we generate:Gitbook versionSimple markdownInstallPlease typesudo pip install pdf-to-markdownUsageJust typepdf2md <pdf>For example, you can use our example PDF file:pdf2md pdf-to-markdown/examples/neihu.pdf
Package: pdf-tools
pdf-toolsPDF tools, e.g. pdf2images, images2pdf, pdf2text, pdf2html, pdfmeta...Installpip install pdf-toolsInstalled Commandspdfmetapdf2textpdf2htmlpdf2imagesimages2pdfCommand HelpsE:\pylabs\pdf-tools>pdfmeta --help
Usage: pdfmeta [OPTIONS] FILENAME

Options:
-p, --password TEXT
--help               Show this message and exit.

E:\pylabs\pdf-tools>pdf2text --help
Usage: pdf2text [OPTIONS] FILENAME

Options:
-p, --password TEXT
--help               Show this message and exit.

E:\pylabs\pdf-tools>pdf2html --help
Usage: pdf2html [OPTIONS] FILENAME

Options:
-p, --password TEXT
--help               Show this message and exit.

E:\pylabs\pdf-tools>pdf2images --help
Usage: pdf2images [OPTIONS] FILENAME

Options:
-p, --password TEXT
-o, --output TEXT
-t, --type [png|jpg]
--help                Show this message and exit.

E:\pylabs\pdf-tools>images2pdf --help
Usage: images2pdf [OPTIONS] FOLDER

Options:
-o, --output TEXT  PDF filename.  [required]
--help             Show this message and exit.Releasesv0.2.0 2020/05/22Use pillow module to create pdf file from image instead of fitz module. It makes a smaller result pdf file.Fix document.v0.1.0 2019/08/09First release.
Package: pdftools.pdfjoin
pdfjoincan be used to join PDF documents. It supports a simpledropletmode. It will join all files passed as argument into a new
file.pdfjoinhas three modes of operation:With no output path given: The droplet mode.If no output path is passed topdfjoin, will look for a file
matchingpdfjoin-*.pdfin the current directory, which has been
modified within the last 60 minutes. (More precise, the filename
must match the scheme as described in the next paragraph.)q If such
a file exists, all documents passed as arguments will be joined to
this one.If such a file does not exist, it will be created first. The
filename will bepdfjoin-yyyddmm-hhmm.pdfwithyyyddmmbeing the current date andhhmmbeing the current time.This allows dropping one file after each other onto the droplet and
join them into the same output file – assuming you are not waiting
more then 60 Minutes between each drop.With an existing directory name is given as output pathThis case works exactly like the droplet mode, except that the file
is searched for and created in the given directory.With any other path given as output path:In this case the given path is the filename searched for and
created if not existing yet.Unfortunatly the old project homepage at origo.ethz.ch has been shut down
together with origo. For now the source is hosted athttps://gitlab.com/pdftools/pdfjoin.
Package: pdftools.pdfposter
Author:Hartmut Goebel <h.goebel@crazy-compilers.com>Version:Version 0.8.1Copyright:2008-2022 by Hartmut GoebelLicense:GNU Public License v3 or later (GPL-3.0-or-later)Homepage:https://pdfposter.readthedocs.io/Pdfpostercan be used to create a large poster by building it from
multiple pages and/or printing it on large media. It expects as input a
PDF file, normally printing on a single page. The output is again a
PDF file, maybe containing multiple pages together building the
poster.
The input page will be scaled to obtain the desired size.This is much likeposterdoes for Postscript files, but working
with PDF. Since sometimes poster does not like your files converted
from PDF. :-) Indeedpdfposterwas inspired byposter.For more information please refer to the manpage or visit
theproject homepage.Requirements and InstallationPdfposterrequiresPython(3.6—3.10, but newer versions should work, too),setuptoolsorpipfor installation, andPyPDF2(2.1.1 or newer).
Package: pdftopng
pdftopngA PDF to PNG conversion library (based onpdftoppmfrompoppler)Installation$ pip install pdftopngUsagefrom pdftopng import pdftopng

pdftopng.convert(pdf_path="foo.pdf", png_path="foo.png")$ pdftopng /path/to/pdf /path/to/pngTestingFirst, set up the development environment using:$ pip install -e ".[dev]"And then:$ pytest --verbose --cov-report term --cov-report xml --cov=pdftopng tests/test_*.pyVersioningpdftopngusesSemantic Versioning. For the available versions, see the tags on this repository.LicenseThis project is licensed under GPLv2, see theLICENSEfile for details.
Package: pdf-to-scan
PDFtoScanPDFtoScan uses the idea implemented inbaicunko'swebsite to make your PDFs look like they were scanned in a CLI-based app.Installation$pipinstallpdf-to-scanDependenciesThe script requiresghostscriptandimagemagickto run.
These can be installed using,For Ubuntu$sudoapt-getinstallimagemagick$sudoapt-getinstallghostscriptFor macOS$brewinstallimagemagick$brewinstallghostscriptPDF support in ImageMagick might be disabled be default on your os/distro. To fix this, comment out this line in/etc/ImageMagick-6/policy.xml<policy domain="coder" rights="none" pattern="PDF" />Using<!-- --->
Package: pdftotext
pdftotextSimple PDF text extractionimportpdftotext# Load your PDFwithopen("lorem_ipsum.pdf","rb")asf:pdf=pdftotext.PDF(f)# If it's password-protectedwithopen("secure.pdf","rb")asf:pdf=pdftotext.PDF(f,"secret")# How many pages?print(len(pdf))# Iterate over all the pagesforpageinpdf:print(page)# Read some individual pagesprint(pdf[0])print(pdf[1])# Read all the text into one stringprint("\n\n".join(pdf))OS DependenciesThese instructions assume you're using Python 3 on a recent OS. Package names
may differ for Python 2 or for an older OS.Debian, Ubuntu, and friendssudo apt install build-essential libpoppler-cpp-dev pkg-config python3-devFedora, Red Hat, and friendssudo yum install gcc-c++ pkgconfig poppler-cpp-devel python3-develmacOSbrew install pkg-config poppler pythonWindowsCurrently tested only when using conda:Install the Microsoft Visual C++ Build ToolsInstall poppler through conda:conda install -c conda-forge popplerInstallpip install pdftotext
Package: pdftotext3
PDF TO TEXT CONVERTERA simple Python script to convert PDF Documents to Text Files.Supported Operating Systems:-Debian / Debian Based Linux DistrosUbuntu / Ubuntu Based Linux DistrosFedora / Fedora Based Linux DistrosWindows 10 and above Windows Operating Systems.It converts all PDF Files in current working Folder/Directory to
Text Files.NOTE: THIS TOOL IS MEANT TO CONVERT THOSE PDF DOCUMENTS WHICH ARE NOT EASILY CONVERTBLE TO OTHER FORMATS.
CURRENTLY THIS TOOL SUPPORTS ENGLISH ONLY.
Package: pdf-to-wordcloud
pdf_to_wordcloudGenerates a word cloud from a given PDFInstallation$pipinstallpdf_to_wordcloudArgumentsPositional:PDF: Name of PDF file from which to geneate the wordcloudOptional:--remove (-r): Removes word from wordcloud. Accepts multiple arguments (one per flag)--save (-s): Saves wordcloud as PDF to current directory (no additional argument needed)--saveto (-st): Saves wordcloud to specified directory--mask (-m): PNG file to use as shape of wordcloud--exportdata (-x): Save CSV of word frequency data--filename (-n): Optional name of data and wordcloud files (omit .pdf/.csv)UsageDisplay wordcloud of file.pdf:$pdffile.pdfSave image of wordcloud as PDF:$pdffile.pdf-sRemove "this" and "that" from wordcloud and save:$pdffile.pdf-rthis-rthat-sRemove "this" and "that" from wordcloud, export word frequency data and save both files with "my_output" filename:$pdffile.pdf-rthis-rthat-x-nmy_output-s
Package: pdftty
pdfttyA PDF viewer for the terminal.Installation$pipinstallpdfttyMake sure to also installlibcacaif you want to use theCACArendering engine.Usage$pdftty--help
Usage:pdftty[OPTIONS]<file>ViewPDFsintheterminal.

Options:--pageINTEGERPageofPDFtoopen.--render-engine[ANSI|CACA]WhichenginetousetorenderPDFpageastext.--helpShowthismessageandexit.https://github.com/Belval/pdf2imagehttps://github.com/djentleman/imgrender/blob/master/imgrender/main.pyUrwid tips:Widget classes:http://urwid.org/manual/widgets.htmlWidget reference:http://urwid.org/reference/widget.htmlpoetry tippspoetry install
poetry shell
# do tests
python -m pdftty.main test.pdf
Package: pdftxt
pdftxtThe goal of this project is to provide an api to extract text
from specific regions of a pdf document/page and a cli to assist
identifying the location of text within a document.Installation... pip install pdftxtBasic Command Line UsageLet's say we have a PDF file (PDF-DOC.pdf) that looks like this:Thepdftxtcommand:... pdftxt PDF-DOC.pdfWill output a visual layout of the pdf document's pages and text elements to an html page:API Usagefrom pathlib import Path
from pdftxt import api

filepath = 'tests/Word_PDF.pdf'

with api.PdfTxtContext(filepath) as pdf:

    for page in pdf:

        # To fetch text objects from specific region
        # of the page, first define the region:
        region = api.Region(400, 300, 512, 317)

        # Initialize layout parameters:
        params = api.PdfTxtParams()

        # Then analyze that area of the page for text objects:
        text = page.analyze(region, params)

        # Do whatever it is we need to do with the results:
        for txt in text:
            print(txt.text)
Package: pdfuck
简体中文|English简介PDFuck是一个去除 PDF 编辑密码的工具，以命令行方式使用。安装在安装前，请确保你安装了 Python (>=3.0) 及与之版本相匹配的 pip，然后在命令提示符中输入下面的命令：pipinstallpdfuck使用去除 PDF 密码例如，想要去除密码的 PDF 文件位于example.pdf，只需输入下面的命令：pdfuckexample.pdf输出文件的默认路径为example.fucked.pdf。手动指定输出文件路径如果想要手动指定输出文件的路径，可以使用-o参数，例如：pdfuckexample.pdf-otarget.pdfPDF 文件含有打开密码使用-p参数手动指定打开密码，例如：pdfuckexample.pdf-ppassword致谢感谢以下开源项目，本项目的完成离不开这些作者贡献的代码。pikepdf工作流配置开发环境pipinstall-rrequirements.txt构建与测试python-mbuild
pipinstall--editable.开源协议GPL-3.0
Package: pdf-unlocker
PDF UnlockerThis is a simple Python script that converts PDF files into versions without any permission restrictionsThis script utilizespikepdfto make a clean copy of each pageUsageInstall the RequirementsTo install the necessary requirements, run the following command:pipinstallpdf-unlockerTypical Usagepdf-unlockerinput.pdf-ooutput.pdf
pdf-unlockerinput.pdf-ooutput.pdf--password1234pdf-unlockerinput.pdf-ooutput.pdf--stdin-passwordecho1234|pdf-unlockerinput.pdf-ooutput.pdf--stdin-password
pdf-unlockerinput.pdf-bThe resulting PDF file should not have any permission restrictions, nor should it require a password for usage (the password is required only to read the source PDF)ArgumentsArgumentDescription(Required)input PDF file-p PASSWORD--password PASSWORDpassword for the input PDF file--stdin-passwordread password from stdin (this will override the --password or -p argument)-o OUTPUT--output OUTPUToutput PDF filedefault: output.pdf-b--backupthe original file will be saved with the extension .bak, and the default output will be the original one
Package: pdfutil
pdfutil [Under Development]Library provides a lot of operations over PDF/Image.Input and OutputThe Libarary expose each function with a standard set of argument which are fixed for eevry functionimport pdfutil
coordinates = pdfutil.detect_*(pdf_location, [save_result=False], [show_result=False], [result_location='.'], [args={}])NameDescriptionpdf_locationinput location of PDF, image can also be passed libaray will autodetect the imagesave_resultDefault False, If True will save the result pdf/img in location specified by result_locationshow_resultDefault False, This is used for debugging only when True will popup a matplotlib plot highlighting the regions which are detected with corresponding labelsresult_locationDefault current directory, location where ouptut needs to be saved, ignored if save_result is set as Falseargscustom set of args in form of dictionaty specific to each functioncoordinatesOutput returned by the function call, this will contain json output in following format[
  {
    "type": "text",
    "output": {
      "coord": [
        ["pageno_1", "startx_1", "starty_1", "width_1", "height_1"],
        ["pageno_2", "startx_2", "starty_2", "width_2", "height_2"]
      ]
    }
  },
  {
    "type": "table",
    "output": {
      "coord": [
        ["pageno_1", "startx_1", "starty_1", "width_1", "height_1"],
      ]
    }
  }
]operationsDetecting Tablesimport pdfutil
coordinates = pdfutil.detect_tables(pdf_location)Detecting Text Regions [Paragrahs / Unstructured Content]import pdfutil
coordinates = pdfutil.detect_text(pdf_location)Detecting Non-Text Regions [Images / Logos]import pdfutil
coordinates = pdfutil.detect_non_text(pdf_location)Detecting Languageimport pdfutil
coordinates = pdfutil.detect_non_language(pdf_location)Detecting Key Value Pairsimport pdfutil
coordinates = pdfutil.detect_key_value_pairs(pdf_location)
Package: pdf-utils
## Tools for processing pdf filesThis is a light-weighted library for processing pdf files in python.
One of the use-cases might be the extraction of pdf-annotations for ML / NLP.Support forobtaining textual and vizual content of pdf fileslocating positions of wordsfetching pdf annotationsadding a digital layer to image-pdfsre-creating a clean pdf file with annotations removed## DependenciesMain tools for reading pdf files are the PyPDF2 library. Non-python dependencies are[Poppler](https://poppler.freedesktop.org/),[Tesseract](https://tesseract-ocr.github.io/tessdoc/Home.html), and[OpenCV](https://opencv.org/).To install Poppler, see the guide in the [pdf2image readme](https://pypi.org/project/pdf2image/).## How toSome examples of usage are shown in the [notebook](./notebook/Demo.ipynb).## TodoAdd detection of page-orientation (upside-down, rotated,…) based on images.Add some of our experiments with “naive” table detectionGet rid of PyPDF2 as [it is not maintained](https://stackoverflow.com/questions/63199763/maintained-alternatives-to-pypdf2); replace by PyMUPdf or pdfMiner.six.
Package: pdfwork
PDFWork基于pikepdf封装的一个便于使用的
pdf 处理命令行工具。 提供以下功能：书签（也叫目录）导入、导入、抹除PDF文件中的书签合并 PDF分割 PDF安装方法可以通过 pip 或 pipx 安装：# pippipinstallpdfwork# pipxpipxinstallpdfwork使用合并 PDF 文件假设你有一堆 PDF 文件，那么你可以使用pdfwork merge子命令来将它们合并。使用-o选项指定合并后的文件保存路径。要输入需要合并的文件，有三种方法：直接在命令行中输入：-i alpha.pdf beta.pdf gamma.pdf在以@开头的文本文件（例如@pdf.list.txt）中以每行一个的形式编写 PDF 片段的路径，然后用-i @pdf.list.txt的形式指定列表文件。程序会在指定文件中读取 PDF 片段的路径。$pdfworkmerge-omerged.pdfa.pdfb.pdfc.pdf

$pdfworkmerge-omerged.pdf@abc.list.txt@abc.list.txt的内容如下:a.pdf
b.pdf
c.pdf拆分 PDF 文件pdfwork 可以将一个完整的 PDF 文件按页拆分成单页 PDF。使用-i origin.pdf输入源文件路径。然后通过-o prefix.{:03d}.pdf设置输出文件名模板。可以在模板中使用 Python format 风格的占位符（详见https://docs.python.org/zh-cn/3/library/string.html\#formatspec），例如{:d}或{:04d}之类，像十六进制的{:x}、八进制的{:o}和二进制的{:b}也是可以使用的。当-o参数未指定时，程序会使用类似于{:0d}.pdf这样的模板，但自动推导宽度，以确保生成 001.pdf ~ 999.pdf 样式的文件。$pdfworksplitorigin.pdf-o"origin.{:04d}.pdf"导入导出 PDF 文件的书签pdfwork
提供一种字面形式的书签描述语言，可以描述书签的标题、页码和嵌套关系。导入时，将描述语言转换成
PDF 的书签结构写入 PDF；导出时，从 PDF 中读取书签结构，编码成描述语言。描述语言以一行作为一条书签，通过@将一行分为 标题和页码两个部分:标题 @ 页码并且用缩进来表示嵌套层级:根书签 @ 页码
    子书签 1 @ 页码
    子书签 2这里可以观察到， "子书签 2"
没有输入页码。这是因为如果相邻的书签具有相同的页码，那么除了第一条之外的书签页码都可以省略不写，由程序自动推导。$pdfworkoutlineimportorigin.pdf-ibookmarks.txt-oorigin.bookmarked.pdf--offset20$pdfworkoutlineexportorigin.pdf-obookmarks.exported.txt在导入时，通常需要输入一个参数--offset，这个参数表示正文页码和物理页码的偏差。例如，大多数书籍都有封面、扉页、前言、目录等结构，这些结构并没有算在目录的页码里。因此，当从书籍的目录中将页码转抄过来，就会存在一个值为
offset 的偏差。假设正文第 1 页在 PDF 中的实际页码是 21，那么 offset = 211 =
20。如果所操作的书籍没有此类问题，那么可以省略此参数，令程序使用默认值
offset = 0 。另外，程序会自动生成序号。在导出时，各目录的页码已经计算成了物理页码，偏差归零。在docs/example.bookmark.txt有一份示例的描述语言文本。抹除书签保存去除了书签信息的 PDF 版本。$pdfworkoutlineeraseorigin.pdf-oerased.pdf优化 PDF 文档可以优化 PDF 文档：以线性化模式保存 PDF，以便网络加载去除 PDF 中的重复图像对象，另所有图像引用指向唯一对象去除 PDF 中未引用的资源
Package: pdfworkshop
pdfworkshopPDF compress tool, using iLovePDF APIPrerequisitesThe application is compatible with Windows and Linux based systems.
Python version 3.6 or above is assumed to be installed, as well as pip package manager utility and setuptools module.Installationpipinstallpdfworkshoporpythonsetup.pyinstallorpipinstall-e~/local_fork_repo_path/How to runpdfworkshop-hConfigurationnamedefaultdescriptioninput_dir./Directory where PDF files will be collected from.output_dir./output/Directory where the compressed PDF files will be stored.public_key""Your public API key.suffix""The suffix given to compressed files (before the extension).recursiveFalseBoolean indicating if input_dir must be scanned recursively.The public_key value must be defined before using the tool for the first time.
The required public key can be obtained by creating a developer account oniLovePDF.
Any value can be configured using:pdfworkshopconfig<config_name><new_config_value>Commandslist-config - list configuration valuesconfig <option> <value> - edit tool configuration valuesrun - compress all PDF files stored in input_dir, storing the result in output_dirHow to useBy default, the PDF files to compress should be on the directory from where the tool will be called.
After using theruncommand, anoutputdirectory will be created, where all compressed
files will be stored.Example runTo exercise some of the available commands, one can try to:List the current configurationpdfworkshoplist-configDefine the API public_key valuepdfworkshopconfigpublic_key<new_public_key>Run PDF compress toolpdfworkshoprunLicenseThis project is licensed under the MIT License - seeLICENSEfile for details.
Package: pdf-wrangler
pdf-wranglerPDFMiner wrapper used to simplify PDF extraction and other PDF utilities.Document classTheDocumentclass is used to represent a PDF document. It contains functionality to access the raw text by page, PDF metadata and images in the form of PDFMiner'sLTImageobject.Example Usagefrom pdf_wrangler import Document

pdf_document = Document('path/to/pdf.pdf')

# to access pdf metadata
pdf_document.get_metadata()

# to access full pdf text
pdf_document.get_text()

# print text by pdf page
for page in pdf_document.pages:
    print(page.get_text())

# to access pdf images by page
page_1_images = pdf_document.pages[0].images

# get first image bytes representation
page_1_images[0].stream.get_data()InstallationTo install, run:pip install pdf-wrangler
Package: pdfxcb
pdfxcbSplit a PDFpdfxcbsplits a PDF using pages with barcodes as delimiters or after every Nth page.Splitting a PDF using barcodesAny page in the input PDF containing a barcode is potentially a "barcode sheet". Each barcode sheet, and those pages succeeding that page and preceding the next barcode sheet, comprise a single set of pages output as a discrete PDF file.Each output file is named, by default, as<encoded string>-<index>.pdfwhere<encoded string>is the content encoded by the barcode on the barcode sheet and<index>is the page number of the barcode sheet relative to the input PDF. The page number is formatted as a three-digit page number (e.g., 001 or 023) unless the page number exceeds 999. Page numbering begins at one.Examplepdfxcb -r 0.2 0 1 0.3 -l 0 -d ./outputdir -f ./pdfxcb.log /path/to/scans.pdfInvoking with-rcauses the program to attempt to split prior to each page with a barcode in the specified page region. The arguments following the-rflag specify two points as x1 y1 x2 y2. The values are percentages (0 to 1.0) where (0,0) represents the top left corner of the page. These points define the scan region as a rectangle.The above example scans roughly the upper right third of each page in the input file,/path/to/scans.pdf. The output files are written to./outputdir. A log is generated at./pdfxcb.log.Split every N pagesExampleReads as input/input/file.pdfand splits after every 14 pages.pdfxcb -e 14 -d /path/output/dir /input/file.pdfInvoking from the shellUsepdfxcb --help.Invoking from within Python>>> pdfxcb.lg.getLogger().setLevel(pdfxcb.lg.DEBUG)

>>> pdfxcb.pdfxcb("/home/joejoe/src/pdfxcb/testing-sandbox/pdfxcb/test-doc-01/test-doc-01.pdf","/home/joejoe/src/pdfxcb/testing-sandbox/pdfxcb/test-doc-01/",None,False)LoggingA successful "run" should generate at least 3 log messages, each as a separate line in the log file: an initial log message (code 3), the results of analysis and burst/splitting (code 40), and a final log message (code 2).Example of log file content{"microsec": 229757, "message": "Initial log message", "code": 3, "id": "96f08ca4-1746-11e8-936f-9840bb275139", "time": 1519245258}
{"files": ["/tmp/123ABCabc-001.pdf", "/tmp/1234567890128-003.pdf"], "code": 40, "microsec": 402458, "time": 1520018355, "message": ["Analysis and burst completed"], "data": {"indices": [1, 3, 6], "barcodes": ["123ABCabc", "1234567890128"]}}
{"microsec": 791009, "message": "Scan and analysis complete", "code": 2, "time": 1519245261}