# 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 pip (Recommended)
```bash
pip install terminal-stopwatch
```
Then run:
```bash
stopwatch
```
### Using Executable
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)
Raw data
{
"_id": null,
"home_page": "https://www.taejun.lol",
"name": "terminal-stopwatch",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.11",
"maintainer_email": null,
"keywords": "stopwatch, terminal, ascii-art, timer",
"author": "taejun",
"author_email": "dugudugu0622@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9e/4b/b805c7ca84e744e48c8442e827f43022bcb1957db7fdb582037dc3ffced6/terminal_stopwatch-1.0.0.tar.gz",
"platform": null,
"description": "# Terminal Stopwatch\n\nA terminal-based stopwatch application featuring ASCII art display.\n\n## Features\n\n- \u23f1\ufe0f Time Measurement\n- \ud83c\udfaf Lap Time Recording\n- \ud83c\udfa8 ASCII Art Time Display\n- \ud83c\udf08 Colorful Terminal Interface\n\n## Installation\n\n### Using pip (Recommended)\n\n```bash\npip install terminal-stopwatch\n```\n\nThen run:\n```bash\nstopwatch\n```\n\n### Using Executable\n\n1. Download the `stopwatch` executable from the latest release\n2. Grant execution permission in terminal:\n ```bash\n chmod +x ./stopwatch\n ```\n3. Run:\n ```bash\n ./stopwatch\n ```\n\n### From Source Code\n\n1. Clone the repository:\n ```bash\n git clone https://github.com/yourusername/stopwatch.git\n cd stopwatch\n ```\n\n2. Install Poetry (Package Manager):\n ```bash\n curl -sSL https://install.python-poetry.org | python3 -\n ```\n\n3. Install dependencies:\n ```bash\n poetry install\n ```\n\n4. Run:\n ```bash\n poetry run python main.py\n ```\n\n## Usage\n\nUse the following keys to control the stopwatch:\n\n- `s`: \ud83d\ude80 Start/Pause\n- `l`: \ud83d\udcdd Record Lap Time\n- `r`: \ud83d\udd04 Reset\n- `q`: \ud83d\udeab Quit\n\n## Development Environment\n\n- Python 3.11+\n- Poetry (Dependency Management)\n- PyInstaller (Executable Creation)\n\n## Dependencies\n\n- pyfiglet: ASCII Art Generation\n- colorama: Terminal Color Support\n- readchar: Keyboard Input Handling\n\n## License\n\nMIT License\n\n## Contributing\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## Author\n\n- taejun (dugudugu0622@gmail.com) ",
"bugtrack_url": null,
"license": null,
"summary": "A terminal-based stopwatch application featuring ASCII art display",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://www.taejun.lol",
"Repository": "https://github.com/taejun0622/stopwatch"
},
"split_keywords": [
"stopwatch",
" terminal",
" ascii-art",
" timer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b8915d4617b2df23df8319ee66994829799c8e6e1326ec9f9a0ff300f125c9f2",
"md5": "6d741a8f87a04ad7b2126120cb43342e",
"sha256": "5fefd1aa68920361a5fd23215e208b8562f01863277803265f3e2bfc65d56b5f"
},
"downloads": -1,
"filename": "terminal_stopwatch-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6d741a8f87a04ad7b2126120cb43342e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.11",
"size": 5035,
"upload_time": "2025-02-20T02:33:22",
"upload_time_iso_8601": "2025-02-20T02:33:22.090475Z",
"url": "https://files.pythonhosted.org/packages/b8/91/5d4617b2df23df8319ee66994829799c8e6e1326ec9f9a0ff300f125c9f2/terminal_stopwatch-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9e4bb805c7ca84e744e48c8442e827f43022bcb1957db7fdb582037dc3ffced6",
"md5": "5e8966afb11954c11bc9dfb63e687582",
"sha256": "fdeb4ad8662a6adf7862bb1fdf89d81c1bc646a2e4137dec44697b5119e9ba32"
},
"downloads": -1,
"filename": "terminal_stopwatch-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "5e8966afb11954c11bc9dfb63e687582",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.11",
"size": 4140,
"upload_time": "2025-02-20T02:33:23",
"upload_time_iso_8601": "2025-02-20T02:33:23.817598Z",
"url": "https://files.pythonhosted.org/packages/9e/4b/b805c7ca84e744e48c8442e827f43022bcb1957db7fdb582037dc3ffced6/terminal_stopwatch-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-20 02:33:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "taejun0622",
"github_project": "stopwatch",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "terminal-stopwatch"
}
JSON
