CONTRIBUTING.md

Contributing

First off, thank you! Please follow along.

You need to fork this repository & clone it onto your system. Inside the cloned folder, create a .env file with the following contents (without # comments):

INPUT_GH_TOKEN=EXAMPLE_GITHUB_PAT # required (for development)
INPUT_WAKATIME_API_KEY=EXAMPLE-WAKATIME-API-KEY # required
INPUT_API_BASE_URL=https://wakatime.com/api # required
INPUT_REPOSITORY=GITHUB_USERNAME/REPOSITORY_NAME # required
INPUT_COMMIT_MESSAGE=Updated WakaReadme graph with new metrics
INPUT_SHOW_TITLE=true
INPUT_SECTION_NAME=waka
INPUT_BLOCKS=->
INPUT_SHOW_TIME=true
INPUT_SHOW_TOTAL=true
INPUT_TIME_RANGE=last_7_days
INPUT_SHOW_MASKED_TIME=false
INPUT_LANG_COUNT=0
INPUT_STOP_AT_OTHER=true
INPUT_IGNORED_LANGUAGES=

NEVER commit this .env file!

Using containers (recommended)

Assumes that you already have latest version of either podman or docker (with compose) installed & configured.

Replace podman with docker everywhere, if you're using the latter.

# Build and watch logs
$ podman-compose -p waka-readme -f ./docker-compose.yml up
# Cleanup
$ podman-compose -p waka-readme -f ./docker-compose.yml down

---

Using virtual environments

Assumes you've already installed & configured latest version of python.

1. Inside the cloned folder run the following commands to install dependencies

   $ python -m venv .venv
   $ . ./.venv/bin/activate
   $ python -m pip install .
   # ... install decencies ...

   to activate virtual environment & install dependencies.

2. To test or execute the program in development, run:

   (.venv)$ python -m unittest discover # run tests
   (.venv)$ python -m main --dev # execute program in dev mode

You can use any other virtual environment & dependency manager as well.