Skip to main content

just-start

Build Status Coverage Status

An app to defeat procrastination!

Introduction

Just-Start is a to-do list application and productivity booster. It prevents you from procrastinating (too much).

The program is a wrapper for TaskWarrior with a timer implementing the Pomodoro Technique (time management). It also draws a bit of inspiration from Omodoro.

Features:

  • Configurable pomodoro phase durations

  • Support for multiple configurations (a.k.a. locations) based on the current time and day of the week

  • Desktop notifications

  • Block time-wasting sites while you’re working

Installation and usage

Supported platforms:

  • Linux

  • macOS

Requirements:

Pick a client name from the table below and run:

$ pip install just-start[<client_name>]
$ just-start-<client_name>

So for the urwid client:

$ pip install just-start-urwid
$ just-start-urwid

Press h to see a list of available user actions.

Clients

Name

Framework

Notes

urwid (recommended)

Urwid

Inspired by Calcurse. Similar to a graphical application, but in your terminal

term

Terminal (none)

Example client. Useful for seeing how to write a brand new one but not intended for continuous usage

Development

If you want to help out please install Poetry, clone the repo and run:

$ cd just-start/
$ poetry install

This will ensure you have both the development and install dependencies.

You can also install the package in editable mode to test manually without having to run a build after every change, but you’ll need to generate a setup.py since projects using pyproject.toml alone can’t be used this way (see the note about editable mode in PEP517 for more info). I use Dephell for this:

$ cd just-start
$ dephell deps convert --from=pyproject.toml --to=setup.py
$ pip install -e just_start

Bug reports

Issues are tracked using GitHub Issues

Running Tests

You just need Poetry and Tox

$ tox

Metadata

Release files for just-start 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for just-start 0.5.2
File Size Uploaded Provenance Actions
just-start-0.5.2.tar.gz 24.9 kB Without provenance Details for just-start-0.5.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for just-start 0.5.2
File Interpreter ABI Platform Actions
just_start-0.5.2-py3-none-any.whl Python 3 none any Details for just_start-0.5.2-py3-none-any.whl

Total release size: 51.6 kB

Release files / just-start-0.5.2.tar.gz

Download URL just-start-0.5.2.tar.gz
Size 24.9 kB
Tags Source
SHA-256 checksum
How to use checksums
34f0fa99196631db68ddc8c52c4a5d1ed623a573eb01191eba620c89ba16b9d0
BLAKE2b-256 checksum
How to use checksums
0664fc5ea0ea3f8deb862f2fddc5e8535d25169f3c5fb5bba3bd70fac5c0130c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.12 CPython/3.10.1 Linux/5.15.12-arch1-1

Release files / just_start-0.5.2-py3-none-any.whl

Download URL just_start-0.5.2-py3-none-any.whl
Size 26.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
454bbc5f1bb29957b0d39cae48445fb582751f2ef63847ed4180d55e6e3b72c5
BLAKE2b-256 checksum
How to use checksums
e4a3051c4adf5669fe834f195c8d15eed80219bfb47c0fc9b86e6b26fd58deaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.12 CPython/3.10.1 Linux/5.15.12-arch1-1

Security for just-start 0.5.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page