pkg.soopen package index

brew / rank 4520

Install swag with Homebrew, zypper

Automatically generate RESTful API documentation with Swagger 2.0 for Go. Version 1.16.6 via Homebrew; verified 2026-07-26. Also installable with zypper: sudo zypper install swag.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install swag

local Homebrew formula metadata

overview

Package summary

Automatically generate RESTful API documentation with Swagger 2.0 for Go

Commands and aliases

  • swag

history

Project history and usage

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.

Project history

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.

Adoption history

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.

How it is used

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`.

Why package nerds care

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.

Timeline

  • 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.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

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

Installed executables

CommandKindExposureNote
swagexecutableindexed executableDiscovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03
manager version1.16.6
manager updated2026-07-26
local dataunknown
upstreamnot available
latest detectednot detected
  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:swag
Version1.16.6
Package managerHomebrew
Homepagehttps://github.com/swaggo/swag
Repositoryhttps://github.com/swaggo/swag
Last updated2026-07-26T04:03:48+02:00
Pulseupdated
Bottlenot recorded
Servicenone declared

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

zypper95%

swag 1.16.6-1.7

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 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Swag
openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: swag from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • pkg.so package database
  • pkgdb category and tag curation