gci ダウンロード - gci ソースコードのダウンロード

GCI

GCI は、Go パッケージのインポート順序を制御し、常に決定的なものにするツールです。

目的の出力形式は高度に構成可能であり、 goimportよりも多くのカスタム形式を使用できます。

GCI は、AST に基づいてインポートブロックを次のように考慮します。

 Doc
Name Path Comment

分離されたコメントブロックを除き、すべてのコメントは元の状態のまま保持されます。

以下のような分離されたコメントブロック:

 import (
  "fmt"
  // this line is isolated comment

  // those lines belong to one
  // isolated comment blocks

  "github.com/daixiang0/gci"
)

GCI はすべてのインポートブロックを異なるセクションに分割し、6 つのセクションタイプをサポートするようになりました。

標準: Go 公式インポート (「fmt」など)
カスタム: カスタムセクション。完全一致および最長一致を使用します (最初に完全な文字列に一致し、複数一致する場合は最長のものを使用します)。
デフォルト: すべての残りのインポートブロック
空白: 空白のインポートを別のグループにまとめます
dot: ドットインポートを別のグループにまとめます
alias: エイリアスのインポートを別のグループにまとめます
localmodule: ローカルパッケージからのインポートを別のグループに入れる

優先順位は標準 > デフォルト > カスタム > 空白 > ドット > エイリアス > localmodule で、すべてのセクションが内部でアルファベット順にソートされます。デフォルトでは、空白、ドット、およびエイリアスのセクションは使用されず、対応する行は他のグループに入ります。

すべてのインポートブロックは 1 つの TAB( t ) をインデントとして使用します。

v0.9.0 以降、GCI は常に C インポートブロックを最初に置きます。

注記：

nolintはセクションレベルで処理するのが難しいため、GCI はそれを 1 つのコメントとしてみなします。

ローカルモジュール

ローカルモジュールの検出は、 gciが呼び出されるディレクトリ内のgo.modファイルからモジュール名を読み取ることによって行われます。これはつまり：

このモードは、 gciがモジュールルート (つまり、 go.mod含むディレクトリ) から呼び出された場合に機能します。
このモードは、複数モジュールのセットアップでは機能しません。つまり、 gciがgo.work含むディレクトリから呼び出された場合には機能しません (ただし、ワークスペース内のモジュールの 1 つから呼び出された場合は機能します)。

インストール

利用可能な最新のリリースバージョンをダウンロードしてインストールするには -

go install github.com/daixiang0/gci@latest

次のように、特定のバージョンを指定することもできます。

go install github.com/daixiang0/[email protected]

使用法

現在、GCI は主に下位互換性のために 2 つのコマンドラインメソッドを提供しています。

新しいスタイル

GCI は 3 つの動作モードをサポートします

注記
v0.10.0 以降、 -sおよび--sectionフラグは複数のセクションを指定するために複数回のみ使用できます。たとえば、以前は-s standard,default使用できましたが、現在は-s standard -s defaultを使用する必要があります。この破壊的な変更により、プロジェクトで複数のカスタムプレフィックスの指定をサポートできるようになります。 (以下を参照してください。)

$ gci print -h
Print outputs the formatted file. If you want to apply the changes to a file use write instead !

Usage:
  gci print path... [flags]

Aliases:
  print, output

Flags:
      --custom-order          Enable custom order of sections
  -d, --debug                 Enables debug output from the formatter
  -h, --help                  help for print
  -s, --section stringArray   Sections define how inputs will be processed. Section names are case-insensitive and may contain parameters in (). The section order is standard > default > custom > blank > dot > alias > localmodule. The default value is [standard,default].
                              standard - standard section that Go provides officially, like " fmt "
                              Prefix(github.com/daixiang0) - custom section, groups all imports with the specified Prefix. Imports will be matched to the longest Prefix. Multiple custom prefixes may be provided, they will be rendered as distinct sections separated by newline. You can regroup multiple prefixes by separating them with comma: Prefix(github.com/daixiang0,gitlab.com/daixiang0,daixiang0)
                              default - default section, contains all rest imports
                              blank - blank section, contains all blank imports.
                              dot - dot section, contains all dot imports. (default [standard,default])
                              alias - alias section, contains all alias imports.
                              localmodule: localmodule section, contains all imports from local packages
      --skip-generated        Skip generated files
      --skip-vendor           Skip files inside vendor directory

