Documentation
¶
Index ¶
- Constants
- Variables
- func FilePathEndsWithExtensionFrom(path string, validExtensions []string) bool
- func FileSizeCheck(fullpath string) error
- func GetDirectories(basepath string) (map[string][]string, error)
- func InvalidDirectoriesCheck(directories map[string][]string) error
- func IsValidLegacyDirectory(directory string) bool
- func IsValidRegistryDirectory(directory string) bool
- func LegacyFileExtensionCheck(path string) error
- func MixedDirectoriesCheck(directories map[string][]string) error
- func NumberOfFilesCheck(directories map[string][]string) error
- func RegistryFileExtensionCheck(path string) error
- func ResourceFileMismatchCheck(providerName string, resourceType string, ...) error
- func SideNavigationLinkCheck(opts *SideNavigationOptions) error
- func SideNavigationMismatchCheck(opts *SideNavigationOptions, dataSourceFiles []string, resourceFiles []string) error
- func TrimFileExtension(path string) string
- type Check
- type CheckOptions
- type FileCheck
- type FileOptions
- type FrontMatterCheck
- type FrontMatterData
- type FrontMatterOptions
- type LegacyDataSourceFileCheck
- type LegacyDataSourceFileOptions
- type LegacyGuideFileCheck
- type LegacyGuideFileOptions
- type LegacyIndexFileCheck
- type LegacyIndexFileOptions
- type LegacyResourceFileCheck
- type LegacyResourceFileOptions
- type RegistryDataSourceFileCheck
- type RegistryDataSourceFileOptions
- type RegistryGuideFileCheck
- type RegistryGuideFileOptions
- type RegistryIndexFileCheck
- type RegistryIndexFileOptions
- type RegistryResourceFileCheck
- type RegistryResourceFileOptions
- type SideNavigationOptions
Constants ¶
View Source
const ( ResourceTypeDataSource = "data source" ResourceTypeResource = "resource" // Terraform Registry Storage Limits // https://www.terraform.io/docs/registry/providers/docs.html#storage-limits RegistryMaximumNumberOfFiles = 1000 RegistryMaximumSizeOfFile = 500000 // 500KB )
View Source
const ( DocumentationGlobPattern = `{docs,website/docs}/**/*` LegacyIndexDirectory = `website/docs` LegacyDataSourcesDirectory = `website/docs/d` LegacyGuidesDirectory = `website/docs/guides` LegacyResourcesDirectory = `website/docs/r` RegistryIndexDirectory = `docs` RegistryDataSourcesDirectory = `docs/data-sources` RegistryGuidesDirectory = `docs/guides` RegistryResourcesDirectory = `docs/resources` )
View Source
const ( FileExtensionErb = `.erb` FileExtensionHtmlMarkdown = `.html.markdown` FileExtensionHtmlMd = `.html.md` FileExtensionMarkdown = `.markdown` FileExtensionMd = `.md` )
Variables ¶
View Source
var ValidLegacyDirectories = []string{ LegacyIndexDirectory, LegacyDataSourcesDirectory, LegacyGuidesDirectory, LegacyResourcesDirectory, }
View Source
var ValidLegacyFileExtensions = []string{ FileExtensionHtmlMarkdown, FileExtensionHtmlMd, FileExtensionMarkdown, FileExtensionMd, }
View Source
var ValidRegistryDirectories = []string{ RegistryIndexDirectory, RegistryDataSourcesDirectory, RegistryGuidesDirectory, RegistryResourcesDirectory, }
View Source
var ValidRegistryFileExtensions = []string{ FileExtensionMd, }
Functions ¶
func FileSizeCheck ¶
FileSizeCheck verifies that documentation file is below the Terraform Registry storage limit.
func InvalidDirectoriesCheck ¶
func IsValidLegacyDirectory ¶
func MixedDirectoriesCheck ¶
func NumberOfFilesCheck ¶
NumberOfFilesCheck verifies that documentation is below the Terraform Registry storage limit. This check presumes that all provided directories are valid, e.g. that directory checking for invalid or mixed directory structures was previously completed.
func SideNavigationLinkCheck ¶
func SideNavigationLinkCheck(opts *SideNavigationOptions) error
func SideNavigationMismatchCheck ¶
func SideNavigationMismatchCheck(opts *SideNavigationOptions, dataSourceFiles []string, resourceFiles []string) error
func TrimFileExtension ¶
TrimFileExtension removes file extensions including those with multiple periods.
Types ¶
type Check ¶
type Check struct {
Options *CheckOptions
}
func NewCheck ¶
func NewCheck(opts *CheckOptions) *Check
type CheckOptions ¶
type CheckOptions struct {
LegacyDataSourceFile *LegacyDataSourceFileOptions
LegacyGuideFile *LegacyGuideFileOptions
LegacyIndexFile *LegacyIndexFileOptions
LegacyResourceFile *LegacyResourceFileOptions
ProviderName string
RegistryDataSourceFile *RegistryDataSourceFileOptions
RegistryGuideFile *RegistryGuideFileOptions
RegistryIndexFile *RegistryIndexFileOptions
RegistryResourceFile *RegistryResourceFileOptions
SchemaDataSources map[string]*tfjson.Schema
SchemaResources map[string]*tfjson.Schema
}
type FileOptions ¶
type FileOptions struct {
BasePath string
}
func (*FileOptions) FullPath ¶
func (opts *FileOptions) FullPath(path string) string
type FrontMatterCheck ¶
type FrontMatterCheck struct {
Options *FrontMatterOptions
}
func NewFrontMatterCheck ¶
func NewFrontMatterCheck(opts *FrontMatterOptions) *FrontMatterCheck
func (*FrontMatterCheck) Run ¶
func (check *FrontMatterCheck) Run(src []byte) error
type FrontMatterData ¶
type FrontMatterData struct {
Description *string `yaml:"description,omitempty"`
Layout *string `yaml:"layout,omitempty"`
PageTitle *string `yaml:"page_title,omitempty"`
SidebarCurrent *string `yaml:"sidebar_current,omitempty"`
Subcategory *string `yaml:"subcategory,omitempty"`
}
FrontMatterData represents the YAML frontmatter of Terraform Provider documentation.
type FrontMatterOptions ¶
type FrontMatterOptions struct {
AllowedSubcategories []string
NoDescription bool
NoLayout bool
NoPageTitle bool
NoSidebarCurrent bool
NoSubcategory bool
RequireDescription bool
RequireLayout bool
RequirePageTitle bool
RequireSubcategory bool
}
FrontMatterOptions represents configuration options for FrontMatter.
type LegacyDataSourceFileCheck ¶
type LegacyDataSourceFileCheck struct {
FileCheck
Options *LegacyDataSourceFileOptions
}
func NewLegacyDataSourceFileCheck ¶
func NewLegacyDataSourceFileCheck(opts *LegacyDataSourceFileOptions) *LegacyDataSourceFileCheck
func (*LegacyDataSourceFileCheck) Run ¶
func (check *LegacyDataSourceFileCheck) Run(path string) error
func (*LegacyDataSourceFileCheck) RunAll ¶
func (check *LegacyDataSourceFileCheck) RunAll(files []string) error
type LegacyDataSourceFileOptions ¶
type LegacyDataSourceFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type LegacyGuideFileCheck ¶
type LegacyGuideFileCheck struct {
FileCheck
Options *LegacyGuideFileOptions
}
func NewLegacyGuideFileCheck ¶
func NewLegacyGuideFileCheck(opts *LegacyGuideFileOptions) *LegacyGuideFileCheck
func (*LegacyGuideFileCheck) Run ¶
func (check *LegacyGuideFileCheck) Run(path string) error
func (*LegacyGuideFileCheck) RunAll ¶
func (check *LegacyGuideFileCheck) RunAll(files []string) error
type LegacyGuideFileOptions ¶
type LegacyGuideFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type LegacyIndexFileCheck ¶
type LegacyIndexFileCheck struct {
FileCheck
Options *LegacyIndexFileOptions
}
func NewLegacyIndexFileCheck ¶
func NewLegacyIndexFileCheck(opts *LegacyIndexFileOptions) *LegacyIndexFileCheck
func (*LegacyIndexFileCheck) Run ¶
func (check *LegacyIndexFileCheck) Run(path string) error
func (*LegacyIndexFileCheck) RunAll ¶
func (check *LegacyIndexFileCheck) RunAll(files []string) error
type LegacyIndexFileOptions ¶
type LegacyIndexFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type LegacyResourceFileCheck ¶
type LegacyResourceFileCheck struct {
FileCheck
Options *LegacyResourceFileOptions
}
func NewLegacyResourceFileCheck ¶
func NewLegacyResourceFileCheck(opts *LegacyResourceFileOptions) *LegacyResourceFileCheck
func (*LegacyResourceFileCheck) Run ¶
func (check *LegacyResourceFileCheck) Run(path string) error
func (*LegacyResourceFileCheck) RunAll ¶
func (check *LegacyResourceFileCheck) RunAll(files []string) error
type LegacyResourceFileOptions ¶
type LegacyResourceFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type RegistryDataSourceFileCheck ¶
type RegistryDataSourceFileCheck struct {
FileCheck
Options *RegistryDataSourceFileOptions
}
func NewRegistryDataSourceFileCheck ¶
func NewRegistryDataSourceFileCheck(opts *RegistryDataSourceFileOptions) *RegistryDataSourceFileCheck
func (*RegistryDataSourceFileCheck) Run ¶
func (check *RegistryDataSourceFileCheck) Run(path string) error
func (*RegistryDataSourceFileCheck) RunAll ¶
func (check *RegistryDataSourceFileCheck) RunAll(files []string) error
type RegistryDataSourceFileOptions ¶
type RegistryDataSourceFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type RegistryGuideFileCheck ¶
type RegistryGuideFileCheck struct {
FileCheck
Options *RegistryGuideFileOptions
}
func NewRegistryGuideFileCheck ¶
func NewRegistryGuideFileCheck(opts *RegistryGuideFileOptions) *RegistryGuideFileCheck
func (*RegistryGuideFileCheck) Run ¶
func (check *RegistryGuideFileCheck) Run(path string) error
func (*RegistryGuideFileCheck) RunAll ¶
func (check *RegistryGuideFileCheck) RunAll(files []string) error
type RegistryGuideFileOptions ¶
type RegistryGuideFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type RegistryIndexFileCheck ¶
type RegistryIndexFileCheck struct {
FileCheck
Options *RegistryIndexFileOptions
}
func NewRegistryIndexFileCheck ¶
func NewRegistryIndexFileCheck(opts *RegistryIndexFileOptions) *RegistryIndexFileCheck
func (*RegistryIndexFileCheck) Run ¶
func (check *RegistryIndexFileCheck) Run(path string) error
func (*RegistryIndexFileCheck) RunAll ¶
func (check *RegistryIndexFileCheck) RunAll(files []string) error
type RegistryIndexFileOptions ¶
type RegistryIndexFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type RegistryResourceFileCheck ¶
type RegistryResourceFileCheck struct {
FileCheck
Options *RegistryResourceFileOptions
}
func NewRegistryResourceFileCheck ¶
func NewRegistryResourceFileCheck(opts *RegistryResourceFileOptions) *RegistryResourceFileCheck
func (*RegistryResourceFileCheck) Run ¶
func (check *RegistryResourceFileCheck) Run(path string) error
func (*RegistryResourceFileCheck) RunAll ¶
func (check *RegistryResourceFileCheck) RunAll(files []string) error
type RegistryResourceFileOptions ¶
type RegistryResourceFileOptions struct {
*FileOptions
FrontMatter *FrontMatterOptions
}
type SideNavigationOptions ¶
type SideNavigationOptions struct {
}
func (*SideNavigationOptions) ShouldIgnoreDataSource ¶
func (opts *SideNavigationOptions) ShouldIgnoreDataSource(name string) bool
func (*SideNavigationOptions) ShouldIgnoreResource ¶
func (opts *SideNavigationOptions) ShouldIgnoreResource(name string) bool
Source Files
¶
- check.go
- directory.go
- file.go
- file_extension.go
- file_mismatch.go
- frontmatter.go
- legacy_data_source_file.go
- legacy_guide_file.go
- legacy_index_file.go
- legacy_resource_file.go
- registry_data_source_file.go
- registry_guide_file.go
- registry_index_file.go
- registry_resource_file.go
- sidenavigation_link.go
- sidenavigation_mismatch.go
- sidenavigation_options.go
Click to show internal directories.
Click to hide internal directories.