Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Recurring payment system

Project Description

# Billy

Billy - The Open Source Recurring Billing System, powered by Balanced

(In active development. Consider it pre-alpha)

## Running It

To run billy (development mode), you need to install the package first. As we don’t want to mess the global Python environment, you should create a virtual environmnet first and switch to it

` virtualenv --no-site-packages env source env/bin/activate `

If above works correctly, you should see

` (env) $ `

in you command line tool. The (env) indicates that you are currently in the virtual Python environment. Then you need to install the billy project. Here you run

` python develop `

This should install all required dependencies. Then you need to create tables in database, here you type

` initialize_billy_db development.ini `

This should create all necessary tables for you in a default SQLite database.

Then, to run the API web server, here you type

` pserve development.ini --reload `

To process recurring transactions, here you can type

` process_billy_tx development.ini `

You can setup a crontab job to run the process_billy_tx periodically.

## Running Unit and Functional Tests

To run tests, after installing billy project and all dependencies, you need to install dependencies for testing, here you type:

` pip install -r test_requirements.txt `

And to run the tests, here you type

` python nosetests `

or, if you prefer run specific tests, you can run

` nosetests billy/tests/functional `

## Running Integration Tests

To run integration tests, here you type

` nosetests billy/tests/integration `

The default testing target URL is, to modify it, you can set environment variable BILLY_TEST_URL. To change balanced API key, you can set BILLY_TEST_PROCESSOR_KEY variable. For example

` export BILLY_TEST_URL= export BILLY_TEST_PROCESSOR_KEY=MY_SECRET_KEY_HERE nosetests billy/tests/integration `

Release History

This version
History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate