Metadata-Version: 2.4
Name: kuroki-algorithm-toolkit
Version: 0.1.1
Summary: A command-line toolkit for practicing Python algorithms
Author: Kuroki
Project-URL: Repository, https://github.com/inmaginebreaker-beep/algorithm-toolkit
Project-URL: Issues, https://github.com/inmaginebreaker-beep/algorithm-toolkit/issues
Keywords: algorithms,data-structures,cli,education
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: python-dotenv>=1.0
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: twine; extra == "dev"

# Algorithm Toolkit

一个用于学习 Python 算法、项目结构和软件工程实践的项目。

## Features

- Two Sum
- Find Max
- Reverse Array

## Requirements

- Python 3.10+

## Installation

Clone the repository:
powershell
git clone https://github.com/inmaginebreaker-beep/algorithm-toolkit.git
cd algorithm-toolkit

## Create and activate a virtual environment:

python -m venv .venv
.\.venv\Scripts\activate

## Install the project:

python -m pip install -e .

## Install development dependencies:

python -m pip install -e ".[dev]"

## Usage

from algorithm_toolkit.algorithms.array import two_sum

result = two_sum([2, 7, 11, 15], 9)
print(result)

## Run

python -m algorithm_toolkit.main

## Project Structure

algorithm-toolkit/

├── src/

│   └── algorithm_toolkit/

│       ├── __init__.py

│       ├── main.py

│       └── algorithms/

│           ├── __init__.py

│           └── array.py

├── tests/

├── .gitignore

├── pyproject.toml

└── README.md

## License

This project is for educational purposes.

## Code Quality

Format the project:

```powershell
ruff format .
```

## Run static checks:
    
```powershell
ruff check .
```

## Verify formatting without modifying files:

```powershell
ruff format --check .
```

## Architecture

The project separates responsibilities into three layers:

- `main.py`: application entry point and top-level error handling
- `application/`: orchestration and input validation
- `algorithms/`: reusable algorithm implementations

## Quality Checks

```powershell
ruff format --check .
ruff check .
mypy
pytest



