Metadata-Version: 2.4
Name: future-healthcare
Version: 0.0.3
Summary: Python library and optional CLI for Future Healthcare
Author-email: Filipe Pina <shelf-corncob-said@duck.com>
Project-URL: Homepage, https://github.com/fopina/future-healthcare-cli
Requires-Python: <4,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2
Requires-Dist: requests>=2
Provides-Extra: cli
Requires-Dist: classyclick>=1.0.0; extra == "cli"
Requires-Dist: platformdirs>=4; extra == "cli"
Provides-Extra: vision
Requires-Dist: pillow>=10; extra == "vision"
Requires-Dist: openai>=1; extra == "vision"
Requires-Dist: pymupdf>=1.24; extra == "vision"
Dynamic: license-file

# future-healthcare-cli

[![ci](https://github.com/fopina/future-healthcare-cli/actions/workflows/publish-main.yml/badge.svg)](https://github.com/fopina/future-healthcare-cli/actions/workflows/publish-main.yml)
[![test](https://github.com/fopina/future-healthcare-cli/actions/workflows/test.yml/badge.svg)](https://github.com/fopina/future-healthcare-cli/actions/workflows/test.yml)
[![codecov](https://codecov.io/github/fopina/future-healthcare-cli/graph/badge.svg)](https://codecov.io/github/fopina/future-healthcare-cli)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/future-healthcare.svg)](https://pypi.org/project/future-healthcare/)
[![Current version on PyPI](https://img.shields.io/pypi/v/future-healthcare)](https://pypi.org/project/future-healthcare/)
[![Very popular](https://img.shields.io/pypi/dm/future-healthcare)](https://pypistats.org/packages/future-healthcare)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

Python library and optional CLI for Future Healthcare.

The CLI helps with common refund flows:

- `login` stores your API token locally
- `check` lists refund status/history
- `submit` submits a new expense with receipt metadata

## Install

Install the CLI with `uv`:

```bash
uv tool install 'future-healthcare[cli]'
```

This makes the `future-healthcare` command available on your system.

If you want receipt parsing via OCR / vision models as well:

```bash
uv tool install 'future-healthcare[cli,vision]'
```

## Run Without Installing

You can also run it directly with `uvx`:

```bash
uvx --from 'future-healthcare[cli]' future-healthcare --help
```

With vision support:

```bash
uvx --from 'future-healthcare[cli,vision]' future-healthcare submit --help
```

## Usage

Log in first:

```bash
future-healthcare login -u YOUR_USERNAME -p YOUR_PASSWORD
```

Check existing refunds:

```bash
future-healthcare check
```

Submit a receipt by passing the required fields explicitly:

```bash
future-healthcare submit ~/Downloads/example-receipt.pdf \
  --business-nif 509876543 \
  --invoice-number 'INV 2026/0001' \
  --total-amount 40 \
  --date '2026-03-14'
```

Or let the CLI extract those fields from the receipt with vision support:

```bash
future-healthcare submit ~/Downloads/example-receipt.pdf --vision
```

The `submit` command may prompt you to choose the insured person, service, or building when multiple matches are available.

## Local Data

The CLI stores local state under the platform-specific config directory for `future-healthcare-cli`, including:

- `token.txt` for the login token
- `config.toml` for CLI defaults
- `logs/` for submission logs and copied input files

## Development

See [CONTRIBUTING.md](CONTRIBUTING.md).
