Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sameerkumar18/pdfgeneratorapi-python
PDFGeneratorAPI Python Wrapper
https://github.com/sameerkumar18/pdfgeneratorapi-python
package pdf-document pdf-files pdf-generation pdf-merger pip python-library python3 wrapper-library
Last synced: about 1 month ago
JSON representation
PDFGeneratorAPI Python Wrapper
- Host: GitHub
- URL: https://github.com/sameerkumar18/pdfgeneratorapi-python
- Owner: sameerkumar18
- License: apache-2.0
- Created: 2019-05-18T19:23:51.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-04T09:32:12.000Z (about 5 years ago)
- Last Synced: 2024-12-06T18:58:15.781Z (about 2 months ago)
- Topics: package, pdf-document, pdf-files, pdf-generation, pdf-merger, pip, python-library, python3, wrapper-library
- Language: Python
- Homepage: https://pypi.org/project/pdfgeneratorapi/
- Size: 60.5 KB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[logo]: https://logo.clearbit.com/pdfgeneratorapi.com/ "PDFGeneratorAPI.com Python Wrapper Logo"
![alt text][logo] PDFGeneratorAPI.com Python wrapper
====================================================
[](https://badge.fury.io/py/pdfgeneratorapi)
[](https://travis-ci.org/sameerkumar18/pdfgeneratorapi-python)
[](https://pypi.org/project/pdfgeneratorapi/)
[](https://pypi.org/project/pdfgeneratorapi/)
[](https://saythanks.io/to/sameerkumar18)
[](https://www.paypal.me/sameerkumar18)
With the PDF Generator API your users can easily create and manage different document templates with an easy-to-use browser based document editor and via API.
An API and template builder to generate PDF documents from Your software, from Your data.
You will first need to [register for a PDFGeneratorAPI account](https://pdfgeneratorapi.com/signup) to use this API. It's free to sign up, and use for testing and integration process.
Installation
------------
Supports Python 3+
To install, simply use pip
```
$ sudo pip install pdfgeneratorapi
✨🍰✨
```
Usage
-----
```python
>>> from pdfgeneratorapi import PDFGenerator
>>> pdf_client = PDFGenerator(api_key='', api_secret='')
>>> pdf_client.set_workspace('')
```
You can pass the `api_key`, `api_secret` and `workspace` explicitly. Alternatively, declare these environment variables `PDF_GENERATOR_KEY`, `PDF_GENERATOR_SECRET`.
For wrapper usage code snippets please check examples.py
#### Features
```python
>>> from pdfgeneratorapi import PDFGenerator
>>> pdf_client = PDFGenerator(api_key='', api_secret='')
>>> pdf_client.set_workspace('')
```
##### Generate a new Document
```python
>>> new_pdf = pdf_client.create_document(template_id=48484, data={"name": "Sameer Kumar"}, document_format="pdf", response_format="url")
>>> new_pdf.response
'https://us1.pdfgeneratorapi.com/share/5434/ce2fc41de8e51fc7db2cbc1700075a92'
```
##### Fetch All Templates
```python
>>> templates = pdf_client.all_templates(tags=['test_tag'], access=['private'])
>>> templates[0].id
1234
>>> templates[0].name
'Some name'
```
##### Get template by ID
```python
>>> template = pdf_client.get_template(template_id=)
>>> template.layout.format
'A4'
```
##### Create a new template
```python
>>> new_template = pdf_client.create_template(name='')
>>> new_template.id
24386
>>> new_template.name
'My new template'
```
##### Create a copy of a given template
```python
>>> copy_template = pdf_client.create_template_copy(template_id=48484, name="Copied template")
>>> copy_template.layout.format
'A4'
```
##### Get a one-click link to web editor
```python
>>> editor_url = pdf_client.get_editor_url(template_id=48484, data={"name": "Sameer"})
'https://us1.pdfgeneratorapi.com/api/v3/templates/19375/editor?key=61e5f04ca1794253ed17e6bb986c1702&[email protected]&signature=75d7c8fb0c06942da2bf76422f1a79eb72cada6d7ab07f7a7d0eaf8d510897d9&data=https://myawesomeapp.com/data/9129381823.json'
```
###### Extra Feature
All PDFGeneratorResponse objects have two extra attributes:
1) `to_json`: Returns the API response in raw JSON format.
2) `to_dict`: Returns the API response in python dict format.
Tests
-----
Set the following environment variable:
1. `PDF_GENERATOR_KEY`
2. `PDF_GENERATOR_SECRET`
3. `PDF_GENERATOR_WORKSPACE`
Run the test with the following command:
```
$ python setup.py test
```
## Default Values
You can explicitly override certain default assumptions like -
- Authentication: Signature Authentication. To use Simple Authentication, simple pass `signature_auth=False` in the object init.
- API URL: `https://.pdfgeneratorapi.com/api//` . To override - `api_url=''`.
- API Key: `api_key`. Default loads from environment var `PDF_GENERATOR_KEY`
- API Secret: `api_secret`. Default loads from environment var `PDF_GENERATOR_SECRET`
- Workspace: `workspace`. Default loads from environment var `PDF_GENERATOR_WORKSPACE`
- API Region: `api_region`. Default - "us1"
- API Version: `api_version`. Default - "v3"
- Document Format: `document_format`. Default - "pdf"
- Response Format: `response_format`. Default - "base64"
## Documentation
Please see [https://docs.pdfgeneratorapi.com/](https://docs.pdfgeneratorapi.com/) for complete up-to-date documentation.
## About PDFGeneratorAPI.com
PDF Generator API is a RESTful API and a template builder for creating PDF documents from Your software, from Your data. With PDF Generator API you can allow your users to create and manage different document templates with an easy-to-use browser based document editor. And you can merge templates with data from your own software via RESTful API to generate PDF and HTML documents.
## Support
If you have any API related query/issue please contact [email protected]
For any wrapper related query/issue, please raise a GitHub issue.
## About Author
[Sameer Kumar](https://www.sameerkumar.website/)
Find me on [Twitter](https://twitter.com/sameer_kumar018)