Friendly Reminder

This CLI app wants to help you stay in touch with your friends.

Installation

pip install friendly-reminder

Usage

Here's a quick overview on how this tool is meant to be used.

# Add a reminder for Mom and Omar Cabbage.
$ friendly-reminder add --name "Mom"
Added Mom succesfully.
$ friendly-reminder add --name "Omar Cabbage"
Added Omar Cabbage succesfully.

# Check if there are any reminders for today.
$ friendly-reminder check
Nothing for today.
# See the list of upcoming check-ins.
$ friendly-reminder check --all
Think about contacting:
Mom (7 days)
Omar Cabbage (7 days)

# Set the date where we last contacted Omar Cabbage.
$ friendly-reminder update --name "Omar Cabbage" --last-contact 2022-03-27
Updated Omar Cabbage succesfully.

# Recheck our reminders for today.
$ friendly-reminder check
Think about contacting:
Omar Cabbage (-9 days)

# I've talked to Omar today.
$ friendly-reminder renew --name "Omar Cabbage"
Updated Omar Cabbage succesfully.

# 'Unfriend' mom. Don't try this at home. ;-)
$ friendly-reminder remove --name Mom
Removed Mom succesfully.

# Use --help if you are stuck.

You can easily automate check with a cronjob, i.e. if you've got Termux installed on your Android phone:

crontab -e
# The following line will send you a notification every morning at 9.
# 0 9 * * * friendly-reminder check | termux-notification --title Friendly-Reminder

Developer setup

# (optional) Create a new virtual environment for python
python3 -m venv env
source env/bin/activate

# Install dependencies
pip3 install -r requirements.txt

# Initialise the config directory
mkdir $HOME/.config/friendly-reminder

# Run
python3 main.py

Install from source

python setup.py install

Package

pip install twine
pip install wheel

# Build the packages
python setup.py sdist bdist_wheel

# Validate the packages
twine check dist/*

# Upload the packages to test.pypi.org
twine upload --repository-url https://test.pypi.org/legacy/ dist/*

# Upload the package to pypi.org
twine upload dist/*