An application for generating receipt details of shopping baskets

• Python 3.7+

The application was only tested on Windows, but should work on other OS as well. If using a different OS than Windows, some of the commands for installation may differ.

This installation guide is written for Windows and assumes that the commands are excuted inside a powershell. For other OS use the corresponding commands.

git clone https://github.com/marcelhohn/receipt.git

chdir receipt

This assumes python is in your PATH.

python -m venv env
.\env\Scripts\Activate.ps1

For other commands for activating the virtual environment depending on your platform and shell see the python doumentation on venv.

pip install .

Run the application from anywhere on your system via

receipt input

where input is the path to the input file.

Assume we are in the same directory as the file input.txt, which has the following content:

1 book at 12.49
1 music CD at 14.99
1 chocolate bar at 0.85

Then running the application prints out the receipt details to the console:

> receipt input.txt
1 book: 12.49
1 music CD: 16.49
1 chocolate bar: 0.85
Sales Taxes: 1.50
Total: 29.83

The application handles only one input file at once. The input file is expected to consist of multiple lines, one line for each item. Each line is expected to contain the following information in the following order:

• An integer number indicating the quantity of that item
• A description containing the name of the item and the word "imported" (anywhere in the description), if (and only if) the item is imported
• The word "at"
• A number with two decimals and a dot (".") as decimal separator indicating the shelf price for all units of that item (e.g. the line "2 books at 20.00" means that both books together have a shelf price of 20.00)

Each of the above contents are separated with exactly one space character.

Create and activate a virtual environment as explained above.

Install the package and its dependencies:

pip install -e .[dev] 

python -m unittest