lstn

module

v0.20.0 Latest Latest Go to latest Published: May 5, 2025 License: Apache-2.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/listendev/lstn

Links

Open Source Insights

README ¶

lstn

lstn is the listen.dev command line. It lets you analyze the behavior of your dependencies.

lstn

Documentation

To install lstn in your environment, refer to the installation section below. For usage instructions, see:

the usage manual
the guide about the ~/.lstn.yaml config file
the guide about the LSTN_* environment variables
the reporters reference

Installation

CI

GitHub Actions

We recommend using the GitHub Action for running lstn in CI for GitHub projects. For integration instructions see this guide.

Other CI

It's highly recommended to install a specific version of lstn available on the releases page. Here are a few ways to install it:

# The binary will be /usr/local/bin/lstn
curl -sSfL https://lstn.dev/get | sh -s -- -b /usr/local/bin

# Or install it into $PWD/bin/
curl -sSfL https://lstn.dev/get | sh -s

# In Alpine Linux (as it does not come with curl by default)
wget -O- -nv https://lstn.dev/get | sh -s

You can test the installation by running:

lstn version

Locally

To install lstn locally, see the options below:

Binaries

curl -sSfL https://lstn.dev/get | sh -s -- -b /usr/local/bin
lstn version

macOS

lstn is available via TODO: Homebrew, ..., and as a downloadable binary from our releases page.

Linux & BSD

lstn is available via:

TODO: our Debian and RPM repositories
OS-agnostic package managers such as TODO: Homebrew, ...
our releases pages as precompiled binaries.

From source

We recommend using binary installation. Using go install or go get might work but those aren't guaranteed to.

Why?

Some users use the -u flag for go get which upgrades our dependencies: we can not guarantee they work!
The go.mod replacement directive doesn't apply.
The lstn stability may depend on a user's Go version.
It allows installation from the main branch which can't be considered stable.
It is way slower than binary installation.

Contributing

If anything feels off, or if you feel that some functionality is missing, please check out the contributing page.

There you will find instructions for sharing your feedback, building the tool locally, and submitting pull requests to the project.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
ci SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
ci/enable SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
ci/report SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
in SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
lstn command SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
root SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
scan SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
to SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
version SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
internal
docs SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
project SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
testing SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
make
docs command
pkg
ci SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/arguments SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/flags SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/flagusages SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/groups SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/help SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/options SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/packagesprinter
cmd/report SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/report/templates SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
cmd/viper SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
context SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
fs SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
git SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
jq SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
jsonpath SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
listen SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
listen/type SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
npm SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
npm/deptype SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
os SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
pypi SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
reporter SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
reporter/factory SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
reporter/gh/comment SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
reporter/pro SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
text SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
transform SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
ua SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
validate SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0
version SPDX-License-Identifier: Apache-2.0	SPDX-License-Identifier: Apache-2.0