"Fossies" - the Fresh Open Source Software Archive

Member "xhtml2pdf-0.2.5/PKG-INFO" (8 Oct 2020, 9128 Bytes) of package /linux/www/xhtml2pdf-0.2.5.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.4_vs_0.2.5.

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