Skip to content

an algorithm that randomly assigns people to a spot in the openspace.

Notifications You must be signed in to change notification settings

JonbeshAhmadzai/challenge-openspace-classifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OpenSpace Organizer πŸͺ‘πŸŽ²

πŸ“Œ Description

OpenSpace Organizer is a small Python project built using Object-Oriented Programming (OOP).

The program reads a list of colleagues from an Excel file (.xlsx), randomly assigns them to seats in an openspace (tables + seats), and exports the final seating plan into a new Excel file.

This project is meant as an exercise to practice:

  • Python OOP (classes and objects)
  • Working with multiple modules
  • Reading and writing Excel files using pandas
  • Clean project structure

🏒 Openspace Layout

The openspace is configured like this:

  • 6 tables
  • 4 seats per table
  • Total: 24 seats

🎯 Objectives

This project was made to practice:

  • Clean OOP structure (Table / OpenSpace)
  • Working with multiple Python modules
  • Using imports correctly
  • Reading Excel files with pandas
  • Exporting results into an Excel file
  • Writing clean Python code

🧠 Program Behavior

βœ… If there are more than 24 colleagues

If the input file contains more than 24 names, the program will seat the first 24 randomly and will print a message for the remaining people: No seat left for: NAME βœ… If there are fewer than 24 colleagues

If the input file contains less than 24 names, the program will seat everyone and leave the remaining seats empty.

πŸ“ Project Structure

β”œβ”€β”€ README.md
β”œβ”€β”€ main.py
β”œβ”€β”€ .gitignore
└── utils/
    β”œβ”€β”€ file_utils.py
    β”œβ”€β”€ openspace.py
    └── table.py



About

an algorithm that randomly assigns people to a spot in the openspace.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages