Metadata-Version: 2.1
Name: py-pomo
Version: 1.0b0
Summary: A simple CLI pomodoro timer
Home-page: https://github.com/BasicPixel/py-pomo
Author: Osama AlQudah
Author-email: osama.mo.qudah@gmail.com
License: MIT
Keywords: pomodoro,click,cli
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
License-File: LICENSE

# py-pomo

A simple CLI [pomodoro](https://en.wikipedia.org/wiki/Pomodoro_Technique) timer, made with Python w/[Click](https://click.palletsprojects.com/).

All contibutions are welcome.

---

- [py-pomo](#py-pomo)
  - [Usage](#usage)
  - [Examples](#examples)
  - [Todo](#todo)

## Usage

```shell
git clone https://github.com/BasicPixel/py-pomo.git # Clone this repo
cd py-pomo

virtualenv venv # Start a virtualenv (on unix systems, requires virtualenv package)
. venv/bin/activate

pip install --editable . # Install the package

pomo --help # Run the script
```

## Examples

Start a 25-minute pomo timer:

```shell
pomo
```

Start a timer for 30 seconds:

```shell
pomo -s -d 30

# Or
pomo --in-seconds --duration 30
```

Start a 10-minute timer, with minimal output (MM:SS):

```shell
pomo -m -d 10

# Or
pomo --minimal --duration 10
```

---

Learn more about the available options by running:

```shell
pomo --help
```

## Todo

- [ ] Save configuration to a file
- [ ] Publish to PyPI
- [ ] Test on different environments


