loader

Documentation

Overview

Deprecated: This package is intended for older projects transitioning from OPA v0.x and will remain for the lifetime of OPA v1.x, but its use is not recommended. For newer features and behaviours, such as defaulting to the Rego v1 syntax, use the corresponding components in the github.com/open-policy-agent/opa/v1 package instead. See https://www.openpolicyagent.org/docs/latest/v0-compatibility/ for more information.

Package loader contains utilities for loading files into OPA.

Index

• func AsBundle(path string) (*bundle.Bundle, error)
• func CleanPath(path string) string
• func Dirs(paths []string) []string
• func FilteredPaths(paths []string, filter Filter) ([]string, error)
• func FilteredPathsFS(fsys fs.FS, paths []string, filter Filter) ([]string, error)
• func GetBundleDirectoryLoader(path string) (bundle.DirectoryLoader, bool, error)
• func GetBundleDirectoryLoaderFS(fsys fs.FS, path string, filter Filter) (bundle.DirectoryLoader, bool, error)
• func GetBundleDirectoryLoaderWithFilter(path string, filter Filter) (bundle.DirectoryLoader, bool, error)
• func Paths(path string, recurse bool) (paths []string, err error)
• func Schemas(schemaPath string) (*ast.SchemaSet, error)
• func SplitPrefix(path string) ([]string, string)
• type Errors
• type FileLoader
  • func NewFileLoader() FileLoader
• type Filter
  • func GlobExcludeName(pattern string, minDepth int) Filter
• type RegoFile
  • func Rego(path string) (*RegoFile, error)
  • func RegoWithOpts(path string, opts ast.ParserOptions) (*RegoFile, error)
• type Result
  • func All(paths []string) (*Result, error)
  • func AllRegos(paths []string) (*Result, error)
  • func Filtered(paths []string, filter Filter) (*Result, error)

Functions

func AsBundle

func AsBundle(path string) (*bundle.Bundle, error)

AsBundle loads a path as a bundle. If it is a single file it will be treated as a normal tarball bundle. If a directory is supplied it will be loaded as an unzipped bundle tree. Deprecated: Use FileLoader.AsBundle() instead.

func CleanPath

func CleanPath(path string) string

CleanPath returns the normalized version of a path that can be used as an identifier.

func Dirs

func Dirs(paths []string) []string

Dirs resolves filepaths to directories. It will return a list of unique directories.

func FilteredPaths

func FilteredPaths(paths []string, filter Filter) ([]string, error)

FilteredPaths is the same as FilterPathsFS using the current diretory file system

func FilteredPathsFS

func FilteredPathsFS(fsys fs.FS, paths []string, filter Filter) ([]string, error)

FilteredPathsFS return a list of files from the specified paths while applying the given filters. If any filter returns true, the file/directory is excluded.

func GetBundleDirectoryLoader

func GetBundleDirectoryLoader(path string) (bundle.DirectoryLoader, bool, error)

GetBundleDirectoryLoader returns a bundle directory loader which can be used to load files in the directory

func GetBundleDirectoryLoaderFS

func GetBundleDirectoryLoaderFS(fsys fs.FS, path string, filter Filter) (bundle.DirectoryLoader, bool, error)

GetBundleDirectoryLoaderFS returns a bundle directory loader which can be used to load files in the directory.

func GetBundleDirectoryLoaderWithFilter

func GetBundleDirectoryLoaderWithFilter(path string, filter Filter) (bundle.DirectoryLoader, bool, error)

GetBundleDirectoryLoaderWithFilter returns a bundle directory loader which can be used to load files in the directory after applying the given filter.

func Paths

func Paths(path string, recurse bool) (paths []string, err error)

Paths returns a sorted list of files contained at path. If recurse is true and path is a directory, then Paths will walk the directory structure recursively and list files at each level.

func Schemas

func Schemas(schemaPath string) (*ast.SchemaSet, error)

Schemas loads a schema set from the specified file path.

func SplitPrefix

func SplitPrefix(path string) ([]string, string)

SplitPrefix returns a tuple specifying the document prefix and the file path.

Types

type Errors

type Errors = v1.Errors

Errors is a wrapper for multiple loader errors.

type FileLoader

type FileLoader = v1.FileLoader

FileLoader defines an interface for loading OPA data files and Rego policies.

func NewFileLoader

func NewFileLoader() FileLoader

NewFileLoader returns a new FileLoader instance.

type Filter

type Filter = v1.Filter

Filter defines the interface for filtering files during loading. If the filter returns true, the file should be excluded from the result.

func GlobExcludeName

func GlobExcludeName(pattern string, minDepth int) Filter

GlobExcludeName excludes files and directories whose names do not match the shell style pattern at minDepth or greater.

type RegoFile

type RegoFile = v1.RegoFile

RegoFile represents the result of loading a single Rego source file.

func Rego

func Rego(path string) (*RegoFile, error)

Rego is deprecated. Use RegoWithOpts instead.

func RegoWithOpts

func RegoWithOpts(path string, opts ast.ParserOptions) (*RegoFile, error)

RegoWithOpts returns a RegoFile object loaded from the given path.

type Result

type Result = v1.Result

Result represents the result of successfully loading zero or more files.

func All

func All(paths []string) (*Result, error)

All returns a Result object loaded (recursively) from the specified paths. Deprecated: Use FileLoader.Filtered() instead.

func AllRegos

func AllRegos(paths []string) (*Result, error)

AllRegos returns a Result object loaded (recursively) with all Rego source files from the specified paths.

func Filtered

func Filtered(paths []string, filter Filter) (*Result, error)

Filtered returns a Result object loaded (recursively) from the specified paths while applying the given filters. If any filter returns true, the file/directory is excluded. Deprecated: Use FileLoader.Filtered() instead.