| Name | candid-cash JSON |
| Version |
23.10.0b4
JSON |
| download |
| home_page | |
| Summary | Tool for budgeting/tracking finances. |
| upload_time | 2023-10-16 01:07:30 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | |
| license | |
| keywords |
money
finance
budget
productivity
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# easy-money
A simple but powerful tool for budgeting and tracking finances.
Not *actually* released yet.
# Quickstart
The easiest way to start using easy-money is to use [pipx](https://pypa.github.io/pipx/installation/)
pipx install candid_cash
easy-money
Yes - you have to install `candid_cash`, even though this is called Easy Money.
Don't worry about it. [Unless you want to](https://pypi.org/help/#project-name).
By default you'll be presented with a text UI that shows you a summary of your
current everything:
$0 free, $0 in 0 goals (0 over time, 100% funded)
Type "help" for help.
>
By default currency is $/USD, but you can change that. This summary will also
be printed before every prompt, which can also be changed.
You can add money (normally you'd do this when you get money, like on payday or
when someone hands you a stack of $100 bills).
> add 100
$100 free, $0 in 0 goals (0 over time, 100% funded)
Now you can create some goals and add the money to your goals:
> new goal Gas
Gas - $0> move 50
$50 free, $50 in 1 goals (0 over time, 100% funded)
Gas - $50> exit
$50 free, $50 in 1 goal (0 over time, 100% funded)
> new goal Eating out
Eating out - $0> move 25
$25 free, $75 in 2 goals (0 over time, 100% funded)
Eating out - $25> exit
> new goal Groceries
Groceries - $0> move 50
OOPS! Only $25 available. Try move 25 (or less)
Groceries - $0> move 25
$0 free, $100 in 3 goals (0 over time, 100% funded)
Groceries - $25> exit
> new goal New computer
New computer - $0> add 20
$0 free, $120 in 4 goals (0 over time, 100% funded)
New computer - $20> exit
$0 free, $120 in 4 goals (0 over time, 100% funded)
> new target
Goal name: Birthday
Would you like to save per (t)ime or for a (d)ate? d
What date? 2024-06-25
Total amount? 28
That will be $0.11 per day over 254 days.
$0 free, $120 in 4 goals ($28 over time, 0% funded)
> add 14
$14 free, $120 in 4 goals ($28 over time, 0% funded)
> move 14 to Birthday
$0 free, $120 in 4 goals ($28 over time, 50% funded)
> new target
Goal name: New car
Would you like to save per (t)ime or for a (d)ate? t
How often - (D)aily, (W)eekly, (B)i-weekly, (M)onthly? D
How much per day? 0.25
How much total? 25,000
You will reach $25,000 saved on 2297-06-30
$0 free, $120 in 4 goals ($14/25,028 over time, 0% funded)
>
You may already know this, but Easy Money is based on the [envelope
method](https://en.wikipedia.org/wiki/Envelope_system) method of budgeting.
But, better. Maybe!
For more help on how to use EM, type help at the prompt(s).
# Deeper Dive
When writing Easy Money, I heavily borrowed from Simple. For me, it was a
life-changing use of technology and made it fun to see how long it would take
to save up for things, or where I was really spending my money. It helped me to
decide if I really wanted to buy something, or if I was better off doing
something else. However, PNC bank bought out Simple, and pretty much ruined my
life. For several years I've tried a multitude of different approaches, but
none of them have worked very well. Even EM may not work so well for me, but
the goal is to make it almost as easy to use as Simple was. But licensed AGPL,
which is the most aggressive Copyleft license I'm aware of.
To put it bluntly, the goal of EM is to allow you to take control of your
financial situation, regardless of the whims of a corporation. At any point,
you may take EM and manage it yourself.
## Goals and Funding Schedules
Goals are the envelopes of the envelope method. And there are two types of
goals - immediate, and over time. For an immediate goal it's like taking cash
and putting it directly into an envelope. For an over time goal it's something
that you'd like to save up for. Maybe you want a new video game console, a new
outfit, or need to repair your car. You probably need to buy new tires in a few
years. You'll certainly need to change your oil.
For something like oil you know that it's probably 3 months - and around here a
full synthetic oil change is about $80 right now. So that would be about $0.89
for a daily funding schedule. Or about $6.25 per week. Or $12.50 bi-weekly. Or
$27 monthly. But you don't need to remember that or figure it out. That's where
Easy Money makes life easier for you. EM will track all of that for you. You
just have to input when you get and spend money - just like when you would put
money into or take money out of your envelopes.
## Free Money!
Well, not free as in without cost, but free as in unallocated. If your money
isn't allocated to a particular goal, it's considered free money. That is,
spend it on whatever you want! Or keep it as an emergency fund and only spend
from your goals. Do what you want, I'm not your dad. Except for the 5 of you
for whom I am your dad. But you're probably an adult by the time you're using
this so you can use it however you want.
But, in order to fund a goal you have to have some free money. You can't just
make up money, despite all of this stuff being made up anyway. You're the one
who decides what the numbers mean.
## Imports
If you're like me, you hate actually inputting the transactions that you make -
even if it's easy! Like, uuuugh. It's the worst. So Easy Money offers an
importer. When you import transactions into EM, your bank or CC should offer
.csv downloads. You can import these into EM. If you're like me there's also a
non-zero chance that you'll end out re-importing the same transactions. In my
case I've had a in-the-middle-of-a-billing-cycle file, or monthly files, and
then I pulled in a yearly file. Whoops! Don't worry - if you notice that you've
got duplicate entries, we retain the batch/filename information from when they
were imported, so you can easily just delete the whole batch.
## Reports
There ~are currently only~ will soon be a couple of basic reports offered:
- Monthly in/out - how much money came in this month and how much went out? (By
calendar month as well as last 30 days)
- Yearly in/out - good for tracking your long-term monetary goals.
- Runway - Based on your current reserves, given your recent spending, how long
until you're out of cash? It's a sucky thing to consider, but it's better
than not knowing.
# Roadmap
These are things that we want to do:
- Implement basic behavior as documented here in the README
- Create installer/upload to pypi
- Add importer
- Add some reporting
# Changelog
We use [keepachangelog](https://keepachangelog.com/). We also use [CalVer](https://calver.org/) for
versioning. Specifically YY.MM.patch.
## Unreleased
- Anything!
Raw data
{
"_id": null,
"home_page": "",
"name": "candid-cash",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "money,finance,budget,productivity",
"author": "",
"author_email": "Wayne Werner <wayne@waynewerner.com>",
"download_url": "https://files.pythonhosted.org/packages/b0/39/143fbc324a5487d61505d7c19a8918356d432e8fc8b2492bf5c9269ebb4c/candid_cash-23.10.0b4.tar.gz",
"platform": null,
"description": "# easy-money\n\nA simple but powerful tool for budgeting and tracking finances.\n\nNot *actually* released yet.\n\n# Quickstart\n\nThe easiest way to start using easy-money is to use [pipx](https://pypa.github.io/pipx/installation/)\n\n pipx install candid_cash\n easy-money\n\nYes - you have to install `candid_cash`, even though this is called Easy Money.\nDon't worry about it. [Unless you want to](https://pypi.org/help/#project-name).\n\n\nBy default you'll be presented with a text UI that shows you a summary of your\ncurrent everything:\n\n $0 free, $0 in 0 goals (0 over time, 100% funded)\n Type \"help\" for help.\n > \n\nBy default currency is $/USD, but you can change that. This summary will also\nbe printed before every prompt, which can also be changed.\n\nYou can add money (normally you'd do this when you get money, like on payday or\nwhen someone hands you a stack of $100 bills).\n\n > add 100\n $100 free, $0 in 0 goals (0 over time, 100% funded)\n\nNow you can create some goals and add the money to your goals:\n\n > new goal Gas\n Gas - $0> move 50\n $50 free, $50 in 1 goals (0 over time, 100% funded)\n Gas - $50> exit\n $50 free, $50 in 1 goal (0 over time, 100% funded)\n > new goal Eating out\n Eating out - $0> move 25\n $25 free, $75 in 2 goals (0 over time, 100% funded)\n Eating out - $25> exit\n > new goal Groceries\n Groceries - $0> move 50\n OOPS! Only $25 available. Try move 25 (or less)\n Groceries - $0> move 25\n $0 free, $100 in 3 goals (0 over time, 100% funded)\n Groceries - $25> exit\n > new goal New computer\n New computer - $0> add 20\n $0 free, $120 in 4 goals (0 over time, 100% funded)\n New computer - $20> exit\n $0 free, $120 in 4 goals (0 over time, 100% funded)\n > new target\n Goal name: Birthday\n Would you like to save per (t)ime or for a (d)ate? d\n What date? 2024-06-25\n Total amount? 28\n That will be $0.11 per day over 254 days.\n $0 free, $120 in 4 goals ($28 over time, 0% funded)\n > add 14\n $14 free, $120 in 4 goals ($28 over time, 0% funded)\n > move 14 to Birthday\n $0 free, $120 in 4 goals ($28 over time, 50% funded)\n > new target\n Goal name: New car\n Would you like to save per (t)ime or for a (d)ate? t\n How often - (D)aily, (W)eekly, (B)i-weekly, (M)onthly? D\n How much per day? 0.25\n How much total? 25,000\n You will reach $25,000 saved on 2297-06-30\n $0 free, $120 in 4 goals ($14/25,028 over time, 0% funded)\n >\n\nYou may already know this, but Easy Money is based on the [envelope\nmethod](https://en.wikipedia.org/wiki/Envelope_system) method of budgeting.\nBut, better. Maybe!\n\nFor more help on how to use EM, type help at the prompt(s).\n\n# Deeper Dive\n\nWhen writing Easy Money, I heavily borrowed from Simple. For me, it was a\nlife-changing use of technology and made it fun to see how long it would take\nto save up for things, or where I was really spending my money. It helped me to\ndecide if I really wanted to buy something, or if I was better off doing\nsomething else. However, PNC bank bought out Simple, and pretty much ruined my\nlife. For several years I've tried a multitude of different approaches, but\nnone of them have worked very well. Even EM may not work so well for me, but\nthe goal is to make it almost as easy to use as Simple was. But licensed AGPL,\nwhich is the most aggressive Copyleft license I'm aware of.\n\nTo put it bluntly, the goal of EM is to allow you to take control of your\nfinancial situation, regardless of the whims of a corporation. At any point,\nyou may take EM and manage it yourself.\n\n\n## Goals and Funding Schedules\n\nGoals are the envelopes of the envelope method. And there are two types of\ngoals - immediate, and over time. For an immediate goal it's like taking cash\nand putting it directly into an envelope. For an over time goal it's something\nthat you'd like to save up for. Maybe you want a new video game console, a new\noutfit, or need to repair your car. You probably need to buy new tires in a few\nyears. You'll certainly need to change your oil.\n\nFor something like oil you know that it's probably 3 months - and around here a\nfull synthetic oil change is about $80 right now. So that would be about $0.89\nfor a daily funding schedule. Or about $6.25 per week. Or $12.50 bi-weekly. Or\n$27 monthly. But you don't need to remember that or figure it out. That's where\nEasy Money makes life easier for you. EM will track all of that for you. You\njust have to input when you get and spend money - just like when you would put\nmoney into or take money out of your envelopes.\n\n## Free Money!\n\nWell, not free as in without cost, but free as in unallocated. If your money\nisn't allocated to a particular goal, it's considered free money. That is,\nspend it on whatever you want! Or keep it as an emergency fund and only spend\nfrom your goals. Do what you want, I'm not your dad. Except for the 5 of you\nfor whom I am your dad. But you're probably an adult by the time you're using\nthis so you can use it however you want.\n\nBut, in order to fund a goal you have to have some free money. You can't just\nmake up money, despite all of this stuff being made up anyway. You're the one\nwho decides what the numbers mean.\n\n## Imports\n\nIf you're like me, you hate actually inputting the transactions that you make -\neven if it's easy! Like, uuuugh. It's the worst. So Easy Money offers an\nimporter. When you import transactions into EM, your bank or CC should offer\n.csv downloads. You can import these into EM. If you're like me there's also a\nnon-zero chance that you'll end out re-importing the same transactions. In my\ncase I've had a in-the-middle-of-a-billing-cycle file, or monthly files, and\nthen I pulled in a yearly file. Whoops! Don't worry - if you notice that you've\ngot duplicate entries, we retain the batch/filename information from when they\nwere imported, so you can easily just delete the whole batch.\n\n## Reports\n\nThere ~are currently only~ will soon be a couple of basic reports offered:\n\n- Monthly in/out - how much money came in this month and how much went out? (By\n calendar month as well as last 30 days)\n- Yearly in/out - good for tracking your long-term monetary goals.\n- Runway - Based on your current reserves, given your recent spending, how long\n until you're out of cash? It's a sucky thing to consider, but it's better\n than not knowing.\n\n\n# Roadmap\n\nThese are things that we want to do:\n\n- Implement basic behavior as documented here in the README\n- Create installer/upload to pypi\n- Add importer\n- Add some reporting\n\n\n# Changelog\n\nWe use [keepachangelog](https://keepachangelog.com/). We also use [CalVer](https://calver.org/) for\nversioning. Specifically YY.MM.patch.\n\n## Unreleased\n\n- Anything!\n",
"bugtrack_url": null,
"license": "",
"summary": "Tool for budgeting/tracking finances.",
"version": "23.10.0b4",
"project_urls": null,
"split_keywords": [
"money",
"finance",
"budget",
"productivity"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "da003db31c8084c7ade57063cf2c59c678bf532948df940f4ac6757d46bcad8b",
"md5": "e730759d3c9fc8cca992885ef61cd5a0",
"sha256": "091ebf13f1d3955b6b85d0b5f3e0df5d5db824d7cc7db735e4bd1c37dd81c2b2"
},
"downloads": -1,
"filename": "candid_cash-23.10.0b4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e730759d3c9fc8cca992885ef61cd5a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 16798,
"upload_time": "2023-10-16T01:07:29",
"upload_time_iso_8601": "2023-10-16T01:07:29.073942Z",
"url": "https://files.pythonhosted.org/packages/da/00/3db31c8084c7ade57063cf2c59c678bf532948df940f4ac6757d46bcad8b/candid_cash-23.10.0b4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b039143fbc324a5487d61505d7c19a8918356d432e8fc8b2492bf5c9269ebb4c",
"md5": "5c8f5ca762e30fe1e5a01936cd45f6ec",
"sha256": "a2d556abaa3524dc0afb52369c3d9490d27676fcb4ac9c8ab99b58ef8f5be8ac"
},
"downloads": -1,
"filename": "candid_cash-23.10.0b4.tar.gz",
"has_sig": false,
"md5_digest": "5c8f5ca762e30fe1e5a01936cd45f6ec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 16483,
"upload_time": "2023-10-16T01:07:30",
"upload_time_iso_8601": "2023-10-16T01:07:30.790812Z",
"url": "https://files.pythonhosted.org/packages/b0/39/143fbc324a5487d61505d7c19a8918356d432e8fc8b2492bf5c9269ebb4c/candid_cash-23.10.0b4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-16 01:07:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "candid-cash"
}
