stplr(1)

stplr(8) System Manager's Manual stplr(8)

NAME

stplr - Command-line interface for Stapler, a universal Linux package build system

SYNOPSIS

stplr

[--interactive|-i]
[--pm-args|-P]=[value]

DESCRIPTION

Stapler is a universal Linux package build and distribution system designed for cross-distribution software delivery.

Packages are distributed through Stapler repositories. By default, stplr ships without any repositories configured, so you must add one or more repositories before installing software.

Getting started:
stplr repo add [name] [url] Add a Stapler repository
stplr refresh Update repository indexes
stplr install [package] Install a package from configured repositories
stplr search [query] Search for packages

For more information and list of community repositories: https://stplr.dev/docs/intro

Usage:

stplr [GLOBAL OPTIONS] [command [COMMAND OPTIONS]] [ARGUMENTS...]

GLOBAL OPTIONS

--interactive, -i: Enable interactive questions and prompts

--pm-args, -P="": Arguments to be passed on to the package manager

COMMANDS

install, in

Install a new package

--clean, -c: Build package from scratch even if there's an already built package available

remove, rm

Remove an installed package

upgrade, up

Upgrade all installed packages

--clean, -c: Build package from scratch even if there's an already built package available

info

Print information about a package

--all, -a: Show all information, not just for the current distro

--json: Return information in JSON format

list, ls

List Stapler repo packages

--format, -f="": Format output using a Go template

--installed, -I:

--upgradable, -U:

build

Build a local package

--clean, -c: Build package from scratch even if there's an already built package available

--no-suffix: Do not add suffix to package name

--package, -p="": Name of the package to build and its repo (example: default/go-bin)

--script, -s="": Path to the build script (default: "Staplerfile")

--subpackage, --sb="": Specify subpackage in script (for multi package script only)

refresh, ref

Pull all repositories that have changed

fix

Attempt to fix problems with Stapler

helper

Run a Stapler helper command

--dest-dir, -d="": The directory that the install commands will install to (default: "dest")

list, ls

List all the available helper commands

version

Print the current Stapler version and exit

search, s

Search packages

--all, -a: Show all information, not just for the current distro

--description, -d="": [DEPRECATED] Search by description

--format, -f="": Format output using a Go template

--name, -n="": [DEPRECATED] Search by name

--provides, -p="": [DEPRECATED] Search by provides

--query, -q="": Search by query (CEL syntax)

--repository, --repo="": [DEPRECATED] Search by repository

repo

Manage repos

list, ls

List repositories

--format, -f="": Format output using a Go template

--json: Output in JSON format

remove, rm

Remove an existing repository

add

Add a new repository

import

Import a repository from a stapler-repo.toml file

--ignore-existing: Skip import if repository already exists

--no-pull: Skip pulling repository after import

set-ref

Set the reference of the repository

set-disabled

Disable (or enable) repository

set-require-signed

Require signed commits for a repository

set-url

Set the main url of the repository

mirror

Manage mirrors of repos

add

Add a mirror URL to repository

remove, rm

Remove mirror from the repository

--ignore-missing: Ignore if mirror does not exist

--partial, -p: Match partial URL (e.g., github.com instead of full URL)

clear, rm-all

Remove all mirrors from the repository

clear-overrides

Remove all overrides for a repository

config

Manage config

show

Show config

set

Set config value

get

Get config value

migrate

Migrate to current version

support

Dump debug information