The software development log to reflect and capture your thoughts, progress and TODOs.
Devlog's goal is to help you create a "Development Log" to reflect and generate notes after a coding session.
Devlog generates a simple markdown file to a directory you specify which gives you alot of flexibility. You can save your log files into a git repository or to a cloud file service directory like dropbox, google drive, or one drive for automated syncing and backup.
Devlog prioritizes:
- Open standards over closed. Keep your notes in markdown files that can be queried for easily in a directory, not locked into some vendors service or custom formatting standards.
- Ease of use and simplicity. This is not meant to be a complex static content generator. It strives to be an easy to configure and create log files to fill out in a text editor of your choice.
By default devlog
will generate a file in the current directory unless specify the directory via setting the environment variable DEVLOG_DIR
.
Configuration using environment variables:
Set the directory to save devlog files to:
export DEVLOG_DIR="/home/your_username/your_directory"
You can override this by temporarily setting the value when calling devlog
DEVLOG_DIR="/home/your_username/other_directory" devlog
Configuration using command line options:
You can also pass in configurations via command line options. Command line options take precedence over configurations set via environment variables.
devlog -p "/home/your_username/your_directory" -c "/home/your_username/your_directory/custom-config.yaml"
To view all the possible command line options, just pass in the -h
command line option for help e.g. devlog -h
Prerequisites:
- go lang version 1.13
Simply clone this repository and run the following command to build the binary:
make build
This will create a binary locally you can run commands against already, like so:
./devlog
Build and copy the binary to your local bin to access the CLI anywhere. It will likely prompt you for a password since it's needed to install things to your /usr/local/bin
.
make install
Now you can run the command devlog
from anywhere to generate a new devlog file:
devlog
2019/09/02 22:00:32 Successfully saved dev log to directory: /home/dev/null
Currently working on building binaries automatically and uploading them as releases to ease installation.