<commit_before>Billjobs
========

A django billing app for coworking space.

This app is designed to manage bills for the coworking space **Cowork'in Montpellier**. We intend to stay easy and 
lite.  You can manage coworkers informations and their respective bills.

**No tax management**. There is no tax for non-profit organization in France. This application doesn't manage tax, it 
only displays legal French informations and tax 0% on bills.

Features
--------

All the features are managed throught [django admin.site](https://docs.djangoproject.com/en/1.8/ref/contrib/admin/)

- User and Group management is provided by [django auth](https://docs.djangoproject.com/en/dev/topics/auth/) module.
- Billing management
- Services management

Installing
----------

    pip install django-billjobs

Contributing
------------

Wow you are awesome ! Thank you.

### Git workflow


Previously we used [git flow](http://nvie.com/posts/a-successful-git-branching-model/)
**develop** branch is here for historical reason

For now I am using a more simple workflow.

Create a feature branch when you develop a new feature, a hotfix and at the end rebase it with **master** branch.

    git checkout -b new_feature
    # do your commits
    git checkout master
    git pull
    git rebase master new_feature
    git merge --no-ff new_feature

### Develop

#### Clone repository

    git clone https://github.com/ioO/billjobs.git


#### Create a virtualenv with python 3 binary

Billjobs was initially written with **python 2.7** and move to **python 3.x**. It works with **python 3.5**

Read [virtualenv documentation](http://virtualenvwrapper.readthedocs.org/en/latest/ "Virtualenv")

    mkvirtualenv django-billjobs --python=/path/to/python3.5
    add2virtualenv path/to/django-billjobs

#### Install development dependencies

    pip install -r requirements_dev.txt

#### Sample settings

The *core/* folder contains sample settings for development. Use DJANGO_SETTINGS_MODULE environment variables.

In your virtualenv *bin/postactivate*

    export DJANGO_SETTINGS_MODULE=core.settings

In your virtualenv *bin/postdeactivate*

    unser DJANGO_SETTINGS_MODULE

You can run server to test your development with :

    django-admin runserver

#### Database

Development use sqlite3 engine.

    django-admin migrate

You can use development fixtures

    django-admin loaddata billjobs/fixtures/dev_data.json

If you setup a super user it will be deleted by fixtures data.
- Login : bill
- Password : <PASSWORD>
<commit_msg>Fix syntax higlight<commit_after>Billjobs
========

A django billing app for coworking space.

This app is designed to manage bills for the coworking space **Cowork'in Montpellier**. We intend to stay easy and 
lite.  You can manage coworkers informations and their respective bills.

**No tax management**. There is no tax for non-profit organization in France. This application doesn't manage tax, it 
only displays legal French informations and tax 0% on bills.

Features
--------

All the features are managed throught [django admin.site](https://docs.djangoproject.com/en/1.8/ref/contrib/admin/)

- User and Group management is provided by [django auth](https://docs.djangoproject.com/en/dev/topics/auth/) module.
- Billing management
- Services management

Installing
----------
```shell
pip install django-billjobs
```

Contributing
------------

Wow you are awesome ! Thank you.

### Git workflow


Previously we used [git flow](http://nvie.com/posts/a-successful-git-branching-model/)
**develop** branch is here for historical reason

For now I am using a more simple workflow.

Create a feature branch when you develop a new feature, a hotfix and at the end rebase it with **master** branch.

```shell
git checkout -b new_feature
# do your commits
git checkout master
git pull
git rebase master new_feature
git merge --no-ff new_feature
```

### Develop

#### Clone repository

```shell
git clone https://github.com/ioO/billjobs.git
```
#### Create a virtualenv with python 3 binary

Billjobs was initially written with **python 2.7** and move to **python 3.x**. It works with **python 3.5**

Read [virtualenv documentation](http://virtualenvwrapper.readthedocs.org/en/latest/ "Virtualenv")

```shell
mkvirtualenv django-billjobs --python=/path/to/python3.5
add2virtualenv path/to/django-billjobs
```

#### Install development dependencies
```shell
pip install -r requirements_dev.txt
```

#### Sample settings

The *core/* folder contains sample settings for development. Use DJANGO_SETTINGS_MODULE environment variables.

In your virtualenv *bin/postactivate*
```shell
export DJANGO_SETTINGS_MODULE=core.settings
```

In your virtualenv *bin/postdeactivate*
```shell
unset DJANGO_SETTINGS_MODULE
```

You can run server to test your development with :
```shell
django-admin runserver
```

#### Database

Development use sqlite3 engine.
```shell
django-admin migrate
```

You can use development fixtures
```shell
django-admin loaddata billjobs/fixtures/dev_data.json
```

If you setup a super user it will be deleted by fixtures data.
- Login : bill
- Password : <PASSWORD>
{'fraction_non_alphanumeric': 0.1033672670321065, 'fraction_numerical': 0.005090054815974941, 'mean_word_length': 4.0434353405725565, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3123561', 'n_tokens_mistral': 1532, 'n_tokens_neox': 1414, 'n_words': 568}