https://github.com/barbaraeguche/electronic-voting-system

🗳️ a voting system with capabilities for casting votes, viewing results, and adding new candidates.
https://github.com/barbaraeguche/electronic-voting-system

cli dsa election

Last synced: about 2 months ago
JSON representation

🗳️ a voting system with capabilities for casting votes, viewing results, and adding new candidates.

• Host: GitHub
• URL: https://github.com/barbaraeguche/electronic-voting-system
• Owner: barbaraeguche
• License: mit
• Created: 2024-11-09T17:07:18.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-14T04:18:33.000Z (over 1 year ago)
• Last Synced: 2025-12-13T02:50:57.715Z (7 months ago)
• Topics: cli, dsa, election
• Language: Python
• Homepage:
• Size: 13.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: license

Awesome Lists containing this project

README

          
# electronic voting system 🗳️

a minimal voting system that offers candidate listings, user voting capabilities, real-time result displays, and the option to add new candidates seamlessly.

## features 👾

- **candidate display:**  displays a list of eligible candidates for voting.

- **voting process:** allows users to cast their votes, maintaining integrity.

- **add candidates:** enables the addition of new candidates to the existing list.

- **results overview:** displays a comprehensive list of electoral results, accounting for ties.

- **terminate system:** gracefully exits the voting system with a closing message.

## limitations 🚨

- **candidate ids**: the system currently lacks validation to ensure the uniqueness of candidate ids, which may lead to potential conflicts in data management.

- **input validation**: the input validation mechanism is limited to recognizing only the format of `id, name` separated by a `;`. it does not accommodate alternative input formats, which could restrict user flexibility.

- **user interface**: the user interface may become cluttered when displaying longer candidate ids and names, impacting overall readability and user experience.

## running the project 🏁

to get the project up and running on your local machine, follow these steps:

- **ensure python is installed:** must have [python version ^3.11](https://www.python.org/downloads/) installed.

- **clone the repository:**

```bash

git clone https://github.com/barbaraeguche/electronic-voting-system.git

```

- **navigate to the project directory:**

```bash

cd electronic-voting-system

```

- **run the project:**

```bash

python3 driver.py

```

## gallery 📸

  showcase

  - **initial run**


  ![init](https://github.com/user-attachments/assets/b68d8559-373f-4c4e-9df3-ca07c97d9975)

  - **option 1**


  ![option 1](https://github.com/user-attachments/assets/507c5bac-1271-4499-bbf3-03c55c9e43fe)

  - **option 2**


  ![option 2](https://github.com/user-attachments/assets/53337cd7-1d63-4ca3-81c8-e522c46b4b2e)

  - **option 4**


  ![option 4](https://github.com/user-attachments/assets/f4705505-81e7-4e82-ad17-4e8d388e5261)