Oyna 💃🏻🕺🏻💃🏿🕺🏿💃🕺

Welcome to the Oyna repository! 🎮

This repository is dedicated to showcasing a collection of simple and fun computer games, all implemented in Python. The main goal of Oyna is to provide a platform where anyone, can explore Python programming through engaging and interactive games. By studying and interacting with these games, you can learn important programming concepts, algorithms, and the Python language in an enjoyable and hands-on way.

Whether you're just starting with Python or looking to improve your coding skills, the Oyna repository is a great resource to help you learn while having fun.

What You'll Find Here

This repository contains various games that highlight different aspects of Python programming. Each game is designed to be simple yet effective, and they are all easy to understand and modify.

Sudoku	2048	Matching
Minesweeper	Find Difference	Maze
Chimp	Snake	Chutes and Ladders
Dino or Dinosaur Game	Bubble Shooter	Flappy Bird
Falling Tower	Shoot Colors	Reversi
SuperMario Pixel	Tetris	Tik Tok Toe
Reverse Slide Puzzle	Checkers	UFO Explosion

Why Oyna?

• Beginner-Friendly: Whether you're new to Python or programming in general, these games are designed to be easy to follow.
• Learn by Doing: The best way to learn programming is through practice, and Oyna offers you an opportunity to get hands-on experience by working with real code.
• Fun and Engaging: Who said learning can't be fun? These games are built to keep you engaged and motivated while learning Python.

How to Use

1. Clone this repository to your local machine using:

   git clone https://github.com/kamyarmg/oyna.git

   Run & Contribute

   • Python version: This project requires Python >= 3.10.

   • Create venv: create and activate a virtual environment:

     python3 -m venv .venv
     source .venv/bin/activate

   • Install package + dev dependencies: installs the package editable and developer extras (includes pynput and pre-commit):

     python -m pip install --upgrade pip
     pip install -e '.[dev]'

   • Install pre-commit hooks (after installing dev deps):

     pre-commit install

   • Run a single game (examples): many games expose a runnable grid_base.py with a __main__ guard. Run a specific game as a module. Examples:

     # Run Sudoku
     python -m oyna.sudoku.grid_base
     
     # Run Snake
     python -m oyna.snake.grid_base
     
     # Run Flappy Bird
     python -m oyna.flappy_bird.grid_base

   • About pynput: input handling uses pynput (declared in pyproject.toml). On Linux ensure an X server or desktop session is available — pynput needs access to the system input devices.

   OR Install it using pip

   pip install oyna

2. Navigate to the game directory you want to explore.

3. Run the game using Python

4. Enjoy and start learning!

---

To add or refactor a game or any other feature, please read the CONTRIBUTING.md file first. After that, you can create a new game or make changes and submit a pull request.