Metadata-Version: 2.2
Name: django-together
Version: 1.0
Summary: Deadly simple and easy to use money split app.
Home-page: https://github.com/thomst/django-together
Author: Thomas Leichtfuß
Author-email: thomas.leichtfuss@posteo.de
License: BSD License
Platform: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: Django>=3.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: platform
Dynamic: requires-dist
Dynamic: summary

# Welcome to django-together

[<img src="https://github.com/thomst/django-together/actions/workflows/ci.yml/badge.svg">](https://github.com/thomst/django-together/)
[<img src="https://coveralls.io/repos/github/thomst/django-together/badge.svg?branch=main">](https://coveralls.io/github/thomst/django-together?branch=main)
[<img src="https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue">](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)
[<img src="https://img.shields.io/badge/django-3.1%20%7C%203.2%20%7C%204.0%20%7C%204.1%20%7C%204.2%20%7C%205.0%20%7C%205.1-orange">](https://img.shields.io/badge/django-3.1%20%7C%203.2%20%7C%204.0%20%7C%204.1%20%7C%204.2%20%7C%205.0%20%7C%205.1-orange)


## Description

Tired of pseudo-free money split apps with tons of advertisements? Then launch
your own little money split project with *django-together* and share expenses with
friends and family using a super simple and easy to use django application based
on a well configured django admin backend.


## Setup

Install via pip:
```
pip install django-together
```

Add `together` to your `INSTALLED_APPS`:
```
INSTALLED_APPS = [
   'together',
   ...
]
```

## Getting started

Feel free to use the example project. (Actually it is all you need for a fully
functional money split application.)

Start it with:
```
python example/manage.py loaddata example/fixtures/testdata.json
python example/manage.py changepassword admin # Choose your password
python example/manage.py runserver
```
Then check it out by visiting `localhost:8000`.


## Usage

Each user creates expenses when needed and choose the users to share the expense with.

If you want to checkout the balance, just click the add calculation button and you will be shown a handy overview about who owes what to whom.

Save the calculation if your done dealing with the money. Open expenses will be tied to this calculation then and won't be regarded in further calculations.
