No description
Find a file
2015-06-14 21:49:47 +08:00
pyinvoice Fix service provider info title 2015-06-11 22:32:19 +08:00
tests Test item style 2015-06-11 22:29:16 +08:00
.gitignore add bottom tip 2015-06-10 00:53:08 +08:00
.travis.yml Exclude more 2015-06-10 01:25:24 +08:00
LICENSE MIT license 2015-06-10 20:42:53 +08:00
README.rst add simple usage 2015-06-14 21:49:47 +08:00
requirements-dev.txt setup.py 2015-06-08 23:15:36 +08:00
setup.py import setup from distutils.core if setutools package no installed 2015-06-11 11:26:09 +08:00

=========
PyInvoice
=========

.. image:: https://api.travis-ci.org/CiCiApp/PyInvoice.svg?branch=master
    :target: https://github.com/CiCiApp/PyInvoice

Invoice/Receipt Generator.

Dependency
----------
* Reportlab
* Python 2.6+/3.3+

+-------------------+-------------------+-------------------+-------------------+-------------------+
|                   | Python 2.6        | Python 2.7        | Python 3.3        | Python 3.4        |
+-------------------+-------------------+-------------------+-------------------+-------------------+
| Reportlab 2.6     | ✓                 | ✓                 |                   |                   |
+-------------------+-------------------+-------------------+-------------------+-------------------+
| Reportlab 2.7     | ✓                 | ✓                 |                   |                   |
+-------------------+-------------------+-------------------+-------------------+-------------------+
| Reportlab 3.0     |                   | ✓                 | ✓                 | ✓                 |
+-------------------+-------------------+-------------------+-------------------+-------------------+
| Reportlab 3.1.44  |                   | ✓                 | ✓                 | ✓                 |
+-------------------+-------------------+-------------------+-------------------+-------------------+
| Reportlab 3.2     |                   | ✓                 | ✓                 | ✓                 |
+-------------------+-------------------+-------------------+-------------------+-------------------+

Install
-------

.. code-block:: bash

    pip install pyinvoice

Usage
-----

.. code-block:: python

    from datetime import datetime, date
    from pyinvoice.models import InvoiceInfo, ServiceProviderInfo, ClientInfo, Item, Transaction
    from pyinvoice.templates import SimpleInvoice
    
    doc = SimpleInvoice('invoice.pdf')
    
    # Paid stamp, optional
    doc.is_paid = True
    
    doc.invoice_info = InvoiceInfo(1023, datetime.now(), datetime.now())  # Invoice info, optional
    
    # Service Provider Info, optional
    doc.service_provider_info = ServiceProviderInfo(
        name='PyInvoice',
        street='My Street',
        city='My City',
        state='My State',
        country='My Country',
        post_code='222222',
        vat_tax_number='Vat/Tax number'
    )
    
    # Client info, optional
    doc.client_info = ClientInfo(email='client@example.com')
    
    # Add Item
    doc.add_item(Item('Item', 'Item desc', 1, '1.1'))
    doc.add_item(Item('Item', 'Item desc', 2, '2.2'))
    doc.add_item(Item('Item', 'Item desc', 3, '3.3'))
    
    # Tax rate
    doc.set_item_tax_rate(20)  # 20%
    
    # Transactions detail, optional
    doc.add_transaction(Transaction('Paypal', 111, datetime.now(), 1))
    doc.add_transaction(Transaction('Strip', 222, date.today(), 2))
    
    # Optional
    doc.set_bottom_tip("Email: example@example.com<br />Don't hesitate to contact us for any questions.")
    
    doc.finish()


License
-------
MIT