justfile

NAME := 'television'

# List all available commands
default:
	just --list

alias r := run-staging

# Run the program in debug mode with logs enabled
@run:
	echo "Running {{ NAME }}..."
	RUST_LOG=debug cargo run
	echo "Done"

# Run the program in staging mode (optimized but no lto)
@run-staging:
	echo "Running {{ NAME }} in staging mode..."
	cargo run --profile staging
	echo "Done"

# Setup the project environment for local development
@setup:
	echo "Setting up {{ NAME }}..."
	echo "Installing git hooks..."
	mkdir -p .git/hooks
	echo "just fix" > .git/hooks/pre-commit
	chmod +x .git/hooks/pre-commit
	echo "Installing dependencies..."
	cargo build
	echo "Done"

# Clean up cargo build artifacts
@clean:
	echo "Cleaning up {{ NAME }}..."
	echo "Removing git hooks..."
	rm -f .git/hooks/pre-commit
	echo "Done"

alias c := check

# Check the project for errors and warnings
@check:
	echo "Checking {{ NAME }}..."
	cargo check
	echo "Done"

# Format the code using cargo fmt
@format:
	echo "Formatting {{ NAME }}..."
	cargo fmt --all
	echo "Done"

# Lint the code using cargo clippy
@lint:
	echo "Linting {{ NAME }}..."
	cargo clippy --all-targets --all-features -- -D warnings
	echo "Done"

alias f := fix
# Fix linting and formatting errors
@fix:
	echo "Fixing {{ NAME }}..."
	cargo fix --allow-dirty --allow-staged
	just format
	just lint

alias t := test
# Run the tests for the project
@test:
	echo "Running {{ NAME }}'s test suite..."
	cargo test --all --all-features -- --nocapture
	echo "Done"

# Run tests with faster delays for local development
@test-fast:
	echo "Running {{ NAME }}'s test suite (fast mode)..."
	TV_TEST_DELAY_MS=50 cargo test --all --all-features -- --nocapture
	echo "Done"

alias b := build
# Build the project with the specified profile (dev by default)
@build profile='dev':
	echo "Building {{ NAME }} for profile: {{ profile }}..."
	cargo build --profile {{ profile }}
	echo "Done"

# Build the project in release mode
br: (build 'release')

# Generate a dev shell integration script for local development
@generate-dev-shell-integration shell='zsh':
	cargo run -- init {{ shell }} | sed 's/tv /.\/target\/debug\/tv /' > dev_shell_integration.{{ shell }}
	echo 'To activate {{ shell }} dev integration, run:  `source dev_shell_integration.{{ shell }}`'

# Update the project's changelog
@update-changelog:
	echo "Updating changelog..."
	git cliff -o CHANGELOG.md
	echo "Done"

alias m := update-man
# Update the project's manpages
update-man: build
	#!/usr/bin/env sh
	echo "Checking for manpages updates..."
	if ! diff ./man/tv.1 ./target/assets/tv.1 > /dev/null;
	then cp ./target/assets/tv.1 ./man/tv.1 && git add ./man/tv.1 && echo "Updated manpages"
	else echo "No changes to manpages"
	fi

@publish:
	echo "Publishing {{ NAME }}..."
	cargo publish --all-features
	echo "Done"

@commit-release:
	#!/usr/bin/env sh
	version=$(grep -E '^\s*version\s*=' Cargo.toml | cut -d '"' -f 2)
	git commit -am "chore: release version $version"
	git tag "$version"

@push-release:
	#!/usr/bin/env sh
	echo "Pushing changes and tags to remote..."
	git push origin main --tags
	echo "Done"

alias rl := release
# Publish a new release (major, minor, or patch)
@release kind='patch':
	echo "Releasing {{ NAME }} (kind: {{ kind }})..."
	just bump-version {{ kind }}
	just update-man
	just commit-release
	just publish


# Bump version
bump-version kind='patch':
	#!/usr/bin/env sh
	echo "Bumping version (kind: {{ kind }})..."
	# bump version (major, minor, patch)
	version=$(grep -E '^\s*version\s*=' Cargo.toml | cut -d '"' -f 2)
	kind="{{ kind }}"
	echo "Current version is: $version"
	if [ "$kind" = "major" ]; then
		new_version=$(echo $version | awk -F. -v OFS=. '{$1++; $2=0; $3=0} 1')
	elif [ "$kind" = "minor" ]; then
		new_version=$(echo $version | awk -F. -v OFS=. '{$2++; $3=0} 1')
	elif [ "$kind" = "patch" ]; then
		new_version=$(echo $version | awk -F. -v OFS=. '{$3++} 1')
	else
		echo "Invalid kind: $kind"
		exit 1
	fi
	echo "Bumping to: $new_version"
	echo "Updating version in Cargo.toml..."
	if [[ "$OSTYPE" == "darwin"* ]]; then
		sed -i '' "s/version = \"$version\"/version = \"$new_version\"/" Cargo.toml
	else
		sed -i "s/version = \"$version\"/version = \"$new_version\"/" Cargo.toml
	fi
	git add Cargo.toml
	echo "Done"

# Start a local development server for the project's website
@start-website:
	cd website && pnpm install && pnpm start

# Generate cable channel docs
@generate-cable-docs:
	echo "Generating cable channel docs..."
	python -m venv .venv && \
	source .venv/bin/activate && \
	python -m ensurepip && \
	python -m pip install toml && \
	python scripts/generate_cable_docs.py
	echo "Docs generated in docs/cable_channels.md"
	rm -rf .venv

# Update CLI docs from tv --help
@update-cli-help:
	sh -ec 'help_output=$(cargo run --quiet -- --help); { \
		printf "%s\n" '\''```text'\''; \
		printf "%s\n" "$help_output"; \
		printf "%s\n" '\''```'\''; \
	} > docs/reference/01-cli.md'