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.

To install the package, use the following command:

pip install pykitty

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!", )

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.

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

api.select_user("<your_username>")

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}, )

api.get_expenses() # list all expenses

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

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

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

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

This project is licensed under the MIT License.

• 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.