# swag を Homebrew, zypper でインストール

swag のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:swag
```

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

### macOS

- Homebrew (100%):

```sh
brew install swag
```

  証拠: local Homebrew formula metadata

### Linux

- zypper (92%):

```sh
sudo zypper install swag
```

  証拠: openSUSE Tumbleweed package metadata: swag from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## パッケージ情報

- **パッケージキー:** brew:swag
- **パッケージマネージャ:** Homebrew
- **パッケージマネージャページ:** <https://formulae.brew.sh/formula/swag>
- **バージョン:** 1.16.6
- **ソース概要:** Automatically generate RESTful API documentation with Swagger 2.0 for Go
- **ホームページ:** <https://github.com/swaggo/swag>
- **リポジトリ:** <https://github.com/swaggo/swag>
- **ライセンス:** MIT
- **ソースアーカイブ:** <https://github.com/swaggo/swag/archive/refs/tags/v1.16.6.tar.gz>
- **最終更新:** 2026-07-26T04:03:48+02:00
- **生成日時:** 2026-08-04T22:13:35+00:00

## 実行可能ファイル

- swag (cli)
- swag (エイリアス)

## ビルド依存関係

- go

## インストール挙動

- post-install フック: 未定義
- Bottle: 利用可能 対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## バージョンと鮮度

- ページ生成日: 2026-08-04
- マネージャ版: 1.16.6
- マネージャ更新日: 2026-07-26
- ローカルデータ: OK
- 上流リポジトリ: https://github.com/swaggo/swag
- 検出された最新: v1.16.6 (最新)
## プロジェクトの歴史と使われ方

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.

- **Geiger リスク:** グリーン / 低
- narrow executable package without higher-risk signals


## 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

- Unix: .swaggo
## ソースデータベース詳細

- **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

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

- zypper - swag - 1.16.6-1.7: normalized package name match | openSUSE Tumbleweed package metadata: swag from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Automatically generate RESTful API documentation with Swagger 2.0 for Go | https://github.com/swaggo/swag


## 関連リンク

- [Source-control packages](https://pkg.so/ja/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/ja/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/ja/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/ja/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://pkg.so/ja/brew/go/) - Build dependency declared by Homebrew.
- [swagger-codegen](https://pkg.so/ja/brew/swagger-codegen/) - Shares pkgdb curated category or tags: cli, developer-tools, openapi, swagger.
- [redocly-cli](https://pkg.so/ja/brew/redocly-cli/) - Shares pkgdb curated category or tags: api-documentation, cli, developer-tools, openapi.
- [vacuum](https://pkg.so/ja/brew/vacuum/) - Shares pkgdb curated category or tags: cli, developer-tools, openapi, swagger.
- [autorest](https://pkg.so/ja/brew/autorest/) - Shares pkgdb curated category or tags: cli, developer-tools, openapi, swagger.
- [swagger2markup-cli](https://pkg.so/ja/brew/swagger2markup-cli/) - Shares pkgdb curated category or tags: cli, developer-tools, openapi, swagger.
- [fzf](https://pkg.so/ja/brew/fzf/) - Shares pkgdb curated category or tags: cli, developer-tools, go.
- [hugo](https://pkg.so/ja/brew/hugo/) - Shares pkgdb curated category or tags: cli, developer-tools, go.
- [golangci-lint](https://pkg.so/ja/brew/golangci-lint/) - Shares pkgdb curated category or tags: cli, developer-tools, go.
- [apib2swagger](https://pkg.so/ja/npm/apib2swagger/) - Local package facts share a topical domain. Shared terms: api, cli, developer, developer-tools, generate.
- [widdershins](https://pkg.so/ja/npm/widdershins/) - Local metadata places this package in an adjacent workflow. Shared terms: api, cli, developer, developer-tools, documentation.
- [fastify-openapi-glue](https://pkg.so/ja/npm/fastify-openapi-glue/) - Local package facts share a topical domain. Shared terms: api, cli, developer, developer-tools, generate.

## Combined YAML source

View the package source record on GitHub. [combined/swag.yml](https://github.com/mxcl/pkgdb/blob/main/combined/swag.yml)


## ソース

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