Chess CLI
Thanks for opening.
A chess game that you can play in your terminal! I made this project to get experience in building a application in dev-professional way with project structure and industry standard practices and to also understand how to pushlish a python package to the INTERNET.
Features
- you can paly chess in your terminal, FYI this is does not contain full piece movements and rules, but most of them are implemented
Installation
From PyPI (Recommended)
pip install kesav-chess-cli
From Source
git clone https://github.com/saikesav-sai/chess_cli.git
cd chess_cli
pip install -e .
Requirements
- Python 3.9 or higher
- colorama (automatically installed with the package)
Usage
After installation, simply run:
chess-cli
How to Play
- The game starts with the standard chess board setup
- Players alternate turns (Yellow starts first)
- Enter moves in the format:
source destination(e.g.,e2 e4) - Press
qto quit the game at any time
Input Format
Moves are entered using chess notation:
- Columns:
athroughh(left to right) - Rows:
1through8(bottom to top)
Project Structure
chess_cli/
├── src/
│ └── chess_cli/
│ ├── play_chess.py # Main game entry point
│ ├── Board/
│ │ └── build.py # Board initialization
│ └── Game_Engine/
│ ├── runner.py # Game loop and logic
│ ├── static_variables.py
│ ├── Error_handler/ # Error handling modules
│ ├── Game_Rules/ # Chess rules validation
│ └── Game_utils/ # Utility functions
├── tests/ # Unit tests
├── pyproject.toml # Project configuration
└── README.md
Running Tests
python -m pytest tests/
License
This project is licensed under The GNU GENERAL PUBLIC LICENSE.
Author
Sai Kesav
- Email: saikesav67254@gmail.com
- GitHub: @saikesav-sai
- portfolioi: saikesav.tech
Made with ❤️ by ME
Metadata
Release files for kesav-chess-cli 1.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| kesav_chess_cli-1.1.3.tar.gz | 10.2 kB | Without provenance | Details for kesav_chess_cli-1.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| kesav_chess_cli-1.1.3-py3-none-any.whl | Python 3 | none | any | Details for kesav_chess_cli-1.1.3-py3-none-any.whl |
Total release size: 22.5 kB
Release files / kesav_chess_cli-1.1.3.tar.gz
| Download URL | kesav_chess_cli-1.1.3.tar.gz |
|---|---|
| Size | 10.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ec75f329864daa55acc404cb3ffe6f85760e8b24bc2035ea515c14d06ebd9ceb
|
|
BLAKE2b-256 checksum How to use checksums |
2497827dbf2e81cdf87c224614e7d0a4ce5ff18cf24cecbe5ec93211124c8203
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.19
|
Release files / kesav_chess_cli-1.1.3-py3-none-any.whl
| Download URL | kesav_chess_cli-1.1.3-py3-none-any.whl |
|---|---|
| Size | 12.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7e239fb666d36acda15326bbe4a7dbd0b1557c4a96fb85fcd8f68d7141c9776e
|
|
BLAKE2b-256 checksum How to use checksums |
2133abf2efe270b182507167b55ea9dd02d0fd28c5af944f298866aba6ae88ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.19
|
Security for kesav-chess-cli 1.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.