justlib

Library of useful Just task runner recipes mainly focused on software development and continuous integration.

Depedencies

• just task runner
• git-cliff changelog generator
• gh github cli
• nushell versatile shell
• nix package manager for building docker images
• deno JS runtime for handling version bumps
• git source control management
• docker for running images
• skopeo for copying images to registries
• direnv for loading environment configurations
• file for determining the mime type of build outputs

Usage

1. Clone repository as a submodule: git submodule add https://github.com/identinet/justlib.git
2. Import library into your Justfile, see examples.
   • Hint: The recipes are split into multiple files that can be imported individually.
3. Install dependencies.
4. Start using recipes from library, e.g. just format to format your Justfile.

Available recipes

Individual application

Recipes meant for individual applications.

just --list -f lib.just

Available recipes:
[ci]
ci # CI pipeline task that will create a release of the package
docker-build # Build image
docker-inspect # Inspect image
docker-inspect-registry # Inspect image in registry
docker-load # Load image locally
docker-push # Push image
docker-run # Run image locally
docker-run-sh # Run shell image locally
update-flake # Update flake
[internal]
format # Format Justfile
githooks # Install git commit hooks
[release]
bump LEVEL="patch" NEW_VERSION="" # Bump version. LEVEL can be one of: major, minor, patch, premajor, preminor, prepatch, or prerelease.
release # Build application and pushes image - run `just bump` first

Mono repositories

Recipes meant for mono repositories that contain multiple applications. Import these recipes only at the repository's root Justfile.

# Recipes meant for application development
just --list -f monorepo.just

Examples

Simple Exmple

#!/usr/bin/env -S just --justfile# Documentation: https://just.systems/man/en/# Documentation: https://www.nushell.sh/book/import'justlib/lib.just'# Print this helpdefault:@just -l

Comprehensive Example

#!/usr/bin/env -S just --justfile# Documentation: https://just.systems/man/en/# Documentation: https://www.nushell.sh/book/import'justlib/lib.just'DIST_FOLDER:="dist"# Print this helpdefault:@just -l
# Installs dependencies
[group('development')]
install:githooks
deno install --frozen --lock
# Continuously run and build application for development purposes
[group('development')]
dev:install
deno task dev
# Open URL in browser.
[group('development')]
open:
deno run -A npm:open-cli "https://${EXTERNAL_HOSTNAME}"# Build release version of application
[group('development')]
build:install
deno task build
# Preview the build
[group('development')]
preview:build
deno task preview
# Lint code
[group('linter')]
lint:githooks
deno lint
# Lint code and fix issues
[group('linter')]
lint-fix:githooks
deno lint --fix
# Update dependencies
[group('development')]
update-deps:githooks
deno outdated --update --latest
# Sets new version in files files, called by `just bump`
[private]
[group('ci')]
_bump_filesCURRENT_VERSIONNEW_VERSION:
#!/usr/bin/env nu
open package.json | upsert version "{{ NEW_VERSION }}" | save -f package.json; git add package.json
# Clean build folder
[group('development')]
clean:
@rm -rvf "{{ DIST_FOLDER }}"