peck 2.4.4

simple notes on the command line

peck 🐤

is a command line tool that allows you to take notes across directories without cluttering your work spaces.

install:

pip install peck

using:

peck [command] [keyword (if appropriate)]
or for a quick entry:
peck [entry]

how everything works:

notes are formatted as follows:

Sat 04:48PM Sep 19 2020
-----------------------
this is a peck note 
#*#*#*#*#*#*#*#*#*#*#*#

each file can contain any number of notes.

all of your notes are stored in your home directory in a folder called pck. when you run peck from a new location, a folder is created inside peck that references this location. for example, if your shell points to You/Desktop, running peck [note] will add an entry to a You_Desktop folder in home/peck. peck recognizes the directory from where you are taking notes, but leaves the location itself untouched. this allows you to take notes without the worry of cluttering your work spaces.

to create a new collection file, run a command. the default file name is peck.txt, but you can run peck -s [new_name] to set a new default name. running peck -l will print a header with useful information on the files in your peck folder.

config attributes allow various changes to how peck formats your notes. this file is generated with peck -config, or when peck -s [new file] is run. for example, if you want a note's date header to be underlined differently, this attribute can be modified. if you want a different string to mark the end of an entry, this can be modified. it should be noted that changing things integral to how the program functions, such as an entry end marker, will outdate the path you are working in. specifications on what is safe to update in an existing path are included in the config file itself (peck.ini).

suggestions for use: to-do list, dream journal, version note manager, recipe experimentation database, anything that you want to keep track of paired with the time you remembered to record it

commands:

'-l': list out information about paths in use '-n': new entry with both first and second sections
'-n1': new entry with first section
'-n2': new entry with second section
'-nt': new entry using a textbox. ignores config file preferences
'-a': new tagged entry. syntax: peck -a [tag] [entry]
'-v': view entries. syntax: peck -v // peck -v [keyword]
'-vf': view a difference collection in the same path. format: 'peck -vf: [collection name][opt keyword]'
'-ds': view entries on a specific date. format: 'peck -ds [mm/dd/yy]'
'-t': search for entries with a tag
'-wipe': delete current default
'-wipe-all': delete folder referencing this location
'-b': create backup of collection
'-load': load entries from backup
'-config': generate config file in pwd. if config exists, defaults reset. updating config may outdate peck
'-s': specify default collection file. does not modify existing files. modifes / creates config file.
'-del': delete entry
'-q': quick delete the last entry made

build with pyinstaller:

1.) pyinstaller [options] __main__.py
2.) (optional) copy google_api_python_client-1.12.1.dist-info folder to [project]/bin/[os]/[peck] directory to allow for google drive support (note: not implemented in current builds / source. check issue #3 for more information)