Skip to content

perfettiful/liberapay.com

 
 

Repository files navigation

Liberapay is a recurrent donations platform.

It's a fork of Gittip/Gratipay, see this post for the differences between the two.

Contact

You have a question? Come ask us in the salon or in the IRC channel #liberapay on Freenode.

Contributing to the translations

We use Weblate for translations

If you have questions about translating Liberapay, you can ask them in the translation thread of the salon.

Contributing to the code

Introduction

Liberapay is a fork of Gratipay, so it uses the web micro-framework Aspen, which is based on filesystem routing and simplates. Don't worry, it's quite simple. For example to make Liberapay return a Hello $user, your id is $userid message for requests to the URL /$user/hello, you only need to create the file www/%username/hello.spt with this inside:

from liberapay.utils import get_participant
[---]
participant = get_participant(state)
[---] text/html
{{ _("Hello {0}, your id is {1}", request.path['username'], participant.id) }}

As illustrated by the last line our default template engine is Jinja.

The _ function attempts to translate the message into the user's language and escapes the variables properly (it knows that it's generating a message for an HTML page).

The python code inside simplates is only for request-specific logic, common backend code is in the liberapay/ directory.

We interact with the database by writing raw SQL queries sent via the postgres.py library.

Installation

Firstly, make sure you have the following dependencies installed:

  • python 2.7 (a pull request to port to python 3 is very much welcome)
  • virtualenv
  • postgresql 9.4.5
  • make

Then run:

make env

Now you'll need to create two postgres databases, here's the simplest way of doing it:

sudo -u postgres createuser --superuser $USER
createdb liberapay
createdb liberapay_tests

Then you can set up the DB:

make schema

Configuration

Environment variables are used for configuration, the default values are in defaults.env and tests/test.env. You can override them in local.env and tests/local.env respectively.

Running

Once you've installed everything and set up the database, you can run the app:

make run

It should now be accessible at http://localhost:8339/.

You can create some fake users to make it look more like the real site:

make data

Modifying the database schema

The DB schema is in sql/schema.sql, but don't modify that file directly, instead put the changes in sql/branch.sql. During deployment that script will be run on the production DB and the changes will be merged into sql/schema.sql.

That process is semi-automated by release.sh.

CSS and JavaScript

For our styles we use SASS and [Bootstrap 3] (https://getbootstrap.com/). Stylesheets are in the style/ directory and our JavaScript code is in js/. Our policy for both is to have as little as possible of them: the website should be almost entirely usable without JS, and our CSS should leverage Bootstrap as much as possible instead of containing lots of custom rules that would become a burden to maintain.

Testing Build Status

The easiest way to run the test suite is:

make test

That recreates the test DB's schema and runs all the tests. To speed things up you can also use the following commands:

  • make pytest only runs the python tests without recreating the test DB
  • make pytest-re does the same but only runs the tests that failed in the previous run

Deploying the app

Liberapay is hosted on OpenShift Online, which runs the OpenShift M4 platform (also called OpenShift 2.x, not to be confused with the newer OpenShift 3.x based on Docker). The user documentation is on developers.openshift.com.

To deploy the app simply run release.sh, it'll guide you through it.

License

CC0 Public Domain Dedication

About

Recurrent donations platform

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 75.8%
  • JavaScript 10.4%
  • HTML 6.3%
  • PLpgSQL 3.6%
  • CSS 1.9%
  • Shell 0.9%
  • Other 1.1%