{"id":27776354,"url":"https://github.com/vetronics/shopping_manager","last_synced_at":"2026-05-06T11:32:32.864Z","repository":{"id":290452514,"uuid":"974410942","full_name":"vetronics/shopping_manager","owner":"vetronics","description":"A simple Python script to manage shopping items and values using a terminal-based interface.","archived":false,"fork":false,"pushed_at":"2025-07-01T15:44:57.000Z","size":93,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-01T16:47:38.213Z","etag":null,"topics":["apt","debian","debian-linux","dnf","fedora","fedora-linux","github-actions","linux-shell","macos","procedure","python","python3","scrpit","simple-project","windows-11"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vetronics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-28T18:27:32.000Z","updated_at":"2025-07-01T15:45:01.000Z","dependencies_parsed_at":"2025-05-16T20:27:20.610Z","dependency_job_id":"01408500-fc4a-4105-b38d-914670f4ef93","html_url":"https://github.com/vetronics/shopping_manager","commit_stats":null,"previous_names":["vetronics/shopping_manager"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/vetronics/shopping_manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vetronics%2Fshopping_manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vetronics%2Fshopping_manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vetronics%2Fshopping_manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vetronics%2Fshopping_manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vetronics","download_url":"https://codeload.github.com/vetronics/shopping_manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vetronics%2Fshopping_manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32691751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apt","debian","debian-linux","dnf","fedora","fedora-linux","github-actions","linux-shell","macos","procedure","python","python3","scrpit","simple-project","windows-11"],"created_at":"2025-04-30T05:04:50.396Z","updated_at":"2026-05-06T11:32:32.859Z","avatar_url":"https://github.com/vetronics.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛒 Shopping Manager\n\n**Shopping Manager** is a simple, cross-platform command-line tool written in Python that helps you manage shopping list items and their associated values. It features an ASCII-style interface and provides file-based storage for tracking and budgeting.\n\n---\n\n## ✨ Features\n\n- ASCII Art interface using `pyfiglet`\n- data visualization by 'pandas, matplotlib'\n- Interactive command-line menu\n- Add or remove shopping items\n- Assign values to items (e.g., cost, quantity)\n- Count total items and values\n- Calculate the total sum of all values\n- Saves data in plain `.csv` file\n- No external database required\n\n---\n\n## 🧰 Requirements\n\n- Python 3.x  \n  👉 [Download Python](https://www.python.org/downloads/)\n- `pyfiglet` module\n- `pandas` module\n- `matplotlib` module\n-  `pyautogui` module\n\n---\n\n## 💻 Installation Instructions\n\nFollow the setup guide based on your operating system. Additionally, you can also use Docker to run the application.\n\n---\n\n### 🪟 Windows\n\n1. **Install Python:**\n   - Download it from [python.org](https://www.python.org/downloads/)\n   - ✅ Check the box **“Add Python to PATH”** before clicking *Install Now*\n\n2. **Open the terminal:**\n   - Press `Windows + S`, search for **Command Prompt**, **PowerShell**, or **Windows Terminal**\n\n3. **Install `pyfiglet,pandas,matplotlib,pyautogui`:**\n   - Run the following command in your terminal:\n   \n     ```bash\n     pip install pyfiglet\n     pip install pandas\n     pip install matplotlib\n     pip install pyautogui\n     ```\n\n   \u003e If `pip` is not recognized, try this alternative command:\n   \n     ```bash\n     python -m pip install pyfiglet\n     python -m pip install pandas\n     python -m pip install matplotlib\n     python -m pip install pyautogui\n     ```\n\n4. **Run the script:**\n   - On **Windows**, you can **double-click** the `shopping_manager.py` file to run the script. The terminal window will appear, and you can interact with the application.\n   - If double-clicking doesn't work (i.e., the terminal closes immediately), open **Command Prompt** or **PowerShell**, navigate to the script's folder, and run:\n\n     ```bash\n     python shopping_manager.py\n     ```\n\n---\n\n### 🍎 macOS\n\n1. **Install Python 3:**\n   - With [Homebrew](https://brew.sh/):\n\n     ```bash\n     brew install python\n     ```\n   \n   - Or download it from [python.org](https://www.python.org/downloads/)\n\n2. **Open Terminal:**\n   - Press `Command + Space`, type **Terminal**, then press Enter\n\n3. **Install `pyfiglet,pandas,matplotlib,pyautogui`:**\n   - Run the following command in your terminal:\n   \n     ```bash\n      pip3 install pyfiglet\n     pip3 install pandas\n     pip3 install matplotlib\n     pip3 install pyautogui\n     ```\n\n   \u003e Or try:\n   \n     ```bash\n     python3 -m pip install pyfiglet\n     python3 -m pip install pandas\n     python3 -m pip install matplotlib\n     python3 -m pip install pyautogui\n     ```\n\n4. **Run the Script:**\n   - Open **Terminal**, navigate to the script's directory, and run:\n\n     ```bash\n     python3 shopping_manager.py\n     ```\n\n---\n\n### 🐧 Linux (Debian/Ubuntu)\n\n1. **Install Python and pip:**\n\n   ```bash\n   sudo apt update\n   sudo apt install python3 python3-pip\n   ```\n\n2. **Install `pyfiglet,pandas,matplotlib,pyautogui`:**\n\n   ```bash\n   pip3 install pyfiglet\n   pip3 install pandas\n   pip3 install matplotlib\n   pip3 install pyautogui\n   ```\n\n3. **Run the Script:**\n\n   * Open **Terminal**, navigate to the script's directory, and run:\n\n     ```bash\n     python3 shopping_manager.py\n     ```\n\n---\n\n### 🐧 Linux (Fedora)\n\n1. **Install Python and pip:**\n\n   ```bash\n   sudo dnf install python3 python3-pip\n   ```\n\n2. **Install `pyfiglet,pandas,matplotlib,pyautogui`:**\n\n   ```bash\n   pip3 install pyfiglet\n   pip3 install pandas\n   pip3 install matplotlib\n   pip3 install pyautogui\n   ```\n\n3. **Run the Script:**\n\n   * Open **Terminal**, navigate to the script's directory, and run:\n\n     ```bash\n     python3 shopping_manager.py\n     ```\n\n---\n\n\n\nThis method does not require installing Python or dependencies on your local system, as everything will be handled by Docker.\n\n---\n\n## ✅ Setup Checklist\n\n* [x] Install Python 3\n* [x] Add Python to PATH (Windows)\n* [x] Open Terminal or Command Prompt\n* [x] Install `pyfiglet,pandas,matplotlib` with pip\n\n---\n\n## 🚀 How to Run\n\n1. **Windows:**\n\n   * **Double-click** the `shopping_manager.py` file to run the script on Windows.\n   * If double-clicking doesn't work (i.e., the terminal closes immediately), open **Command Prompt** or **PowerShell**, navigate to the script's directory, and run:\n\n     ```bash\n     python shopping_manager.py\n     ```\n\n2. **macOS and Linux (Debian/Ubuntu/Fedora):**\n\n   * Open **Terminal**, navigate to the script's directory, and run:\n\n     ```bash\n     python3 shopping_manager.py\n     ```\n\n   \u003e Use `python` if `python3` doesn't work on your system.\n\n---\n\n## 📂 File Management\n\n* The app saves shopping list items and their values in local `.csv` files.\n* Ensure you have read/write permissions in the script directory.\n\n---\n\n## 🧾 Example Use Case\n\n* Add items like `Milk`, `Eggs`, or `Bread`.\n* Assign values like cost or quantity.\n* Track total item count and sum of values.\n* Remove or update items as needed.\n\n---\n\n## 🧰 Troubleshooting\n\n* **Command not found**: Use `python3` or `pip3`.\n* **Permission denied**: Run as administrator or use `sudo` on GNU/Linux machines.\n* **pip not working**: Ensure Python is properly installed and in PATH.\n\n---\n\n## 📌 Notes\n\n* Works on Windows, macOS, and Linux.\n* Great for small shopping or budget tracking tasks.\n* Easy to expand or customize.\n\n---\n## Development Environment: Visual Studio Community Edition\n\nThe scripts were written and tested using **Visual Studio Community Edition**, a free and feature-rich integrated development environment (IDE) from Microsoft. While Visual Studio is widely used for C# and .NET development, it also provides excellent support for Python development through the **Python Development workload**, which includes tools like:\n\n- Python interpreter and virtual environment support  \n- Integrated terminal for running Python scripts  \n- Intelligent code completion (IntelliSense)  \n- Debugging tools  \n- Code navigation (go to definition, find references)\n\nVisual Studio Community Edition allows Python developers to take advantage of a full-fledged IDE with powerful features like **Git integration**, **unit testing support**, and **built-in code analysis** tools. It provides a solid foundation for developing Python applications related to shopping and inventory management while maintaining a professional, user-friendly environment.\n\nBy using Visual Studio Community Edition, developers can streamline the process of coding, debugging, and testing Python scripts in a single platform, making it an ideal choice for both beginners and experienced developers.\n\n\n## ⚠️ Compatibility Notes\n\nIf you're running the script on **macOS** or **Linux** (including **Fedora**, **Debian**, **Ubuntu**), you should **comment out** the following lines in the script:\n\n```python\n# os.system(\"cls\")  # Windows-specific clear screen\n# os.system(\"title shopping manager\")  # Set terminal window title (Windows)\n# os.system(\"color 05\")  # Change text color (Windows)\n```\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvetronics%2Fshopping_manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvetronics%2Fshopping_manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvetronics%2Fshopping_manager/lists"}