Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

A SVG and LateX template renderer from table data based on Inkscape and Jinja2.

Project description

.. -*- mode: rst -*-

|Python27|_ |Python35|_ |PyPi|_

.. |Python27| image:: https://img.shields.io/badge/python-2.7-blue.svg
.. _Python27: https://badge.fury.io/py/docstamp

.. |Python35| image:: https://img.shields.io/badge/python-3.5-blue.svg
.. _Python35: https://badge.fury.io/py/docstamp

.. |PyPi| image:: https://badge.fury.io/py/docstamp.svg
.. _PyPi: https://badge.fury.io/py/docstamp

docstamp
========

Initially it was a conference badge creator based on SVG templates (https://github.com/PythonSanSebastian/pydger), but we thought
it could be more generic and have many other applications.

DocStamp is a generic template renderer which takes the data from a .CSV file or a Google Spreadsheet and creates
one rendered template file for each row of the data.

It is PDF centric, however it can also export in some cases to PNG.

It needs:

- Inkscape or rsvg-convert for .SVG templates, and
- PDFLateX or XeLateX for LateX templates.


CLI Usage
---------

The CSV header fields must match the ones in the template file.::

docstamp create -i badge.csv -t badge_template.svg -o badges

Installation
------------
To install the development version::

pip install git+https://www.github.com/PythonSanSebastian/docstamp.git

To install the latest release::

pip install docstamp


Requirements
------------

See `requirements.txt` file. Also you will need Inkscape, XeLatex, or PDFLatex
installed in your system.

For unicode support in SVG exports, you need to install `rsvg-convert`, which is available in `librsvg-bin`.


Compatibility
-------------
DocStamp is compatible with Python 2 (we wish to believe) and 3.
We could not test it on Windows.


License
-------
New BSD license

Authors
-------
Alexandre M. Savio @alexsavio


Contributors
------------

Oier Etxaniz @oechaniz

Luis Javier Salvatierra @ljsalvatierra

Haseeb Majid

Changelog
=========

Version 0.4.3 (10.10.2018)
--------------------------
- Fixed bug to correctly call `rsvg-convert`.


Version 0.4.2 (09.10.2018)
--------------------------
- Fixed bug to find the default path to `rsvg-convert`.

Version 0.4.1
-------------
- Fixed bugs in unicode support.
- Removed support for Google spreadsheets.

Version 0.4.0 by Haseeb Majid
-------------
- Added support for unicode in PDFs.
- Fixed small typos.
- Removed `flag_value` from click.options.

Version 0.3.5
-------------
- Code style fixes.
- setup.py now uses requirements.txt file to pick dependencies.
- Fixed the Makefile.

Version 0.3.4
-------------
- Bugfixes.

Version 0.3.3
-------------
- Moved CLI to click.

Previous versions
-----------------
- Lost in History...

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
docstamp-0.4.3.tar.gz (21.1 kB) Copy SHA256 hash SHA256 Source None Oct 9, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page