Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

swag

package

Go to main page

Versions in this module

v1

v1.7.0

Apr 22, 2021

v1.6.0

Apr 16, 2021

Changes in this version

+ func SetMarkdownFileDirectory(directoryPath string) func(*Parser)

v1.5.0

Oct 13, 2020

v1.4.0

Oct 13, 2020

v1.3.0

Oct 13, 2020

Changes in this version

+ const Name

+ var ErrFailedConvertPrimitiveType = errors.New("swag property: failed convert primitive type")

+ var ErrFuncTypeField = errors.New("field type is func")

+ var ErrRecursiveParseStruct = errors.New("recursively parsing struct")

+ func BuildCustomSchema(types []string) (*spec.Schema, error)

+ func CheckSchemaType(typeName string) error

+ func IsGolangPrimitiveType(typeName string) bool

+ func IsNumericType(typeName string) bool

+ func IsPrimitiveType(typeName string) bool

+ func IsSimplePrimitiveType(typeName string) bool

+ func PrimitiveSchema(refType string) *spec.Schema

+ func ReadDoc() (string, error)

+ func RefSchema(refType string) *spec.Schema

+ func Register(name string, swagger Swagger)

+ func SetCodeExampleFilesDirectory(directoryPath string) func(*Operation)

+ func TransToValidCollectionFormat(format string) string

+ func TransToValidSchemeType(typeName string) string

+ func TypeDocName(pkgName string, typeSpec *ast.TypeSpec) string

+ type AstFileInfo struct

+ File *ast.File

+ PackagePath string

+ Path string

+ type Operation struct

+ HTTPMethod string

+ Path string

+ func NewOperation(parser *Parser, options ...func(*Operation)) *Operation

+ func (operation *Operation) ParseAcceptComment(commentLine string) error

+ func (operation *Operation) ParseCodeSample(attribute, commentLine, lineRemainder string) error

+ func (operation *Operation) ParseComment(comment string, astFile *ast.File) error

+ func (operation *Operation) ParseDescriptionComment(lineRemainder string)

+ func (operation *Operation) ParseEmptyResponseComment(commentLine string) error

+ func (operation *Operation) ParseEmptyResponseOnly(commentLine string) error

+ func (operation *Operation) ParseMetadata(attribute, lowerAttribute, lineRemainder string) error

+ func (operation *Operation) ParseParamComment(commentLine string, astFile *ast.File) error

+ func (operation *Operation) ParseProduceComment(commentLine string) error

+ func (operation *Operation) ParseResponseComment(commentLine string, astFile *ast.File) error

+ func (operation *Operation) ParseResponseHeaderComment(commentLine string, astFile *ast.File) error

+ func (operation *Operation) ParseRouterComment(commentLine string) error

+ func (operation *Operation) ParseSecurityComment(commentLine string) error

+ func (operation *Operation) ParseTagsComment(commentLine string)

+ type PackageDefinitions struct

+ Files map[string]*ast.File

+ Name string

+ TypeDefinitions map[string]*TypeSpecDef

+ type PackagesDefinitions struct

+ func NewPackagesDefinitions() *PackagesDefinitions

+ func (pkgs *PackagesDefinitions) CollectAstFile(packageDir, path string, astFile *ast.File)

+ func (pkgs *PackagesDefinitions) FindTypeSpec(typeName string, file *ast.File) *TypeSpecDef

+ func (pkgs *PackagesDefinitions) ParseTypes() (map[*TypeSpecDef]*Schema, error)

+ func (pkgs *PackagesDefinitions) RangeFiles(handle func(filename string, file *ast.File) error) error

+ type Parser struct

+ ParseDependency bool

+ ParseInternal bool

+ ParseVendor bool

+ func NewParser(options ...func(*Parser)) *Parser

+ func (parser *Parser) GetSchemaTypePath(schema *spec.Schema, currentDepth int) []string

+ func (parser *Parser) GetSwagger() *spec.Swagger

+ func (parser *Parser) ParseAPI(searchDir, mainAPIFile string, parseDepth int) error

+ func (parser *Parser) ParseDefinition(typeSpecDef *TypeSpecDef) (*Schema, error)

+ func (parser *Parser) ParseGeneralAPIInfo(mainAPIFile string) error

+ func (parser *Parser) ParseRouterAPIInfo(fileName string, astFile *ast.File) error

+ func (parser *Parser) Skip(path string, f os.FileInfo) error

+ type Schema struct

+ Name string

+ PkgPath string

+ type Swagger interface

+ ReadDoc func() string

+ type TypeSpecDef struct

+ File *ast.File

+ PkgPath string

+ TypeSpec *ast.TypeSpec

+ func (t *TypeSpecDef) FullName() string

+ func (t *TypeSpecDef) Name() string