Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

An easy to use CLI for the Pomodoro Technique.

Project description

Pyomodoro

Pyomodoro is an easy to use CLI for the Pomodoro Technique written in Python.

GitLab pipeline PyPI - Downloads PyPI - License PyPI - Version PyPI - Python Version PyPI - Wheel PyPI - Status

Installation

The best way to install Pyomodoro is to use Pip.

pip install pyomodoro

Usage

For convenience, both pom and pyomodoro are available as commands. Pyomodoro operates in your terminal, but if a notification tool is available, Pyomodoro will also send messages that way.

# Display help text
pom --help
pyomodoro --help

# Begin a session with the standard Francesco Cirillo timing intervals
pom

# Specify a task to focus on before you begin work
pom --ask-task

# Adjust the timing intervals to your liking
pom --pomodoro-length 30 --short-break-length 10 --long-break-length 45

Configuration

There are three ways to adjust the values that Pyomodoro uses. In order of precedence:

  1. Flags at run time
  2. Environment variables
  3. YAML config file
Flag Env Var YAML Default
--ask-task, -t POM_ASK_TASK ask_task False
--config-file, -f POM_CONFIG_FILE ~/.pyomodoro
--dry-run, -d dry_run False
--language, -l POM_LANGUAGE language
--long-break-length, -lb POM_LONG_BREAK_LENGTH long_break_length 20
--pomodoro-length, -p POM_POMODORO_LENGTH pomodoro_length 25
--short-break-length, -sb POM_SHORT_BREAK_LENGTH short_break_length 5

Contributing

Merge requests are welcome after opening an issue first. Please make sure to update tests as appropriate.

Development

Since part of Pyomodoro's key feature relies on an accessible notification system, testing that necessitates installing it locally:

pip install -e .

It is also useful to double check how Pyomodoro functions in a containerized environment, as the required tests are run in Docker containers:

docker run -it -v ${pwd}:/app python bash
cd /app
pip install tox
tox -e py

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyomodoro, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size pyomodoro-1.0.0-py3-none-any.whl (17.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pyomodoro-1.0.0.tar.gz (19.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page