Skip to main content

Monz

PyPI version Python versions License

Build status Test coverage

Simple command line interface for quickly accessing your Monzo account info, current balance, latest transactions, etc.

I don’t know exactly where will this project go next so all feature requests and suggestions are more then welcome.

Worth mentioning - it currently suffers from the same issue that the underlying pymonzo package suffers, which is the short lifespan of access tokens. It makes using it daily a bit of a hassle as you need to change it every couple of hours, but I plan to fix in the near future.

Installation

>From PyPI:

$ pip install monz

Usage

To use the script you have to provide it with you Monzo access token. You can either do that by exporting it as an environment variable ($ export MONZO_ACCESS_TOKEN='...') or by passing it explicitly with each command.

$ monz --help
Usage: monz [OPTIONS] COMMAND [ARGS]...

  Simple command line interface for quickly accessing your Monzo account
  info, current balance, latest transactions, etc.

  To use it you need to save your Monzo access token as 'MONZO_ACCESS_TOKEN'
  environment variable (export MOZNO_ACCESS_TOKEN='...') or pass it
  explicitly with each command.

Options:
  -t, --access-token TEXT  Monzo API access token.
  --help                   Show this message and exit.

Commands:
  accounts      Show connected Monzo accounts
  balance       Show Monzo account balance
  transactions  Show Monzo account transactions

Examples

You can view your linked accounts:

$ monz accounts
Account #1, Bender Rodríguez
ID:          acc_2716057
Created:     Dec 31, 2999 11:59 PM

If you have only one then it will become the default one, but if you have more then you have to pass it’s ID explicitly to the rest of the commands.

You can view your current balance, which is also the default subcommand:

$ monz
Balance:     £17.29
Spent today: £0.00

$ monz balance
Balance:     £17.29
Spent today: £0.00

Lastly, you can see your latest transactions:

$ monz transactions -n 2
-£50.00 at Robot Arms Apartments (New New York)
Category:    Bills
Date:        Nov 18, 3016 11:09 PM

-£50.00 at Fronty's Meat Market (New New York)
Category:    Grocieries
Date:        Nov 17, 3016 8:31 AM

Tests

Package was tested with the help of py.test and tox on Python 2.7, 3.4 and 3.5 (see tox.ini).

To run tests yourself you need to set environment variables with access token before running tox inside the repository:

$ export MONZO_ACCESS_TOKEN='...'
$ tox

Contributions

Package source code is available at GitHub.

Feel free to use, ask, fork, star, report bugs, fix them, suggest enhancements, add functionality and point out any mistakes.

Authors

Developed and maintained by Paweł Adamczak.

Released under MIT License.

Metadata

Release files for monz 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for monz 0.1.0
File Size Uploaded Provenance Actions
monz-0.1.0.tar.gz 7.4 kB Without provenance Details for monz-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for monz 0.1.0
File Interpreter ABI Platform Actions
monz-0.1.0-py2.py3-none-any.whl Python 3, Python 2 none any Details for monz-0.1.0-py2.py3-none-any.whl

Total release size: 16.8 kB

Release files / monz-0.1.0.tar.gz

Download URL monz-0.1.0.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c89a1e1802caead89337de23c436f2ce8b6b16854dc4423384396ce62cfa3b4c
BLAKE2b-256 checksum
How to use checksums
2bbbc008575a1e26a0054ce4e73432e70336c5d589750511f71898b4121cf9a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / monz-0.1.0-py2.py3-none-any.whl

Download URL monz-0.1.0-py2.py3-none-any.whl
Size 9.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
4f920db1332f87c99bf9b4ca64bb18dcd035538617f6f98d859ff7a5476835ee
BLAKE2b-256 checksum
How to use checksums
b6d59ae5f835d3d877cf17fd77cf21a20315b716f2865fa9b25c34d3b279bb75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for monz 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page