|
1 | | -# Voting-System---Python- |
2 | | -A Python-based console Voting System implementing candidate registration, secure vote casting, and result display using object-oriented programming and core data structures. |
| 1 | +# Voting System in Python |
| 2 | + |
| 3 | +A simple **Voting System** implemented in **Python**, simulating an electronic voting process with candidate registration, vote casting, and result display using **object-oriented programming**. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## Table of Contents |
| 8 | +- [Introduction](#introduction) |
| 9 | +- [Features](#features) |
| 10 | +- [Technologies Used](#technologies-used) |
| 11 | +- [Concepts Implemented](#concepts-implemented) |
| 12 | +- [Project Structure](#project-structure) |
| 13 | +- [Installation & Usage](#installation--usage) |
| 14 | +- [Screenshots](#screenshots) |
| 15 | +- [Conclusion](#conclusion) |
| 16 | +- [Author](#author) |
| 17 | + |
| 18 | +--- |
| 19 | + |
| 20 | +## Introduction |
| 21 | +Voting is one of the fundamental pillars of democracy. In the modern world, voting is increasingly done using digital systems. |
| 22 | +This project demonstrates a **console-based Voting System** in Python, where users can register candidates, cast votes, and view election results in a secure manner. |
| 23 | + |
| 24 | +--- |
| 25 | + |
| 26 | +## Features |
| 27 | +- **Candidate Registration**: Register candidates with unique IDs and names. |
| 28 | +- **Vote Casting**: Cast votes securely while ensuring each voter votes only once. |
| 29 | +- **Result Display**: View the total votes for each candidate. |
| 30 | +- **Input Validation**: Prevent duplicate candidates, invalid votes, and empty candidate names. |
| 31 | +- **Interactive CLI**: Menu-driven console interface for easy navigation. |
| 32 | + |
| 33 | +--- |
| 34 | + |
| 35 | +## Technologies Used |
| 36 | +- **Programming Language**: Python 3 |
| 37 | +- **Data Structures**: `dict` (for candidates and votes), `set` (for voter tracking) |
| 38 | +- **Execution Environment**: CLI (Command-Line Interface), platform-independent |
| 39 | + |
| 40 | +--- |
| 41 | + |
| 42 | +## Concepts Implemented |
| 43 | +- Object-Oriented Programming (OOP) |
| 44 | +- Conditional Statements (`if`, `elif`, `else`) |
| 45 | +- Loops (`while True`) for menu-driven interface |
| 46 | +- Functions and Methods for modular design |
| 47 | +- Input validation and error handling |
| 48 | +- Data integrity using Python core libraries |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +## Project Structure |
| 53 | + |
| 54 | +VotingSystem/ |
| 55 | +├── voting_system.py # Main program with VotingSystem class and CLI |
| 56 | +├── README.md # Project documentation |
| 57 | +└── screenshots/ # Folder containing output screenshots |
| 58 | + |
| 59 | +--- |
| 60 | + |
| 61 | +##Installation & Usage |
| 62 | + |
| 63 | +**Clone the repository:** |
| 64 | + |
| 65 | +git clone <your-repo-url> |
| 66 | + |
| 67 | + |
| 68 | +**Navigate to the project folder:** |
| 69 | + |
| 70 | +cd VotingSystem |
| 71 | + |
| 72 | + |
| 73 | +**Run the Python program:** |
| 74 | + |
| 75 | +python voting_system.py |
| 76 | + |
| 77 | + |
| 78 | +**Follow the on-screen menu to:** |
| 79 | + |
| 80 | +-Register candidates |
| 81 | +-Cast votes |
| 82 | +-Display results |
| 83 | +-Exit the system |
| 84 | + |
| 85 | +--- |
| 86 | + |
| 87 | +#Conclusion: |
| 88 | + |
| 89 | +This project provides a simple yet effective simulation of an electronic voting system. |
| 90 | +It demonstrates core Python programming concepts such as OOP, data structures, input validation, and modular programming while creating a practical application. |
| 91 | + |
| 92 | +--- |
| 93 | + |
| 94 | +#Author |
| 95 | + |
| 96 | +**Balaji P** |
| 97 | +B.C.A. Batch 1 |
| 98 | +Project Submitted for Programming in Python course |
| 99 | + |
| 100 | +--- |
0 commit comments