# Tarsnap Status Monitor Reporting Tool
[](https://raw.githubusercontent.com/rstms/tsmtool/master/LICENSE)
[](https://pypi.org/project/tsmtool/)
[](https://app.circleci.com/pipelines/github/rstms/tsmtool?branch=master&filter=all)
[](http://tsmtool.readthedocs.io/)
[](https://pyup.io/account/repos/github/rstms/tsmtool/)
Tarsnap Status Monitor
## Introduction
The most excellent backup service [Tarsnap](https://www.tarsnap.com) provides a clean
and functional interface for managing one's account. This tool connects to that web
interface and queries data, producing a report as a table or JSON. The current balance is
read, and an estimated monthly cost is calculated based on the site's daily cost data.
### Example Output
Here's an example of output from the author's tarsnap account:
```
(tsmtool) mkrueger@beaker:~/src/tsmtool$ tsmtool --json rstms
{
"balance": 32.51,
"account": "mkrueger@rstms.net",
"monthly_cost": 23.51
}
```
## Configuration
A config file may be used for account data, or the email account / password may be passed as command line options.
The config file is a whitespace delimited text file with one line per account.
Each line has these fields:
`~/.tsmtool`:
```
ACCOUNT_NAME EMAIL_ADDRESS PASSWORD
```
* Free software: MIT license
* Documentation: https://tsmtool.readthedocs.io.
## Credits
[Tarsnap](https://www.tarsnap.com)
This package was created with Cookiecutter and `rstms/cookiecutter-python-cli`, a fork of the `audreyr/cookiecutter-pypackage` project template.
[audreyr/cookiecutter](https://github.com/audreyr/cookiecutter)
[audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage)
[rstms/cookiecutter-python-cli](https://github.com/rstms/cookiecutter-python-cli)
```
```
Raw data
{
"_id": null,
"home_page": null,
"name": "tsmtool",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "tsmtool",
"author": null,
"author_email": "Matt Krueger <mkrueger@rstms.net>",
"download_url": "https://files.pythonhosted.org/packages/a2/54/ef965d0bb8fc92f43bd01c3c5fe67a9598e469ef08be11a62df7cb872ed0/tsmtool-1.2.7.tar.gz",
"platform": null,
"description": "# Tarsnap Status Monitor Reporting Tool\n\n\n[](https://raw.githubusercontent.com/rstms/tsmtool/master/LICENSE)\n\n[](https://pypi.org/project/tsmtool/)\n\n[](https://app.circleci.com/pipelines/github/rstms/tsmtool?branch=master&filter=all)\n\n[](http://tsmtool.readthedocs.io/)\n\n[](https://pyup.io/account/repos/github/rstms/tsmtool/)\n\nTarsnap Status Monitor\n\n## Introduction \nThe most excellent backup service [Tarsnap](https://www.tarsnap.com) provides a clean\nand functional interface for managing one's account. This tool connects to that web\ninterface and queries data, producing a report as a table or JSON. The current balance is\nread, and an estimated monthly cost is calculated based on the site's daily cost data.\n\n### Example Output\nHere's an example of output from the author's tarsnap account:\n```\n(tsmtool) mkrueger@beaker:~/src/tsmtool$ tsmtool --json rstms\n{\n \"balance\": 32.51,\n \"account\": \"mkrueger@rstms.net\",\n \"monthly_cost\": 23.51\n}\n```\n\n## Configuration \nA config file may be used for account data, or the email account / password may be passed as command line options.\nThe config file is a whitespace delimited text file with one line per account.\nEach line has these fields:\n\n`~/.tsmtool`: \n```\nACCOUNT_NAME EMAIL_ADDRESS PASSWORD\n```\n\n* Free software: MIT license\n* Documentation: https://tsmtool.readthedocs.io.\n\n\n\n## Credits\n\n[Tarsnap](https://www.tarsnap.com) \n\nThis package was created with Cookiecutter and `rstms/cookiecutter-python-cli`, a fork of the `audreyr/cookiecutter-pypackage` project template.\n\n[audreyr/cookiecutter](https://github.com/audreyr/cookiecutter)\n[audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage)\n[rstms/cookiecutter-python-cli](https://github.com/rstms/cookiecutter-python-cli)\n```\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Top-level package for tsmtool.",
"version": "1.2.7",
"project_urls": {
"Home": "https://github.com/rstms/tsmtool"
},
"split_keywords": [
"tsmtool"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5fa56f0774e42ef8ff1500de72f2f2966463177ac077717731e8f15e7961d999",
"md5": "a82af6447d6c95b32dd7475fdb63025f",
"sha256": "c5f95d9a698bdb76734527883962f52e2d3669b9341c10f779d8d4008926a939"
},
"downloads": -1,
"filename": "tsmtool-1.2.7-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a82af6447d6c95b32dd7475fdb63025f",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 6787,
"upload_time": "2025-01-26T01:22:57",
"upload_time_iso_8601": "2025-01-26T01:22:57.063687Z",
"url": "https://files.pythonhosted.org/packages/5f/a5/6f0774e42ef8ff1500de72f2f2966463177ac077717731e8f15e7961d999/tsmtool-1.2.7-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a254ef965d0bb8fc92f43bd01c3c5fe67a9598e469ef08be11a62df7cb872ed0",
"md5": "14e3fc23d49fa8540820c3f47a69b054",
"sha256": "ee1de65f793973ff770a02e43e1c9f4789a625d9368f63b64f1fb6f54206cbad"
},
"downloads": -1,
"filename": "tsmtool-1.2.7.tar.gz",
"has_sig": false,
"md5_digest": "14e3fc23d49fa8540820c3f47a69b054",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 19064,
"upload_time": "2025-01-26T01:22:58",
"upload_time_iso_8601": "2025-01-26T01:22:58.972107Z",
"url": "https://files.pythonhosted.org/packages/a2/54/ef965d0bb8fc92f43bd01c3c5fe67a9598e469ef08be11a62df7cb872ed0/tsmtool-1.2.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-26 01:22:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rstms",
"github_project": "tsmtool",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "bs4",
"specs": []
},
{
"name": "click",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "tabulate",
"specs": []
}
],
"tox": true,
"lcname": "tsmtool"
}
JSON