$ gci write -h
Write modifies the specified files in-place

Usage:
  gci write path... [flags]

Aliases:
  write, overwrite

Flags:
      --custom-order          Enable custom order of sections
  -d, --debug                 Enables debug output from the formatter
  -h, --help                  help for write
  -s, --section stringArray   Sections define how inputs will be processed. Section names are case-insensitive and may contain parameters in (). The section order is standard > default > custom > blank > dot > alias > localmodule. The default value is [standard,default].
                              standard - standard section that Go provides officially, like " fmt "
                              Prefix(github.com/daixiang0) - custom section, groups all imports with the specified Prefix. Imports will be matched to the longest Prefix. Multiple custom prefixes may be provided, they will be rendered as distinct sections separated by newline. You can regroup multiple prefixes by separating them with comma: Prefix(github.com/daixiang0,gitlab.com/daixiang0,daixiang0)
                              default - default section, contains all rest imports
                              blank - blank section, contains all blank imports.
                              dot - dot section, contains all dot imports. (default [standard,default])
                              alias - alias section, contains all alias imports.
                              localmodule: localmodule section, contains all imports from local packages
      --skip-generated        Skip generated files
      --skip-vendor           Skip files inside vendor directory

$ gci list -h
Prints the filenames that need to be formatted. If you want to show the diff use diff instead, and if you want to apply the changes use write instead

Usage:
  gci list path... [flags]

Flags:
      --custom-order          Enable custom order of sections
  -d, --debug                 Enables debug output from the formatter
  -h, --help                  help for list
  -s, --section stringArray   Sections define how inputs will be processed. Section names are case-insensitive and may contain parameters in (). The section order is standard > default > custom > blank > dot > alias > localmodule. The default value is [standard,default].
                              standard - standard section that Go provides officially, like " fmt "
                              Prefix(github.com/daixiang0) - custom section, groups all imports with the specified Prefix. Imports will be matched to the longest Prefix. Multiple custom prefixes may be provided, they will be rendered as distinct sections separated by newline. You can regroup multiple prefixes by separating them with comma: Prefix(github.com/daixiang0,gitlab.com/daixiang0,daixiang0)
                              default - default section, contains all rest imports
                              blank - blank section, contains all blank imports.
                              dot - dot section, contains all dot imports. (default [standard,default])
                              alias - alias section, contains all alias imports.
                              localmodule: localmodule section, contains all imports from local packages
      --skip-generated        Skip generated files
      --skip-vendor           Skip files inside vendor directory

$ gci diff -h
Diff prints a patch in the style of the diff tool that contains the required changes to the file to make it adhere to the specified formatting.

Usage:
  gci diff path... [flags]

Flags:
      --custom-order          Enable custom order of sections
  -d, --debug                 Enables debug output from the formatter
  -h, --help                  help for diff
  -s, --section stringArray   Sections define how inputs will be processed. Section names are case-insensitive and may contain parameters in (). The section order is standard > default > custom > blank > dot > alias > localmodule. The default value is [standard,default].
                              standard - standard section that Go provides officially, like " fmt "
                              Prefix(github.com/daixiang0) - custom section, groups all imports with the specified Prefix. Imports will be matched to the longest Prefix. Multiple custom prefixes may be provided, they will be rendered as distinct sections separated by newline. You can regroup multiple prefixes by separating them with comma: Prefix(github.com/daixiang0,gitlab.com/daixiang0,daixiang0)
                              default - default section, contains all rest imports
                              blank - blank section, contains all blank imports.
                              dot - dot section, contains all dot imports. (default [standard,default])
                              alias - alias section, contains all alias imports.
                              localmodule: localmodule section, contains all imports from local packages
      --skip-generated        Skip generated files
      --skip-vendor           Skip files inside vendor directory

