Skip to main content

Status Report - Comfortable CLI Activity Status Reporting

Project description

https://badge.fury.io/py/sniprd.svg https://travis-ci.org/kejbaly2/sniprd.svg?branch=master https://coveralls.io/repos/kejbaly2/sniprd/badge.svg https://img.shields.io/pypi/dm/sniprd.svg https://img.shields.io/pypi/l/sniprd.svg https://landscape.io/github/kejbaly2/sniprd/master/landscape.svg

Track your activities, comfortably.

DESCRIPTION

Comfortably archive snips of the stuff you get done. Compatible with status-report. Beautiful. Made for Humans.

EXAMPLES

Save a basic snippet with now() timestamp:

snip #home #car I went to the post-office to buy stamps

Save a snippet as completed yesterday:

snip yesterday #project_x reported 36 bugs in BZ, 14 in JIRA

Save a snippet as completed on a specific date in the past:

snip 2015-01-01 pushed 14 code #commits

Save a snippet and connect with others involved:

snip washed dads car today @philly @dad #allowance

Save multiple snippets at once completed the day before yesterday:

snip -1 #project_x did this; #private arrived 30m late

See snippet –help for complete list of available commands.

To retrieve your current week’s saved snippets, use status-report:

status-report --snippets project_x

To sync your current week’s saved snippets with a remote db:

snip sync project_x [https://kejbaly2.sniprd.com]

INSTALLATION

Install directly from Fedora/Copr repository or use PIP:

# Basic dependencies for buiding/installing pip packages
sudo yum install gcc krb5-devel
sudo yum install python-devel python-pip python-virtualenv

# Upgrade to the latest pip/setup/virtualenv installer code
sudo pip install -U pip setuptools virtualenv

# Install into a python virtual environment (OPTIONAL)
virtualenv --no-site-packages ~/virtenv_sniprd
source ~/virtenv_sniprd/bin/activate

# Install sniprd (sudo required if not in a virtualenv)
pip install sniprd

CONFIGURATION - sniprd

The config file ~/.sniprd is used to store general settings:

[general]
uri = ~/.sniprd.db  # DEFAULT

# push (sync) ALL sniprd to another db
[push]
uri = postgresql://user:pass@sniphub.com/shared
exclude_tags = ["private", "confidential"]
exclude_regex = ["secret_code", "fsck"]

# push sniprd with hashtag #home to another db
[push-home]
uri = postgresql://user:pass@server.com/db:5432

# email #project_x sniprd to someone
[push-project_x]
uri = email://get@it.done
include_tags = ["project_x"]

[at-philly]
uri = email://philly@cheeze.com

DOCKER INSTALL

To build and execute in a docker container, run:

make run_docker

See LINKS section below for more docker resources.

GIT COMMIT HOOKS

If you’re planning to make commits to this project, please enable the following git hooks:

# UPDATE according to the correct absolute git path
PATH = ~/sniprd/git-hooks
ln -s $(PATH)/pre-commit.py .git/hooks/pre-commit
ln -s $(PATH)/commit-msg.py .git/hooks/commit-msg

TESTS

To run tests using pytest:

# sudo required if not in a virtualenv
pip install pytest coveralls
coverage run --source=sniprd -m py.test source/tests
coverage report

AUTHORS

Chris Ward

Project details


Download files

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

Source Distribution

sniprd-0.1.1.1.tar.gz (13.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page