Skip to content

Commit e733909

Browse files
authored
Update README.md
1 parent bad6f56 commit e733909

File tree

1 file changed

+100
-2
lines changed

1 file changed

+100
-2
lines changed

README.md

Lines changed: 100 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,100 @@
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

Comments
 (0)