Package: wpa-xhtml2pdf
XHTML2PDFThe current release of xhtml2pdf isxhtml2pdf 0.2.7. Release Notes can be found here:Release NotesAs with all open-source software, its use in production depends on many factors, so be aware that you may find issues in some cases.Big thanksto everyone who has worked on this project so far and to those who help maintain it.Aboutxhtml2pdf is a HTML to PDF converter using Python, the ReportLab Toolkit, html5lib and PyPDF3. It supports HTML5 and CSS 2.1 (and some of CSS 3). It is completely written in pure Python, so it is platform independent.The main benefit of this tool is that a user with web skills like HTML and CSS is able to generate PDF templates very quickly without learning new technologies.Please consider support this project usingPatreonor Bitcoins:bc1qmr0skzwx5scyvh2ql28f7gfh6l65ua250qv227DocumentationThe documentation of xhtml2pdf is available atRead the Docs.And we could use your help improving it! A good place to start isdoc/source/usage.rst.InstallationThis is a typical Python library and can be installed using pip:pip install wpa-xhtml2pdfRequirementsOnly Python 3.7+ is tested and guaranteed to work.All additional requirements are listed in therequirements.txtfile and are installed automatically using thepip install xhtml2pdfmethod.AlternativesYou can tryWeasyPrint. The codebase is pretty, it has different features and it does a lot of what xhtml2pdf does.Call for testingThis project is heavily dependent on getting its test coverage up! Furthermore, parts of the codebase could do well with cleanups and refactoring.If you benefit from xhtml2pdf, perhaps look at thetest coverageand identify parts that are yet untouched.Development environmentIf you don’t have it, installpip, the python package installer:sudo easy_install pipFor more information aboutpiprefer tohttp://www.pip-installer.orgWe will recommend usingvirtualenvfor development.Create a virtualenv for the project. This can be inside the project directory, but cannot be under version control:python -m venv xhtml2pdfenvActivate your virtualenv:source xhtml2pdfenv/bin/activateLater to deactivate it use:deactivateThe next step will be to install/upgrade dependencies from therequirements.txtfile:pip install -r requirements.txtRun tests to check your configuration:nosetests --with-coverageYou should have a log with the following success status:Ran 167 tests in 34.585s

OKPython integrationSome simple demos of how to integrate xhtml2pdf into a Python program may be found here:test/simple.pyRunning testsTwo different test suites are available to assert that xhtml2pdf works reliably:Unit tests. The unit testing framework is currently minimal, but is being
improved on a regular basis (contributions welcome). They should run in the
expected way for Python’s unittest module, i.e.:nosetests --with-coverage (or your personal favorite)Functional tests. Thanks to mawe42’s super cool work, a full functional
test suite is available attestrender/.You can run them using makemaketest# run nosetestmaketest-ref# generate reference data for testrendermaketest-all# Run all test using toxContactThis project is community-led! Feel free to open up issues on GitHub about new ideas to improve xhtml2pdf.HistoryThese are the major milestones and the maintainers of the project:2000-2007, commercial project, spirito.de, written by Dirk Holtwich2007-2010 Dirk Holtwich (project named “Pisa”, project released as GPL)2010-2012 Dirk Holtwick (project named “xhtml2pdf”, changed license to Apache)2012-2015 Chris Glass (@chrisglass)2015-2016 Benjamin Bach (@benjaoming)2016-2018 Sam Spencer (@LegoStormtroopr)2018-Current Luis Zarate (@luisza)For more history, see theCHANGELOG.txtfile.LicenseCopyright 2010 Dirk Holtwick, holtwick.itLicensed under the Apache License, Version 2.0 (the “License”);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at:http://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an “AS IS” BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.