古いスタイル

Gci enables automatic formatting of imports in a deterministic manner
If you want to integrate this as part of your CI take a look at golangci-lint.

Usage:
  gci [-diff | -w rite] [--local localPackageURLs] path... [flags]
  gci [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  diff        Prints a git style diff to STDOUT
  help        Help about any command
  list        Prints filenames that need to be formatted to STDOUT
  print       Outputs the formatted file to STDOUT
  write       Formats the specified files in-place

Flags:
  -d, --diff            display diffs instead of rewriting files
  -h, --help            help for gci
  -l, --local strings   put imports beginning with this string after 3rd-party packages, separate imports by comma
  -v, --version         version for gci
  -w, --write           write result to (source) file instead of stdout

Use " gci [command] --help " for more information about a command.

注記：：

古いスタイルはローカルテストのみに使用され、非推奨になります。新しいスタイルを使用してくださいgolangci-lintも新しいスタイルを使用します。

例

gci write -s standard -s default -s "prefix(github.com/daixiang0/gci)" main.go実行すると、次のような場合に対処できます。

シンプルなケース

 package main
import (
  "golang.org/x/tools"

  "fmt"

  "github.com/daixiang0/gci"
)

に

 package main
import (
    "fmt"

    "golang.org/x/tools"

    "github.com/daixiang0/gci"
)

エイリアス付き

 package main
import (
  "fmt"
  go "github.com/golang"
  "github.com/daixiang0/gci"
)

に

 package main
import (
  "fmt"

  go "github.com/golang"

  "github.com/daixiang0/gci"
)

空白とドットのグループ化を有効にした場合

 package main
import (
  "fmt"
  go "github.com/golang"
  _ "github.com/golang/blank"
  . "github.com/golang/dot"
  "github.com/daixiang0/gci"
  _ "github.com/daixiang0/gci/blank"
  . "github.com/daixiang0/gci/dot"
)

に

 package main
import (
  "fmt"

  go "github.com/golang"

  "github.com/daixiang0/gci"

  _ "github.com/daixiang0/gci/blank"
  _ "github.com/golang/blank"

  . "github.com/daixiang0/gci/dot"
  . "github.com/golang/dot"
)

エイリアスのグループ化が有効な場合

 package main

import (
	testing "github.com/daixiang0/test"
	"fmt"

	g "github.com/golang"

	"github.com/daixiang0/gci"
	"github.com/daixiang0/gci/subtest"
)

に

 package main

import (
	"fmt"

	"github.com/daixiang0/gci"
	"github.com/daixiang0/gci/subtest"

	testing "github.com/daixiang0/test"
	g "github.com/golang"
)

ローカルモジュールのグループ化を有効にした場合

これがこのリポジトリのルート (つまり、 github.com/daixiang0/gciがローカルモジュールである場合) で実行されると仮定します。

 package main

import (
	"os"
	"github.com/daixiang0/gci/cmd/gci"
)

に

 package main

import (
	"os"

	"github.com/daixiang0/gci/cmd/gci"
)

TODO

インポートブロック内のNameとPathの間には空白が 1 つだけあることを確認してください
インポートブロック内のPathとCommentの間には空白が 1 つだけあることを確認してください
コメントの書式設定
テストケースをさらに追加する
インポート完了のサポート (最初にgoimports使用してから GCI を使用してください)
コメントの最適化
アナライザー層を削除し、アナライザー構文を完全に使用する

拡大する

gci

GCI

ローカルモジュール

インストール

使用法

新しいスタイル

古いスタイル

例

シンプルなケース

エイリアス付き

空白とドットのグループ化を有効にした場合

エイリアスのグループ化が有効な場合

ローカルモジュールのグループ化を有効にした場合

TODO

TikTok LoginKit PHP

citation machine

Minecraft ベータ版 1.20.50.211.20.50.21

jquery ui

pihole speedtest

About SwiftUI

Tinfoil

reddit twitter bot

aws cli