"Fossies" - the Fresh Open Source Software Archive

Member "xhtml2pdf-0.2.8/PKG-INFO" (16 Jun 2022, 7383 Bytes) of package /linux/www/xhtml2pdf-0.2.8.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "PKG-INFO": 0.2.7_vs_0.2.8.

    1 Metadata-Version: 2.1
    2 Name: xhtml2pdf
    3 Version: 0.2.8
    4 Summary: PDF generator using HTML and CSS
    5 Home-page: http://github.com/xhtml2pdf/xhtml2pdf
    6 Author: Dirk Holtwick
    7 Maintainer: Luis Zarate
    8 Maintainer-email: luisza14@gmail.com
    9 License: Apache License 2.0
   10 Keywords: PDF,HTML,XHTML,XML,CSS
   11 Platform: UNKNOWN
   12 Classifier: License :: OSI Approved :: Apache Software License
   13 Classifier: Development Status :: 4 - Beta
   14 Classifier: Environment :: Console
   15 Classifier: Environment :: Other Environment
   16 Classifier: Intended Audience :: Developers
   17 Classifier: Intended Audience :: System Administrators
   18 Classifier: Natural Language :: English
   19 Classifier: Operating System :: OS Independent
   20 Classifier: Programming Language :: Python :: 3
   21 Classifier: Programming Language :: Python :: 3.6
   22 Classifier: Programming Language :: Python :: 3.7
   23 Classifier: Programming Language :: Python :: 3.8
   24 Classifier: Programming Language :: Python :: 3.9
   25 Classifier: Programming Language :: Python :: 3.10
   26 Classifier: Topic :: Documentation
   27 Classifier: Topic :: Multimedia
   28 Classifier: Topic :: Office/Business
   29 Classifier: Topic :: Printing
   30 Classifier: Topic :: Text Processing
   31 Classifier: Topic :: Text Processing :: Filters
   32 Classifier: Topic :: Text Processing :: Fonts
   33 Classifier: Topic :: Text Processing :: General
   34 Classifier: Topic :: Text Processing :: Indexing
   35 Classifier: Topic :: Text Processing :: Markup
   36 Classifier: Topic :: Text Processing :: Markup :: HTML
   37 Classifier: Topic :: Text Processing :: Markup :: XML
   38 Classifier: Topic :: Utilities
   39 License-File: LICENSE.txt
   40 License-File: AUTHORS.rst
   41 
   42 XHTML2PDF
   43 =========
   44 
   45 .. image:: https://img.shields.io/pypi/v/xhtml2pdf?label=PyPI&logo=PyPI&logoColor=white&color=blue
   46     :target: https://pypi.python.org/pypi/xhtml2pdf
   47     :alt: PyPI version
   48 
   49 .. image:: https://img.shields.io/pypi/pyversions/xhtml2pdf?label=Python&logo=Python&logoColor=white
   50     :target: https://www.python.org/downloads
   51     :alt: Python versions
   52 
   53 .. image:: https://img.shields.io/coveralls/github/xhtml2pdf/xhtml2pdf?label=Coveralls&logo=Coveralls&logoColor=white
   54     :target: https://coveralls.io/github/xhtml2pdf/xhtml2pdf
   55     :alt: Coveralls
   56 
   57 .. image:: https://img.shields.io/readthedocs/xhtml2pdf?label=Read%20the%20Docs&logo=read%20the%20docs&logoColor=white
   58    :target: http://xhtml2pdf.readthedocs.io/en/latest/?badge=latest
   59    :alt: Read the Docs
   60 
   61 |
   62 
   63 The current release of xhtml2pdf is **xhtml2pdf 0.2.7**. Release Notes can be found here: `Release Notes <https://xhtml2pdf.readthedocs.io/en/latest/release-notes.html>`__
   64 As with all open-source software, its use in production depends on many factors, so be aware that you may find issues in some cases.
   65 
   66 **Big thanks** to everyone who has worked on this project so far and to those who help maintain it.
   67 
   68 About
   69 =====
   70 
   71 xhtml2pdf 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.
   72 
   73 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.
   74 
   75 Please consider support this project using `Patreon <https://www.patreon.com/xhtml2pdf>`__ or Bitcoins: ``bc1qmr0skzwx5scyvh2ql28f7gfh6l65ua250qv227``
   76 
   77 
   78 
   79 Documentation
   80 ==============
   81 
   82 The documentation of xhtml2pdf is available at `Read the Docs <http://xhtml2pdf.readthedocs.io>`__.
   83 
   84 And we could use your help improving it! A good place to start is ``doc/source/usage.rst``.
   85 
   86 
   87 Installation
   88 ============
   89 
   90 This is a typical Python library and can be installed using pip::
   91 
   92     pip install xhtml2pdf
   93 
   94 
   95 Requirements
   96 ============
   97 
   98 Only Python 3.7+ is tested and guaranteed to work.
   99 
  100 All additional requirements are listed in the ``requirements.txt`` file and are installed automatically using the ``pip install xhtml2pdf`` method.
  101 
  102 
  103 Alternatives
  104 ==============================
  105 
  106 You can try `WeasyPrint <http://weasyprint.org>`__. The codebase is pretty, it has different features and it does a lot of what xhtml2pdf does.
  107 
  108 
  109 Call for testing
  110 ================
  111 
  112 This project is heavily dependent on getting its test coverage up! Furthermore, parts of the codebase could do well with cleanups and refactoring.
  113 
  114 If you benefit from xhtml2pdf, perhaps look at the `test coverage <https://coveralls.io/github/xhtml2pdf/xhtml2pdf>`__ and identify parts that are yet untouched.
  115 
  116 
  117 Development environment
  118 =======================
  119 
  120 #. If you don't have it, install ``pip``, the python package installer::
  121 
  122     sudo easy_install pip
  123 
  124    For more information about ``pip`` refer to http://www.pip-installer.org
  125 
  126 #. We will recommend using ``virtualenv`` for development.
  127 
  128 #. Create a virtualenv for the project. This can be inside the project directory, but cannot be under version control::
  129 
  130     python -m venv xhtml2pdfenv
  131 
  132 #. Activate your virtualenv::
  133 
  134     source xhtml2pdfenv/bin/activate
  135 
  136    Later to deactivate it use::
  137 
  138     deactivate
  139 
  140 #. The next step will be to install/upgrade dependencies from the ``requirements.txt`` file::
  141 
  142     pip install -r requirements.txt
  143 
  144 #. Run tests to check your configuration::
  145 
  146     nosetests --with-coverage
  147 
  148    You should have a log with the following success status::
  149 
  150     Ran 167 tests in 34.585s
  151 
  152     OK
  153 
  154 
  155 Python integration
  156 ==================
  157 
  158 Some simple demos of how to integrate xhtml2pdf into a Python program may be found here: ``test/simple.py``
  159 
  160 
  161 Running tests
  162 =============
  163 
  164 Two different test suites are available to assert that xhtml2pdf works reliably:
  165 
  166 #. Unit tests. The unit testing framework is currently minimal, but is being
  167    improved on a regular basis (contributions welcome). They should run in the
  168    expected way for Python's unittest module, i.e.::
  169 
  170         nosetests --with-coverage (or your personal favorite)
  171 
  172 #. Functional tests. Thanks to mawe42's super cool work, a full functional
  173    test suite is available at ``testrender/``.
  174 
  175 You can run them using make
  176 
  177 .. code:: bash
  178 
  179         make test       # run nosetest
  180         make test-ref   # generate reference data for testrender
  181         make test-all   # Run all test using tox
  182 
  183 Contact
  184 =======
  185 
  186 This project is community-led! Feel free to open up issues on GitHub about new ideas to improve xhtml2pdf.
  187 
  188 
  189 History
  190 =======
  191 
  192 These are the major milestones and the maintainers of the project:
  193 
  194 * 2000-2007, commercial project, spirito.de, written by Dirk Holtwich
  195 * 2007-2010 Dirk Holtwich (project named "Pisa", project released as GPL)
  196 * 2010-2012 Dirk Holtwick (project named "xhtml2pdf", changed license to Apache)
  197 * 2012-2015 Chris Glass (@chrisglass)
  198 * 2015-2016 Benjamin Bach (@benjaoming)
  199 * 2016-2018 Sam Spencer (@LegoStormtroopr)
  200 * 2018-Current Luis Zarate (@luisza) 
  201 
  202 For more history, see the ``CHANGELOG.txt`` file.
  203 
  204 License
  205 =======
  206 
  207 Copyright 2010 Dirk Holtwick, holtwick.it
  208 
  209 Licensed under the Apache License, Version 2.0 (the "License");
  210 you may not use this file except in compliance with the License.
  211 You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0
  212 
  213 Unless required by applicable law or agreed to in writing, software
  214 distributed under the License is distributed on an "AS IS" BASIS,
  215 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  216 See the License for the specific language governing permissions and
  217 limitations under the License.
  218 
  219