Metadata-Version: 2.1
Name: capital-gains
Version: 1.0.3
Summary: Capital gains calculator
Home-page: https://github.com/nkouevda/capital-gains
Author: Nikita Kouevda
Author-email: nkouevda@gmail.com
License: MIT
Platform: UNKNOWN
Description-Content-Type: text/markdown

# capital-gains

Capital gains calculator.

## Installation

    pip install capital-gains

## Usage

```
usage: capital-gains [<options>] [--] <input file>

Capital gains calculator

optional arguments:
  -h, --help            show this help message and exit
  -d <n>, --decimal-places <n>
                        round $ to <n> decimal places; default: 0
  -s <n>, --shares-decimal-places <n>
                        round shares to <n> decimal places; default: 0
  -t, --totals          output totals
  -v, --verbose         verbose output
  -V, --version         show program's version number and exit
```

## Input Format

See [example/input.csv](example/input.csv).

Each entry has the following format:

    date,symbol,name,shares,price,fee

Buys have positive `shares`; sells have negative `shares`. `price` and `fee` are
always positive. `fee` and `name` are optional. A sell without a `name` will
sell all open lots FIFO; a sell with a `name` will only sell lots with the same
`name`. Thus `name` can be used to specify sell orders other than FIFO.

## Output Format

Closed lots are tabulated in a format suitable for [IRS form
8949](https://www.irs.gov/pub/irs-pdf/f8949.pdf), rounded to the nearest dollar
(use `-d 2` to round to the nearest cent).

Open lots, and optionally totals for both closed and open lots (use `-t`), are
also summarized.

## Examples

    capital-gains -t example/input.csv > example/output.txt

## License

[MIT License](LICENSE.txt)


