compactor

Documentation

Index

• func AddPlugin(plugin *Plugin)
• func AppendFile(path string, root string) error
• func Delete(options *Options, file *File) error
• func IndexFiles(options *Options, root string) error
• func Process(options *Options, file *File) error
• func RemoveFile(path string)
• func RemovePlugin(namespace string)
• func UpdateFile(path string) error
• type Compress
• type Destination
• type File
  • func FindPackage(options *Options, path string) *File
  • func FindPackages(options *Options) []*File
  • func GetFile(path string) *File
  • func GetFiles() []*File
  • func (f *File) FindRelated(onlyDependencies bool) []Related
• type InitFunc
• type OptimizeFunc
• type Options
  • func (o *Options) CleanPath(path string) string
  • func (o *Options) MatchPatterns(file string, patterns []string) bool
  • func (o *Options) ShouldCompress(path string) bool
  • func (o *Options) ShouldGenerateProgressive(path string) bool
  • func (o *Options) ShouldGenerateSourceMap(path string) bool
  • func (o *Options) ShouldInclude(path string) bool
  • func (o *Options) ToDestination(path string) string
  • func (o *Options) ToExtension(path string, extension string) string
  • func (o *Options) ToHashed(path string, hash string) string
  • func (o *Options) ToNonHashed(path string, hash string) string
  • func (o *Options) ToSource(path string) string
• type Plugin
  • func GetPlugin(extension string) *Plugin
• type Progressive
• type Related
• type RelatedFunc
• type ResolveFunc
• type Source
• type SourceMap
• type TransformFunc

Functions

func AddPlugin

func AddPlugin(plugin *Plugin)

AddPlugin add a new plugin to the index

func AppendFile

func AppendFile(path string, root string) error

AppendFile appends file information to index from its path

func Delete

func Delete(options *Options, file *File) error

Delete removes the destination file(s) for given file

func IndexFiles

func IndexFiles(options *Options, root string) error

IndexFile index the root path files to the index, resolve related and determine destination

func Process

func Process(options *Options, file *File) error

Process execute file packaging by running plugin methods

func RemoveFile

func RemoveFile(path string)

RemoveFile removes the file information from index if match path

func RemovePlugin

func RemovePlugin(namespace string)

RemovePlugin removes all plugins from index that match the given namespace

func UpdateFile

func UpdateFile(path string) error

UpdateFile updates file information on index if matches path

Types

type Compress

type Compress struct {
	Enabled bool
	Include []string
	Exclude []string
}

Compress struct

type Destination

type Destination struct {
	Path   string
	Hashed bool
}

Destination struct

type File

type File struct {
	Path        string      // Full path (root + location)
	Destination string      // Full destination path
	Root        string      // Root location
	Location    string      // Location from root
	Folder      string      // Location folder
	File        string      // File name with extension
	Name        string      // File name
	Extension   string      // File Extension
	Content     string      // File content
	Permission  fs.FileMode // File permissions
	Exists      bool        // File exists flag
	Checksum    string      // Current Checksum
	Previous    string      // Previous Checksum
	Related     []Related   // Related items
}

File struct

func FindPackage

func FindPackage(options *Options, path string) *File

FindPackage retrieves the related package from given path

func FindPackages

func FindPackages(options *Options) []*File

FindPackages retrieves the full list of detected packages

func GetFile

func GetFile(path string) *File

GetFile retrieves the file that match path on index

func GetFiles

func GetFiles() []*File

GetFiles retrieve the indexed files

func (*File) FindRelated

func (f *File) FindRelated(onlyDependencies bool) []Related

FindRelated retrieve the related paths of the item recursively

type InitFunc

type InitFunc = func(options *Options) error

Init function Used to start up the plugin and check for their dependencies

type OptimizeFunc

type OptimizeFunc = func(options *Options, file *File) error

Optimize function Used to run optimizations algorithms to compress file

type Options

type Options struct {
	Source      Source
	Destination Destination
	Compress    Compress
	SourceMap   SourceMap
	Progressive Progressive
}

Options struct

func (*Options) CleanPath

func (o *Options) CleanPath(path string) string

CleanPath return the clean path, without source and destination path

func (*Options) MatchPatterns

func (o *Options) MatchPatterns(file string, patterns []string) bool

MatchPatterns return if file match one of the given patterns

func (*Options) ShouldCompress

func (o *Options) ShouldCompress(path string) bool

ShouldCompress return if compress should be enabled for given path

func (*Options) ShouldGenerateProgressive

func (o *Options) ShouldGenerateProgressive(path string) bool

ShouldGenerateProgressive return if progressive formats should be generated for given path

func (*Options) ShouldGenerateSourceMap

func (o *Options) ShouldGenerateSourceMap(path string) bool

ShouldGenerateSourceMap return if source map should be generated for given path

func (*Options) ShouldInclude

func (o *Options) ShouldInclude(path string) bool

ShouldInclude return if path should be included on the bundle

func (*Options) ToDestination

func (o *Options) ToDestination(path string) string

ToDestination transform and return the full destination path for given path

func (*Options) ToExtension

func (o *Options) ToExtension(path string, extension string) string

ToExtension return a file path converted to a specific extension

func (*Options) ToHashed

func (o *Options) ToHashed(path string, hash string) string

ToHashed return a file path converted to a hashed name to avoid caching

func (*Options) ToNonHashed

func (o *Options) ToNonHashed(path string, hash string) string

ToNonHashed return a file path converted back to a non hashed name

func (*Options) ToSource

func (o *Options) ToSource(path string) string

ToSource transform and return the full source path for given path

type Plugin

type Plugin struct {
	Namespace  string
	Extensions []string
	Init       InitFunc
	Resolve    ResolveFunc
	Related    RelatedFunc
	Transform  TransformFunc
	Optimize   OptimizeFunc
}

Plugin struct

func GetPlugin

func GetPlugin(extension string) *Plugin

GetPlugin retrieves the first found plugin for the given extension

type Progressive

type Progressive struct {
	Enabled bool
	Include []string
	Exclude []string
}

Progressive struct

type Related

type Related struct {
	Type       string
	Dependency bool
	Source     string
	Path       string
	File       *File
}

Related struct

type RelatedFunc

type RelatedFunc = func(options *Options, file *File) ([]Related, error)

Related function Detects and generates the list of related files to the given item, being a dependency or not

type ResolveFunc

type ResolveFunc = func(options *Options, file *File) (string, error)

Resolve function Used to transform the source path to the final destination path

type Source

type Source struct {
	Path    string
	Include []string
	Exclude []string
}

Source struct

type SourceMap

type SourceMap struct {
	Enabled bool
	Include []string
	Exclude []string
}

SourceMap struct

type TransformFunc

type TransformFunc = func(options *Options, file *File) error

Transform function Used to transform the file content to the final format by applying compilation if necessary