Shopping List CLI

This project was developed as part of my intensive study of Python programming fundamentals, consolidating two full days of focused practice.

Topics Covered

• Variable Declaration and Assignment
• Data Types
• Arithmetic Expressions and Operators
• Expression Building and Comparison Operators
• Code Styling Following PEP8 Standards
• Selection Statements (if, else)
• Loops (while, for)
• Function Creation and Usage (with parameters and returns)
• String Manipulation
• List Management
• Dictionary Management
• Input Validation and Sanitization
• Error Handling (try/except)
• Professional Docstring Documentation
• Modular Code Structure
• User Input Handling Function
• Item Update Functionality
• Menu Navigation Using Dictionary Mapping

About the Project

The Shopping List CLI is a command-line application that allows users to:

• Add multiple items to a shopping list with quantity tracking
• Remove items from the shopping list
• Update the quantity of an existing item
• View all items and quantities currently listed
• Handle and validate user input gracefully through a dedicated input handling function
• Navigate the menu using a dictionary structure that maps user choices directly to functions, improving code clarity and organization
• Structure the code using modular functions, with parameters and return values
• Follow professional clean coding practices and documentation standards

Technologies Used

• Python 3.12
• Terminal / CLI

How to Run the Project

1. Clone the repository:

git clone git@github.com:castilhomarcos/shopping-list-cli.git

1. Navigate to the project folder:

cd shopping-list-cli

1. Run the script:

python3 main.py

---

Project Structure

• main.py → Main script containing the core logic and functions
• README.md → Project documentation
• .gitignore → Configuration file to ignore system and IDE-specific files

---

Author

Marcos Antonio de Castilho Junior
Technology and Programming Student | GitHub: @castilhomarcos

This project was developed as part of my personal journey to master Python fundamentals and Git/GitHub version control best practices.