PyKitty

This Python SDK allows you to interact with KittySplit to manage expenses in a group. You can fetch a list of users, select a user and add expenses.

Installation

To install the package, use the following command:

pip install pykitty

Usage

1. Open a kitty on https://kittysplit.de/ and set a username
2. Once opened, copy the full Kittysplit URL, e.g. https://kittysplit.de/test_kitty/ADLKFJLAKD.../

Create your first expense with the following code (replace <kitty_URL> and <your_username>):

from pykitty import KittySplitAPI
api = KittySplitAPI("<kitty_URL>")
api.select_user("<your_username>")
api.add_expense(
    amount="10.00",
    description="A warm welcome by pykitty!",
)

Get Users

To fetch a list of users, use the get_users method:

api.get_users()  # {"user1": "3451816", "user2": "7167080"}

This will return a dictionary with usernames as keys and user IDs as values.

Select User

You have to select an user of the KittySplit. Use the select_user method to set your user:

api.select_user("<your_username>")

Add Expense

To add an expense, use the add_expense method:

api.add_expense(
    amount="10.00",
    description="Lunch",
)

This method will add a new expense with the specified details.

With the entry_date parameter, you can specify the date of the expense:

api.add_expense(
    amount="10.00",
    description="Lunch",
    entry_date="2023-03-29",
)

With the weight_mapping parameter, you can specify how much each user should pay for the expense. The sum of the weights must be 1.

api.add_expense(
    amount="10.00",
    description="Lunch",
    weight_mapping={"username1": 0.6, "username2": 0.4},
)

Get Expenses

api.get_expenses()  # list all expenses

api.get_expenses("yours")  # list expenses you paid

api.get_expenses("others")  # list expenses others have paid

Get Single Expenses Details

api.get_expense("8233711")  # expense_id can be found in URL

Delete Expense

api.delete_expense("8233711")  # expense_id can be found in URL

License

This project is licensed under the MIT License.

Next Steps (TODO)

• Parse Kitty URL to extract kitty_id
• Implement get_expenses method to retrieve all expenses.
• Add support for deleting expenses.
• Enhance test coverage.
• Add support for updating expenses.
• Document CLI usage.
• Support for Kittysplit in other languages.