mirror of
https://github.com/YunoHost-Apps/ihatemoney_ynh.git
synced 2024-09-03 19:26:15 +02:00
96 lines
2.8 KiB
ReStructuredText
96 lines
2.8 KiB
ReStructuredText
Budget-manager
|
|
##############
|
|
|
|
This is a really tiny app to ease the shared houses budget management. Keep
|
|
track of who bought what, when, and for who to then compute the balance of each
|
|
person.
|
|
|
|
The code is distributed under a BSD beerware derivative: if you meet the people
|
|
in person and you want to pay them a beer, you are encouraged to do so (see
|
|
LICENSE for more details).
|
|
|
|
Make it run!
|
|
============
|
|
|
|
To make it run, you just have to do something like::
|
|
|
|
$ virtualenv venv
|
|
$ source venv/bin/activate
|
|
$ pip install -r budget/requirements.txt
|
|
$ cd budget
|
|
$ python run.py
|
|
|
|
It is also better to actually turn the debugging mode on when you're
|
|
developing. You can create a `settings.py` file in the `budget` directory, with
|
|
the following content::
|
|
|
|
DEBUG = True
|
|
SQLACHEMY_ECHO = DEBUG
|
|
|
|
You can also set the `TESTING` flag to `True` so no mails are sent
|
|
(and no exception is raised) while you're on development mode.
|
|
|
|
Deploy it
|
|
=========
|
|
|
|
To deploy it, I'm using gunicorn and supervisord::
|
|
|
|
$ virtualenv venv
|
|
$ source venv/bin/activate
|
|
$ pip install -r requirements.txt
|
|
|
|
1. Add the lines in conf/supervisord.conf to your supervisord.conf file.
|
|
**adapt them to your paths!**
|
|
2. Copy and paste the content of conf/nginx.conf in your nginx conf file.
|
|
**adapt them to your paths!**
|
|
3. reload both nginx and supervisord. It should be working ;)
|
|
|
|
Don't forget to set the right permission for your files !
|
|
|
|
Also, create a `settings.py` file with the appropriate values if you need to
|
|
use a different database for instance. You can also set `APPLICATION_ROOT` if
|
|
you want to prefix your URLs to serve ihatemonney in the *folder* of a domain,
|
|
e.g:
|
|
|
|
APPLICATION_ROOT='/budget'
|
|
|
|
|
|
How about the REST API?
|
|
=======================
|
|
|
|
Yep, you're right, there is a REST API with this. Head to the `api
|
|
documentation <http://readthedocs.org/docs/ihatemoney/en/latest/api.html>`_ to know more.
|
|
|
|
How to contribute
|
|
=================
|
|
|
|
There are different ways to help us, regarding if you are a designer,
|
|
a developer or just an user.
|
|
|
|
As a developer
|
|
--------------
|
|
|
|
The best way to contribute code is to write it and to make a pull request on
|
|
github. Please, think about updating and running the tests before asking for
|
|
a pull request as it will help us to maintain the code clean and running.
|
|
|
|
To do so::
|
|
|
|
$ workon budget
|
|
(budget) $ python tests.py
|
|
|
|
before pushing anything to master :)
|
|
|
|
As a designer / Front-end developer
|
|
-----------------------------------
|
|
|
|
Feel free to provide us mockups or to involve yourself into the discussions
|
|
hapenning on the github issue tracker. All ideas are welcome. Of course, if you
|
|
know how to implement them, feel free to fork and make a pull request.
|
|
|
|
End-user
|
|
--------
|
|
|
|
You just wanted to have a look at the application and found a bug? Please tell
|
|
us and go fill a new issue:
|
|
https://github.com/spiral-project/ihatemoney/issues
|