Installation

Weitere Installationsbefehle

macOS

Homebrewverifiziert · 100%

brew install swag

local Homebrew formula metadata

Linux

openSUSE zypperverifiziert · 92%

sudo zypper install swag

openSUSE Tumbleweed package metadata · swag · Quelle: download.opensuse.org

Überblick

Paketzusammenfassung

Automatically generate RESTful API documentation with Swagger 2.0 for Go

Projektlinks

Befehle und Aliase

swag

Verlauf

Projektgeschichte und Nutzung

swag is the Swaggo command-line generator for producing Swagger 2.0 documentation from Go source-code annotations. It became a common Go ecosystem tool because it lets web services generate API docs without leaving the Go build and source layout.

Projektgeschichte

The swaggo/swag repository was created on GitHub in June 2017. Its README says Swag converts Go annotations to Swagger Documentation 2.0 and provides plugins for popular Go web frameworks so generated output can be served through Swagger UI.

Adoptionsgeschichte

The project reached a v1.0.0 release in November 2017 and continued through the v1.x line while publishing binaries, a Docker image, and `go install` instructions. The README lists integrations for Gin, Echo, Buffalo, net/http, gorilla/mux, chi, Fiber, Hertz, and other Go web stacks.

Wie es verwendet wird

The standard workflow is to add declarative comments to Go handlers, install the `swag` command, and run `swag init` at the project root. The CLI then writes a docs package plus swagger.json and swagger.yaml outputs, with flags for alternate entry files, output directories, parse depth, dependency parsing, and global overrides via `.swaggo`.

Warum Paket-Nerds sich dafür interessieren

swag is package-nerd relevant because it turns API documentation generation into a reproducible build step for Go projects. Distributions and developer package managers care about it as a standalone CLI, while Go users care that the same tool can be installed as a binary, Docker image, or module-aware `go install` target.

Zeitleiste

2017: GitHub repository created.
2017: v1.0.0 tag published.
2025: v1.16.6 released in the continuing v1 line.
2026: v2.0.0 release candidates listed in GitHub releases during research.

Related projects

The README points to companion Swagger UI middleware packages such as swaggo/gin-swagger, swaggo/echo-swagger, swaggo/files, and swaggo/http-swagger.

Quellen

https://api.github.com/repos/swaggo/swag
https://api.github.com/repos/swaggo/swag/releases
https://github.com/swaggo/swag#readme
source_facts.package-manager

Sicherheitslage

Risikostufe: grün

narrow executable package without higher-risk signals.

Risikoklassifikator

grün Risiko · niedrig Konfidenz · appliance

Warum

narrow executable package without higher-risk signals

Signale

metadata:no-higher-risk-signals

Installationsverhalten

In den Formelmetadaten ist kein Homebrew-Post-install-Hook erfasst.
Homebrew-Bottle-Metadaten sind für 6 Plattformziele verfügbar.
Build-Metadaten listen 1 Build-Abhängigkeiten.

Empfohlene Prüfung

Prüfe vor unbeaufsichtigter Agent-Nutzung, ob das Tool Klartext-Credentials liest, Remote-Zustand schreibt, Artefakte veröffentlicht oder Plugins ausführt.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: .swaggo

Executables

Installierte Executables

Befehl	Art	Sichtbarkeit	Hinweis
`swag`	cli	globales Executable

Aktualität

Version und Aktualität

Diese Signale trennen das Alter der Seitengenerierung, Aktivität des Paketmanagers und Upstream-Release-Vergleich. Versionsrückstand wird nur gemeldet, wenn eine Evidenz-URL und vergleichbare Versionen vorhanden sind.

Seite generiert2026-07-26

Manager-Version1.16.6

Manager aktualisiert

lokale DatenOK

Upstreamaktuell

neueste erkannte Versionv1.16.6

https://github.com/swaggo/swag

InfoNo package-manager update timestamp was available.niedrig Konfidenz

Installationsmetadaten

Paketmetadaten

Paketschlüssel	brew:swag
Version	1.16.6
Paketmanager	Homebrew
Paketmanager-Seite	https://formulae.brew.sh/formula/swag
Homepage	https://github.com/swaggo/swag
Repository	https://github.com/swaggo/swag
Upstream-Dokumentation	https://github.com/swaggo/swag#readme
Lizenz	MIT
Quellarchiv	https://github.com/swaggo/swag/archive/refs/tags/v1.16.6.tar.gz
Build-Abhängigkeiten	go
Bottle	verfügbar (auf arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	nicht definiert
Dienst	keiner deklariert

Registry-Fakten

Details aus der Quelldatenbank

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	swag
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

Source-Datenbank-Treffer

Andere Paketmanager-Einträge

Treffer stammen aus externen Paketmanager-Indizes und bleiben von lokalen Automic-Vault-Paketlinks getrennt.

zypper95%

swag 1.16.6-1.4

Automatically generate RESTful API documentation with Swagger 2.0 for Go

https://github.com/swaggo/swag

sudo zypper install swag

License: MIT
Category: Unspecified
Architecture: x86_64
Source Package: swag
1 Abhängigkeiten
1 stellt bereit
normalized package name match
Abgeglichen nach: Swag

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: swag from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

Paketgraph

Links stammen aus dem lokalen Paketbeziehungsgraph, Ergänzungen, Abhängigkeitskanten, Ecosystem-Matches und Paket-Hub-Mitgliedschaft.

Quellspur

Aus Repository-Daten generiert

Diese Seite wird von av-web aus dem privaten Paket-SQLite-Artefakt bereitgestellt, das scripts/generate-pkg-sqlite.py erstellt.

Combined YAML source

View the package source record on GitHub.

combined/swag.yml

Verwendete Quellen

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

swag mit Homebrew, zypper installieren