Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/evan-stromatias/derdiedas
A Kivy desktop app to practice German nouns
https://github.com/evan-stromatias/derdiedas
german kivy nouns python sqlite
Last synced: 22 days ago
JSON representation
A Kivy desktop app to practice German nouns
- Host: GitHub
- URL: https://github.com/evan-stromatias/derdiedas
- Owner: evan-stromatias
- License: mit
- Created: 2024-08-06T14:12:44.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-08-16T11:39:44.000Z (3 months ago)
- Last Synced: 2024-10-14T06:22:46.058Z (22 days ago)
- Topics: german, kivy, nouns, python, sqlite
- Language: Python
- Homepage:
- Size: 3.7 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: License.md
Awesome Lists containing this project
README
# 🐙 Der Die Das 📚
The `Der Die Das` is a [Kivy](https://kivy.org/) desktop app to practice the German nouns (gender, plural, translation, etc).
## 🔍 Prerequisites
- [Python 3.12](https://www.python.org/downloads/release/python-3125/)
- (Optional) [Poetry](https://python-poetry.org/)
## 👟 Running
### Without using Poetry
```
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .
```
Finally you may run the `Der Die Das` app by executing:
```
derdiedas
```
### Build & install using Poetry
Build the Python project by running:
```
poetry build
```
Then install the python package:
```
python3.12 -m pip install /dist/der_die_das-0.1.0.tar.gz
```
Finally you may run the `Der Die Das` app by executing:
```
derdiedas
```
## 🏗️ Developing
```
poetry install
```
```
poetry run derdiedas
```
## 📈 German Nouns Data
The [`./data/all_chapters.csv`] (data/all_chapters.csv) file has all the data required to run this application. The first time you run the app run it will read the data from the `csv` file and load them to an [sqlite](https://www.sqlite.org/) database.
However, it's possible to also use your own `csv` file. The only requirement is that it needs to have the following headers:
- `gender`
- `noun`
- `plural`
- `translation`
For example:
```
gender,noun,plural,translation
die,Begrüßung,-en,the greeting
das,Foto,-s,the photo
der,Herr,-en,the gentleman
```
then you can load the `csv` data to the database by running:
```
poetry run derdiedas_db -c PATH/TO/YOUR/CSV/FILE.csv
```
Alternatively if you have installed the project without Poetry:
```
derdiedas_db -c PATH/TO/YOUR/CSV/FILE.csv
```
# 🤌🏻 Future work
- Port to Android