Metadata-Version: 2.1
Name: terminal-stopwatch
Version: 0.1.2
Summary: A terminal-based stopwatch application featuring ASCII art display
Home-page: https://github.com/yourusername/stopwatch
Keywords: stopwatch,terminal,ascii-art,timer
Author: taejun
Author-email: dugudugu0622@gmail.com
Requires-Python: >=3.11,<3.14
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Dist: colorama (>=0.4.6,<0.5.0)
Requires-Dist: keyboard (>=0.13.5,<0.14.0)
Requires-Dist: pyfiglet (>=1.0.2,<2.0.0)
Requires-Dist: pyinstaller (>=6.12.0,<7.0.0)
Requires-Dist: readchar (>=4.2.1,<5.0.0)
Project-URL: Repository, https://github.com/yourusername/stopwatch
Description-Content-Type: text/markdown

# Terminal Stopwatch

A terminal-based stopwatch application featuring ASCII art display.

## Features

- ⏱️ Time Measurement
- 🎯 Lap Time Recording
- 🎨 ASCII Art Time Display
- 🌈 Colorful Terminal Interface

## Installation

### Using Executable (Recommended)

1. Download the `stopwatch` executable from the latest release
2. Grant execution permission in terminal:
   ```bash
   chmod +x ./stopwatch
   ```
3. Run:
   ```bash
   ./stopwatch
   ```

### From Source Code

1. Clone the repository:
   ```bash
   git clone https://github.com/yourusername/stopwatch.git
   cd stopwatch
   ```

2. Install Poetry (Package Manager):
   ```bash
   curl -sSL https://install.python-poetry.org | python3 -
   ```

3. Install dependencies:
   ```bash
   poetry install
   ```

4. Run:
   ```bash
   poetry run python main.py
   ```

## Usage

Use the following keys to control the stopwatch:

- `s`: 🚀 Start/Pause
- `l`: 📝 Record Lap Time
- `r`: 🔄 Reset
- `q`: 🚫 Quit

## Development Environment

- Python 3.11+
- Poetry (Dependency Management)
- PyInstaller (Executable Creation)

## Dependencies

- pyfiglet: ASCII Art Generation
- colorama: Terminal Color Support
- readchar: Keyboard Input Handling

## License

MIT License

## Contributing

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## Author

- taejun (dugudugu0622@gmail.com) 
