mirror of
https://github.com/YunoHost-Apps/ihatemoney_ynh.git
synced 2024-09-03 19:26:15 +02:00
a80202e066
As per [their blog post of the 27th April](https://blog.readthedocs.com/securing-subdomains/) ‘Securing subdomains’: > Starting today, Read the Docs will start hosting projects from subdomains on the domain readthedocs.io, instead of on readthedocs.org. This change addresses some security concerns around site cookies while hosting user generated data on the same domain as our dashboard. Test Plan: Manually visited all the links I’ve modified.
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 <https://ihatemoney.readthedocs.io/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
|