Metadata-Version: 1.1
Name: pypdftk
Version: 0.3
Summary: Python wrapper for PDFTK
Home-page: http://github.com/revolunet/pypdftk
Author: Julien Bouquillon
Author-email: julien@revolunet.com
License: UNKNOWN
Description: pypdftk
        ========
        
        Python module to drive the awesome [pdftk][0] binary.
        
        Proudly brought to you by the [revolunet][1] team
        
        ## Features
        
        ### `fill_form`
        Fill a PDF with given data and returns the output PDF path
         - `pdf_path` : input PDF
         - `datas` : dictionnary of fielf names / values
         - `out_file` (default=auto) : output PDF path. will use tempfile if not provided
         - `flatten` (default=True) : flatten the final PDF
         
        ### `concat`
        Merge multiple PDFs into one single file and returns the output PDF path
         - `files` : list of PDF files to concatenate
         - `out_file` (default=auto) : output PDF path. will use tempfile if not provided
        
        ### `split`
        Split a single PDF in many pages and return a list of pages paths
         - `pdf_path` : input PDF
         - `out_dir` (default=auto) : output PDFs dir. will use tempfile if not provided
        
        **warning** if you give a out_dir parameter, ensure its empty, or the split function may destroy your files and return incorrect results.
        
        ### `gen_xfdf`
        Generate a XFDF file suited for filling PDF forms and return the generated XFDF file path
         - `datas` : dictionnary of datas
         
        ### `get_num_pages`
        Return the number of pages for a given PDF
         - `pdf_path` : input PDF file
        
        
        
        
        ## Example
        
        Fill a PDF model and add a cover page :
        
        ```python
        
        import pypdftk
        
        datas = {
            'firstname': 'Julien',
            'company': 'revolunet',
            'price': 42
        }
        generated_pdf = pypdftk.fill_form('/path/to/model.pdf', datas)
        out_pdf = pypdftk.merge(['/path/to/cover.pdf', generated_pdf])
        ```
        
        
        
        ## Licence
        This module is released under the permissive [MIT license](http://revolunet.mit-license.org). Your contributions are always welcome.
        
        
         [0]: http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/
         [1]: http://revolunet.com
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Utilities
