An open API service indexing awesome lists of open source software.

https://github.com/suda/stereo

Generate PDF documents in batch
https://github.com/suda/stereo

Last synced: about 1 year ago
JSON representation

Generate PDF documents in batch

Awesome Lists containing this project

README

          

# ![](artwork/logo.png) Stereo

### Generate PDF documents in batch.

Make badges, labels, invitations, invoices documents from CSV files or any dataset.

[![Build Status](https://travis-ci.org/suda/stereo.svg?branch=master)](https://travis-ci.org/suda/stereo)
[![Documentation Status](https://readthedocs.org/projects/stereo/badge/?version=latest)](http://stereo.readthedocs.org/en/latest/?badge=latest)
[![PyPI version](https://badge.fury.io/py/stereo.svg)](https://badge.fury.io/py/stereo)
[![Gitter](https://badges.gitter.im/suda/stereo.svg)](https://gitter.im/suda/stereo?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

# Usage

## **Scenario A:** I have a CSV file and need to generate a lot of similar PDFs

Quickest way would be to [use Stereo's command line](http://stereo.readthedocs.org/en/latest/generating-from-csv/).

## **Scenario B:** My Python application needs to generate simple PDFs

In this case it would be the best to [use Stereo programmatically](http://stereo.readthedocs.org/en/latest/generating-using-code/). This can be done in web server (using i.e. Django or Flask) and in desktop apps too.

## Documentation

Whole usage and API reference is available at [http://stereo.readthedocs.org](http://stereo.readthedocs.org/en/latest/)

# Examples

You can find example code in [`examples` directory](examples).

# [Contributions welcome](http://contributionswelcome.org/)

All contributions (no matter if small) are always welcome.

To see how you can help and where to start [see Contributing file](CONTRIBUTING.md).

# Acknowledgements

* Project based on [Django Under The Hood's badges generator](https://github.com/djangounderthehood/badges) originally by [Ola Sitarska](https://github.com/olasitarska) and [Kuba Kucharski](https://github.com/83tb)
* Icon from [Elegant Themes Line Icons](https://www.elegantthemes.com/blog/freebie-of-the-week/free-line-style-icons).
* Layout import based on [Scrapy](https://github.com/scrapy/scrapy) `runspider` command.