Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AnnotatedReadCloser ¶
type AnnotatedReadCloser interface {
io.ReadCloser
Annotate() interface{}
}
AnnotatedReadCloser is a wrapper around io.ReadCloser that allows implementations to supply additional information about data that is read.
type Backend ¶
type Backend interface {
Init(context.Context, ...BackendOption) (io.ReadCloser, error)
}
Backend provides a source for a parser.
type BackendOption ¶
type BackendOption func(Backend)
BackendOption modifies the parser backend. Backends may accept options at creation time, but must accept them at initialization.
func FsFilters ¶
func FsFilters(skips ...FilterFn) BackendOption
FsFilters adds FilterFns to an FsBackend.
type FilterFn ¶
A FilterFn filters files when the FsReadCloser walks the filesystem. Returning true indicates the file should be skipped. Returning an error will cause the FsReadCloser to stop walking the filesystem and return.
func SkipNotYAML ¶
func SkipNotYAML() FilterFn
SkipNotYAML skips files that do not have YAML extension.
type FsBackend ¶
type FsBackend struct {
// contains filtered or unexported fields
}
FsBackend is a parser backend that uses a filestystem as source.
func NewFsBackend ¶
func NewFsBackend(fs afero.Fs, bo ...BackendOption) *FsBackend
NewFsBackend returns an FsBackend.
func (*FsBackend) Init ¶
func (p *FsBackend) Init(ctx context.Context, bo ...BackendOption) (io.ReadCloser, error)
Init initializes an FsBackend.
type FsReadCloser ¶
type FsReadCloser struct {
// contains filtered or unexported fields
}
FsReadCloser implements io.ReadCloser for an Afero filesystem.
func NewFsReadCloser ¶
NewFsReadCloser returns an FsReadCloser that implements io.ReadCloser. It walks the filesystem ahead of time, then reads file contents when Read is invoked. It does not follow symbolic links.
func (*FsReadCloser) Annotate ¶
func (r *FsReadCloser) Annotate() interface{}
Annotate returns additional about the data currently being read.
func (*FsReadCloser) Close ¶
func (r *FsReadCloser) Close() error
Close is a no op for an FsReadCloser.
type FsReadCloserAnnotation ¶
type FsReadCloserAnnotation struct {
// contains filtered or unexported fields
}
FsReadCloserAnnotation annotates data for an FsReadCloser.
type NopBackend ¶
type NopBackend struct{}
NopBackend is a parser backend with empty source.
func NewNopBackend ¶
func NewNopBackend(...BackendOption) *NopBackend
NewNopBackend returns a new NopBackend.
func (*NopBackend) Init ¶
func (p *NopBackend) Init(ctx context.Context, bo ...BackendOption) (io.ReadCloser, error)
Init initializes a NopBackend.
type ObjectCreaterTyper ¶
type ObjectCreaterTyper interface {
runtime.ObjectCreater
runtime.ObjectTyper
}
ObjectCreaterTyper know how to create and determine the type of objects.
type ObjectLinterFn ¶
ObjectLinterFn lints an object in a package.
func ObjectLinterFns ¶
func ObjectLinterFns(fns ...ObjectLinterFn) []ObjectLinterFn
ObjectLinterFns is a convenience function to pass multiple ObjectLinterFn to a function that cannot accept variadic arguments.
func Or ¶
func Or(a, b ObjectLinterFn) ObjectLinterFn
Or checks that at least one of the passed linter functions does not return an error.
type Package ¶
type Package struct {
// contains filtered or unexported fields
}
Package is the set of metadata and objects in a package.
func (*Package) GetObjects ¶
GetObjects gets objects from the package.
type PackageLinter ¶
type PackageLinter struct {
// contains filtered or unexported fields
}
PackageLinter lints packages by applying package and object linter functions to it.
func NewPackageLinter ¶
func NewPackageLinter(pre []PackageLinterFn, perMeta, perObject []ObjectLinterFn) *PackageLinter
NewPackageLinter creates a new PackageLinter.
func (*PackageLinter) Lint ¶
func (l *PackageLinter) Lint(pkg *Package) error
Lint executes all linter functions against a package.
type PackageLinterFn ¶
PackageLinterFn lints an entire package. If function applies a check for multiple objects, consider using an ObjectLinterFn.
func PackageLinterFns ¶
func PackageLinterFns(fns ...PackageLinterFn) []PackageLinterFn
PackageLinterFns is a convenience function to pass multiple PackageLinterFn to a function that cannot accept variadic arguments.
type PackageParser ¶
type PackageParser struct {
// contains filtered or unexported fields
}
PackageParser is a Parser implementation for parsing packages.
func (*PackageParser) Parse ¶
func (p *PackageParser) Parse(ctx context.Context, reader io.ReadCloser) (*Package, error)
Parse is the underlying logic for parsing packages. It first attempts to decode objects recognized by the meta scheme, then attempts to decode objects recognized by the object scheme. Objects not recognized by either scheme return an error rather than being skipped.
Source Files