Metadata-Version: 2.1
Name: infoicer
Version: 0.0.1
Summary: Infoicer is a simple invoice items handler.
Home-page: https://github.com/edkirin/infoicer
Author: Eden Kirin
Author-email: edkirin@gmail.com
License: MIT
Keywords: invoice
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# infoicer
Infoicer is a simple invoice items handler. It can group items by type and tax rate which helps in building the invoice for a customer.

## Features

- All price handling is utilized with `Decimal` type to avoid float rounding problems
- Easy to group invoice items by type and tax rate
- Implemented object serialization
- No external dependencies

## Installation

From PyPi:

```bash
$ pip install infoicer
```

or clone repository:

```bash
$ git clone git@github.com:edkirin/infoicer.git
```

## Basic usage

```python
from infoicer import Invoice, InvoiceItem
from decimal import Decimal

invoice = Invoice()

invoice.add(InvoiceItem(
    name="Ham",
    item_type='food',
    price=Decimal(10),
    qty=1,
    tax_rate=Decimal(5),
))

invoice.add(InvoiceItem(
    name="Spam",
    item_type='food',
    price=Decimal(15),
    qty=3,
    tax_rate=Decimal(5),
))

print(invoice.serialize(json_output=True))
```

output:

```json
{
   "items":[
      {
         "item_type":"food",
         "qty":1,
         "name":"Ham",
         "price":10.0,
         "net_price":9.52,
         "tax_rate":5.0,
         "sum":10.0,
         "net_sum":9.52,
         "tax_sum":0.48
      },
      {
         "item_type":"food",
         "qty":3,
         "name":"Spam",
         "price":15.0,
         "net_price":14.29,
         "tax_rate":5.0,
         "sum":45.0,
         "net_sum":42.87,
         "tax_sum":2.13
      }
   ],
   "total":{
      "price":55.0,
      "net":52.39,
      "tax":2.61
   }
}
```

## Full demo

Check included [demo.py](https://github.com/edkirin/infoicer/blob/master/demo.py) for some more uses and features.

## Licence

The code is available under MIT Licence.

