updated README.md

and PfandApplication/main.py
This commit is contained in:
rattatwinko
2025-04-17 14:44:45 +02:00
parent 63a5ced60a
commit e3e581ccd8
2 changed files with 46 additions and 30 deletions

View File

@@ -1,7 +1,6 @@
import tkinter as tk import tkinter as tk
import tkinter
import webbrowser
from tkinter import ttk, messagebox, filedialog from tkinter import ttk, messagebox, filedialog
import webbrowser
import json import json
from PIL import Image, ImageTk from PIL import Image, ImageTk
import os import os
@@ -23,7 +22,6 @@ from PfandApplication.updater import open_updater as open_updater, run_silent_up
from PfandApplication.tgtg_orderchecker import main as tgtg from PfandApplication.tgtg_orderchecker import main as tgtg
from PfandApplication.tgtg_orderchecker import setupkey as tgtg_kt from PfandApplication.tgtg_orderchecker import setupkey as tgtg_kt
class Achievement: class Achievement:
def __init__(self, title, description, condition_type, condition_value): def __init__(self, title, description, condition_type, condition_value):
self.title = title self.title = title
@@ -426,7 +424,7 @@ class PfandCalculator:
close_button = tk.Button(about_update, text="Close", command=about_update.destroy) close_button = tk.Button(about_update, text="Close", command=about_update.destroy)
close_button.grid(row=1, column=0, sticky='ew', padx=10, pady=(0, 10)) close_button.grid(row=1, column=0, sticky='ew', padx=10, pady=(0, 10))
def µScan_credits(self): def µScan_credits(self, about_μScan=None, label_μScan_app=None):
about_µScan = tk.Toplevel(self.root) about_µScan = tk.Toplevel(self.root)
about_μScan.title("Über µScan") about_μScan.title("Über µScan")
about_μScan.geometry("650x190") about_μScan.geometry("650x190")

View File

@@ -1,46 +1,61 @@
# ♻️ Pfandrechner # ♻️ Pfandrechner Python Package
**Version:** V.8.04.301-PKG1 **Version:** V.8.04.301-PKG1
**License:** [MIT](LICENSE) **License:**[MIT]()
Welcome to the **Pfandrechner Application - Package** a sleek and powerful tool for tracking and calculating container deposits ("Pfand") in Austria 🇦🇹. Whether you're returning a few bottles or managing full bags, this app has you covered! > ⚠️ **Note:** This package is based on the original [`pfand`](https://github.com/ZockerKatze/pfand) application, which has now been **archived**.
> This repo (`pfand_PKG`) continues the project in a modular and importable format, ideal for integration into your own Python workflows.
This is a copy of [Pfand](https://github.com/ZockerKatze/pfand), but this is in Package Form which can be **imported** and integrated! Welcome to the **Pfandrechner Package** a modular and importable version of Austrias beloved container deposit ("Pfand") calculator. This package allows developers to seamlessly integrate Pfand logic into their own Python projects.
--- ---
## ✨ Features ## 📦 Whats Inside
🔢 **Deposit Calculator** Instantly compute the total value of your returned bottles and cans. This package retains the core functionalities of the original application, including:
🏆 **Achievements** Track your progress and unlock fun rewards for your deposit milestones. * 🔢 **Deposit Calculator** Compute the total value of returned bottles and cans.
* 🏆 **Achievements** Monitor progress and unlock rewards for deposit milestones.
📜 **History & Exports** View your past returns and export the data for safekeeping or bragging rights. * 📜 **History & Exports** Access past returns and export data.
* 📦 **TGTG Integration** Connect with "Too Good To Go" orders (API key setup required).
📦 **TGTG Integration** Check on your "Too Good To Go" orders directly within the app. ( You need to setup your API Key first! ) * ⚙️ **Smart Updater** Ensure the package stays updated with the latest features and fixes.
⚙️ **Smart Updater** Keeps the app fresh with the latest features and fixes.
--- ---
## 🚀 Getting Started ## 🚀 Installation
### 1. Clone the Repository ### 1. Clone the Repository
```bash ```bash
git clone https://github.com/ZockerKatze/pfand_PKG.git git clone https://github.com/ZockerKatze/pfand_PKG.git
cd pfand cd pfand_PKG
``` ```
### 2. Install Dependencies ### 2. Create and Activate a Virtual Environment (Recommended)
Make sure youre using Python 3, then run: #### On macOS/Linux:
```bash
python3 -m venv venv
source venv/bin/activate
```
#### On Windows:
```bash
python -m venv venv
venv\Scripts\activate
```
### 3. Install Dependencies
```bash ```bash
pip install -r requirements.txt pip install -r requirements.txt
``` ```
### 3. Launch the App ### 4. Launch or Integrate
You can now use the package by importing it into your own Python projects, or run the provided entry script if applicable:
```bash ```bash
python run.py python run.py
@@ -48,26 +63,29 @@ python run.py
--- ---
## 🧮 How to Count ## 🧮 Usage
You can either: You have two options for counting:
- ✍️ **Manually** count and enter your container numbers * ✍️ **Manual Entry** Input container numbers directly.
_OR_ * 🔬 **µScan** Utilize the enhanced scanner with barcode recognition powered by `pyzbar`.
- 🔬 Use **µScan** the improved scanner for fast and accurate counting with barcode recognition using _pyzbar_!
--- ---
## 🤝 Contributing ## 🤝 Contributing
Want to improve the app or add new features? Awesome! Contributions are welcome! To contribute:
Fork the repo, make your changes, and send a pull request. 💡
1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Commit your changes.
4. Submit a pull request for review.
--- ---
## 📄 License ## 📄 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. This project is licensed under the MIT License. See the [LICENSE]() file for details.
--- ---