インストール

追加のインストールコマンド

macOS

Homebrew確認済み · 100%

brew install swag

local Homebrew formula metadata

Linux

openSUSE zypper確認済み · 92%

sudo zypper install swag

openSUSE Tumbleweed package metadata · swag · ソース: download.opensuse.org

概要

パッケージ概要

Automatically generate RESTful API documentation with Swagger 2.0 for Go

プロジェクトリンク

コマンドとエイリアス

swag

履歴

プロジェクトの歴史と使われ方

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.

プロジェクトの歴史

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.

採用の歴史

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.

使われ方

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

パッケージ好きにとっての重要性

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.

タイムライン

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.

ソース

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

セキュリティ状態

リスクレベル: グリーン

narrow executable package without higher-risk signals.

リスク分類器

リスクグリーン · 信頼度低 · appliance

理由

narrow executable package without higher-risk signals

信号

metadata:no-higher-risk-signals

インストール挙動

formula メタデータに Homebrew post-install フックは記録されていません。
Homebrew bottle メタデータは 6 個のプラットフォームターゲットで利用できます。
ビルドメタデータには 1 件のビルド依存関係があります。

推奨レビュー

エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。

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

実行可能ファイル

インストールされる実行可能ファイル

コマンド	種類	公開範囲	メモ
`swag`	cli	グローバル実行可能ファイル

鮮度

バージョンと鮮度

これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。

ページ生成日2026-07-26

マネージャ版1.16.6

マネージャ更新日

ローカルデータOK

上流最新

検出された最新v1.16.6

https://github.com/swaggo/swag

情報No package-manager update timestamp was available.信頼度低

インストールメタデータ

パッケージメタデータ

パッケージキー	brew:swag
バージョン	1.16.6
パッケージマネージャ	Homebrew
パッケージマネージャページ	https://formulae.brew.sh/formula/swag
ホームページ	https://github.com/swaggo/swag
リポジトリ	https://github.com/swaggo/swag
上流ドキュメント	https://github.com/swaggo/swag#readme
ライセンス	MIT
ソースアーカイブ	https://github.com/swaggo/swag/archive/refs/tags/v1.16.6.tar.gz
ビルド依存関係	go
Bottle	利用可能 (対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定義
サービス	宣言なし

レジストリ情報

ソースデータベース詳細

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

ソースデータベース一致

他のパッケージマネージャ記録

一致は外部パッケージマネージャインデックスから取得され、ローカルの Automic Vault パッケージリンクとは分けて表示されます。

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 依存関係
1 提供
normalized package name match
一致条件: 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

パッケージグラフ

リンクは、ローカルのパッケージ関係グラフ、補足データ、依存関係、エコシステム一致、パッケージハブ所属から来ています。

ソース経路

リポジトリデータから生成

このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。

Combined YAML source

View the package source record on GitHub.

combined/swag.yml

使用ソース

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 を Homebrew, zypper でインストール