client

package
v0.9.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 2, 2024 License: Apache-2.0 Imports: 33 Imported by: 12

Documentation

Index

Constants

View Source 
const PKG_NAME_PATTERN = "%s_%s"

Variables

This section is empty.

Functions

func DFS added in v0.8.0 

func DFS(graph DependencyGraph, dependency string, visited map[string]bool, result []string) []string

Traverse dependency graph using depth-first search (DFS)

func GetReleasesFromSource added in v0.8.7 

func GetReleasesFromSource(sourceType, uri string) ([]string, error)

func OutputDependencies added in v0.8.0 

func OutputDependencies(graph DependencyGraph) []string

Output dependencies in the same format as go mod graph

Types

type ArchiveVisitor added in v0.9.1 

type ArchiveVisitor struct {
	*PkgVisitor
}

ArchiveVisitor is the visitor for visiting a package which is a local tar/tgz path.

func NewArchiveVisitor added in v0.9.1 

func NewArchiveVisitor(pv *PkgVisitor) *ArchiveVisitor

NewArchiveVisitor creates a new ArchiveVisitor.

func (*ArchiveVisitor) Visit added in v0.9.1 

func (av *ArchiveVisitor) Visit(s *downloader.Source, v visitFunc) error

Visit visits a package which is a local tar/tgz path. It will extract the archive file to a temporary directory. And the tmp directory will be cleaned after the visitFunc is executed.

type DependencyGraph added in v0.8.0 

type DependencyGraph map[string][]string

Construct dependency graph

func ConstructDependencyGraph added in v0.8.0 

func ConstructDependencyGraph(dependencies map[string]map[string]string) DependencyGraph

Function to construct dependency graph from dependency map

func ConstructDependencyGraphFromModFile added in v0.8.0 

func ConstructDependencyGraphFromModFile(kpmClient *KpmClient, kclPkg *pkg.KclPkg) (DependencyGraph, error)

Function to construct dependency graph by parsing kcl.mod file

type KpmClient 

type KpmClient struct {

	// The downloader of the dependencies.
	DepDownloader *downloader.DepDownloader
	// contains filtered or unexported fields
}

KpmClient is the client of kpm.

func NewKpmClient 

func NewKpmClient() (*KpmClient, error)

NewKpmClient will create a new kpm client with default settings.

func (*KpmClient) AcquireDepSum added in v0.8.7 

func (c *KpmClient) AcquireDepSum(dep pkg.Dependency) (string, error)

AcquireDepSum will acquire the checksum of the dependency from the OCI registry.

func (*KpmClient) AcquirePackageCacheLock 

func (c *KpmClient) AcquirePackageCacheLock() error

AcquirePackageCacheLock will acquire the lock of the package cache.

func (*KpmClient) AcquireTheLatestOciVersion added in v0.8.7 

func (c *KpmClient) AcquireTheLatestOciVersion(ociSource downloader.Oci) (string, error)

AcquireTheLatestOciVersion will acquire the latest version of the OCI reference.

func (*KpmClient) AddDepToPkg 

func (c *KpmClient) AddDepToPkg(kclPkg *pkg.KclPkg, d *pkg.Dependency) error

AddDepToPkg will add a dependency to the kcl package.

func (*KpmClient) AddDepWithOpts 

func (c *KpmClient) AddDepWithOpts(kclPkg *pkg.KclPkg, opt *opt.AddOptions) (*pkg.KclPkg, error)

AddDepWithOpts will add a dependency to the current kcl package.

func (*KpmClient) Compile 

func (c *KpmClient) Compile(kclPkg *pkg.KclPkg, kclvmCompiler *runner.Compiler) (*kcl.KCLResultList, error)

Compile will call kcl compiler to compile the current kcl package and its dependent packages.

func (*KpmClient) CompileGitPkg added in v0.8.0 

func (c *KpmClient) CompileGitPkg(gitOpts *git.CloneOptions, compileOpts *opt.CompileOptions) (*kcl.KCLResultList, error)

CompileGitPkg will compile the kcl package from the git url.

func (*KpmClient) CompileOciPkg 

func (c *KpmClient) CompileOciPkg(ociSource, version string, opts *opt.CompileOptions) (*kcl.KCLResultList, error)

CompileOciPkg will compile the kcl package from the OCI reference or url.

func (*KpmClient) CompilePkgWithOpts 

func (c *KpmClient) CompilePkgWithOpts(kclPkg *pkg.KclPkg, opts *opt.CompileOptions) (*kcl.KCLResultList, error)

CompilePkgWithOpts will compile the kcl package with the compile options.

func (*KpmClient) CompileTarPkg 

func (c *KpmClient) CompileTarPkg(tarPath string, opts *opt.CompileOptions) (*kcl.KCLResultList, error)

CompileTarPkg will compile the kcl package from the tar package.

func (*KpmClient) CompileWithOpts 

func (c *KpmClient) CompileWithOpts(opts *opt.CompileOptions) (*kcl.KCLResultList, error)

CompileWithOpts will compile the kcl program with the compile options.

func (*KpmClient) Download 

func (c *KpmClient) Download(dep *pkg.Dependency, homePath, localPath string) (*pkg.Dependency, error)

Download will download the dependency to the local path.

func (*KpmClient) DownloadDeps added in v0.8.7 

func (c *KpmClient) DownloadDeps(deps *pkg.Dependencies, lockDeps *pkg.Dependencies, depGraph graph.Graph[module.Version, module.Version], pkghome string, parent module.Version) (*pkg.Dependencies, error)

downloadDeps will download all the dependencies of the current kcl package.

func (*KpmClient) DownloadFromGit 

func (c *KpmClient) DownloadFromGit(dep *downloader.Git, localPath string) (string, error)

DownloadFromGit will download the dependency from the git repository.

func (*KpmClient) DownloadFromOci 

func (c *KpmClient) DownloadFromOci(dep *downloader.Oci, localPath string) (string, error)

DownloadFromOci will download the dependency from the oci repository. Deprecated: Use the DownloadPkgFromOci instead.

func (*KpmClient) DownloadPkgFromOci added in v0.8.3 

func (c *KpmClient) DownloadPkgFromOci(dep *downloader.Oci, localPath string) (*pkg.KclPkg, error)

LoadPkgFromOci will download the kcl package from the oci repository and return an `KclPkg`.

func (*KpmClient) FetchOciManifestIntoJsonStr 

func (c *KpmClient) FetchOciManifestIntoJsonStr(opts opt.OciFetchOptions) (string, error)

FetchOciManifestConfIntoJsonStr will fetch the oci manifest config of the kcl package from the oci registry and return it into json string.

func (*KpmClient) FillDepInfo 

func (c *KpmClient) FillDepInfo(dep *pkg.Dependency, homepath string) error

FillDepInfo will fill registry information for a dependency.

func (*KpmClient) FillDependenciesInfo 

func (c *KpmClient) FillDependenciesInfo(modFile *pkg.ModFile) error

FillDependenciesInfo will fill registry information for all dependencies in a kcl.mod.

func (*KpmClient) GetCredentials added in v0.9.1 

func (c *KpmClient) GetCredentials(hostName string) (*remoteauth.Credential, error)

GetCredentials will return the credentials of the host.

func (*KpmClient) GetCredsClient added in v0.9.1 

func (c *KpmClient) GetCredsClient() (*downloader.CredClient, error)

GetCredsClient will return the credential client.

func (*KpmClient) GetLogWriter 

func (c *KpmClient) GetLogWriter() io.Writer

func (*KpmClient) GetNoSumCheck added in v0.4.4 

func (c *KpmClient) GetNoSumCheck() bool

GetNoSumCheck will return the 'noSumCheck' flag.

func (*KpmClient) GetSettings 

func (c *KpmClient) GetSettings() *settings.Settings

GetSettings will return the settings of kpm client.

func (*KpmClient) InitEmptyPkg 

func (c *KpmClient) InitEmptyPkg(kclPkg *pkg.KclPkg) error

InitEmptyPkg will initialize an empty kcl package.

func (*KpmClient) InitGraphAndDownloadDeps added in v0.8.0 

func (c *KpmClient) InitGraphAndDownloadDeps(kclPkg *pkg.KclPkg) (*pkg.Dependencies, graph.Graph[module.Version, module.Version], error)

InitGraphAndDownloadDeps initializes a dependency graph and call downloadDeps function.

func (*KpmClient) LoadLockDeps added in v0.4.0 

func (c *KpmClient) LoadLockDeps(pkgPath string) (*pkg.Dependencies, error)

Load the kcl.mod.lock and acquire the checksum of the dependencies from OCI registry.

func (*KpmClient) LoadModFile added in v0.4.0 

func (c *KpmClient) LoadModFile(pkgPath string) (*pkg.ModFile, error)

func (*KpmClient) LoadPkgFromPath added in v0.4.0 

func (c *KpmClient) LoadPkgFromPath(pkgPath string) (*pkg.KclPkg, error)

func (*KpmClient) LoginOci 

func (c *KpmClient) LoginOci(hostname, username, password string) error

LoginOci will login to the oci registry.

func (*KpmClient) LogoutOci 

func (c *KpmClient) LogoutOci(hostname string) error

LogoutOci will logout from the oci registry.

func (*KpmClient) Package 

func (c *KpmClient) Package(kclPkg *pkg.KclPkg, tarPath string, vendorMode bool) error

Package will package the current kcl package into a "*.tar" file into 'tarPath'.

func (*KpmClient) PackagePkg 

func (c *KpmClient) PackagePkg(kclPkg *pkg.KclPkg, vendorMode bool) (string, error)

PackagePkg will package the current kcl package into a "*.tar" file in under the package path.

func (*KpmClient) ParseKclModFile added in v0.8.0 

func (c *KpmClient) ParseKclModFile(kclPkg *pkg.KclPkg) (map[string]map[string]string, error)

func (*KpmClient) ParseOciOptionFromString 

func (c *KpmClient) ParseOciOptionFromString(oci string, tag string) (*opt.OciOptions, error)

ParseOciOptionFromString will parser '<repo_name>:<repo_tag>' into an 'OciOptions' with an OCI registry. the default OCI registry is 'docker.io'. if the 'ociUrl' is only '<repo_name>', ParseOciOptionFromString will take 'latest' as the default tag.

func (*KpmClient) ParseOciRef 

func (c *KpmClient) ParseOciRef(ociRef string) (*opt.OciOptions, error)

ParseOciRef will parser '<repo_name>:<repo_tag>' into an 'OciOptions'.

func (*KpmClient) Pull added in v0.9.0 

func (c *KpmClient) Pull(options ...PullOption) (*pkg.KclPkg, error)

func (*KpmClient) PullFromOci 

func (c *KpmClient) PullFromOci(localPath, source, tag string) error

PullFromOci will pull a kcl package from oci registry and unpack it.

func (*KpmClient) PushToOci 

func (c *KpmClient) PushToOci(localPath string, ociOpts *opt.OciOptions) error

PushToOci will push a kcl package to oci registry.

func (*KpmClient) ReleasePackageCacheLock 

func (c *KpmClient) ReleasePackageCacheLock() error

ReleasePackageCacheLock will release the lock of the package cache.

func (*KpmClient) ResolveDepsIntoMap 

func (c *KpmClient) ResolveDepsIntoMap(kclPkg *pkg.KclPkg) (map[string]string, error)

ResolveDepsIntoMap will calculate the map of kcl package name and local storage path of the external packages.

func (*KpmClient) ResolveDepsMetadataInJsonStr 

func (c *KpmClient) ResolveDepsMetadataInJsonStr(kclPkg *pkg.KclPkg, update bool) (string, error)

ResolveDepsMetadataInJsonStr will calculate the local storage path of the external package, and check whether the package exists locally. If the package does not exist, it will re-download to the local. Finally, the calculated metadata of the dependent packages is serialized into a json string and returned.

func (*KpmClient) ResolvePkgDepsMetadata 

func (c *KpmClient) ResolvePkgDepsMetadata(kclPkg *pkg.KclPkg, update bool) error

ResolveDepsMetadata will calculate the local storage path of the external package, and check whether the package exists locally. If the package does not exist, it will re-download to the local. Since redownloads are not triggered if local dependencies exists, indirect dependencies are also synchronized to the lock file by `lockDeps`.

func (*KpmClient) Run added in v0.9.1 

func (c *KpmClient) Run(options ...RunOption) (*kcl.KCLResultList, error)

Run runs the kcl package.

func (*KpmClient) RunWithOpts added in v0.8.6 

func (c *KpmClient) RunWithOpts(opts ...opt.Option) (*kcl.KCLResultList, error)

RunWithOpts will compile the kcl package with the compile options.

func (*KpmClient) SetHomePath 

func (c *KpmClient) SetHomePath(homePath string)

SetHomePath will set the home path of kpm.

func (*KpmClient) SetLogWriter 

func (c *KpmClient) SetLogWriter(writer io.Writer)

func (*KpmClient) SetNoSumCheck added in v0.4.4 

func (c *KpmClient) SetNoSumCheck(noSumCheck bool)

SetNoSumCheck will set the 'noSumCheck' flag.

func (*KpmClient) UpdateDeps added in v0.4.0 

func (c *KpmClient) UpdateDeps(kclPkg *pkg.KclPkg) error

UpdateDeps will update the dependencies.

func (*KpmClient) VendorDeps 

func (c *KpmClient) VendorDeps(kclPkg *pkg.KclPkg) error

VendorDeps will vendor all the dependencies of the current kcl package.

type PkgVisitor added in v0.9.1 

type PkgVisitor struct {
	// contains filtered or unexported fields
}

PkgVisitor is the visitor for visiting a local package.

func NewPkgVisitor added in v0.9.1 

func NewPkgVisitor(kpmcli *KpmClient) *PkgVisitor

NewPkgVisitor creates a new PkgVisitor.

func (*PkgVisitor) Visit added in v0.9.1 

func (pv *PkgVisitor) Visit(s *downloader.Source, v visitFunc) error

Visit visits a local package.

type PullOption added in v0.9.0 

type PullOption func(*PullOptions) error

func WithLocalPath added in v0.9.0 

func WithLocalPath(path string) PullOption

func WithPullSource added in v0.9.0 

func WithPullSource(source *downloader.Source) PullOption

func WithPullSourceUrl added in v0.9.0 

func WithPullSourceUrl(sourceUrl string) PullOption

type PullOptions added in v0.9.0 

type PullOptions struct {
	// Source is the source of the package to be pulled.
	// Including git, oci, local.
	Source *downloader.Source
	// LocalPath is the local path to download the package.
	LocalPath string
}

The PullOptions struct contains the options for pulling a package from the registry.

func NewPullOptions added in v0.9.0 

func NewPullOptions(opts ...PullOption) *PullOptions

type RemoteVisitor added in v0.9.1 

type RemoteVisitor struct {
	*PkgVisitor
}

RemoteVisitor is the visitor for visiting a remote package.

func NewRemoteVisitor added in v0.9.1 

func NewRemoteVisitor(pv *PkgVisitor) *RemoteVisitor

NewRemoteVisitor creates a new RemoteVisitor.

func (*RemoteVisitor) Visit added in v0.9.1 

func (rv *RemoteVisitor) Visit(s *downloader.Source, v visitFunc) error

Visit visits a remote package. It will download the remote package to a temporary directory. And the tmp directory will be cleaned after the visitFunc is executed.

type RunOption added in v0.9.1 

type RunOption func(*RunOptions) error

func WithArguments added in v0.9.1 

func WithArguments(args []string) RunOption

WithArguments sets the arguments for running the kcl package.

func WithCompileOnly added in v0.9.1 

func WithCompileOnly(compileOnly bool) RunOption

WithCompileOnly sets the compile only mode for running the kcl package.

func WithDebug added in v0.9.1 

func WithDebug(debug bool) RunOption

WithDebug sets the debug mode for running the kcl package.

func WithDisableNone added in v0.9.1 

func WithDisableNone(disableNone bool) RunOption

WithDisableNone sets the disable none mode for running the kcl package.

func WithExternalPkgs added in v0.9.1 

func WithExternalPkgs(externalPkgs []string) RunOption

WithExternalPkgs sets the external packages for running the kcl package.

func WithLogger added in v0.9.4 

func WithLogger(l io.Writer) RunOption

func WithOverrides added in v0.9.1 

func WithOverrides(overrides []string, debug bool) RunOption

WithOverrides sets the overrides for running the kcl package.

func WithPathSelectors added in v0.9.1 

func WithPathSelectors(pathSelectors []string) RunOption

WithPathSelectors sets the path selectors for running the kcl package.

func WithRunSource added in v0.9.1 

func WithRunSource(source *downloader.Source) RunOption

WithRunSources sets the source for running the kcl package.

func WithRunSourceUrl added in v0.9.1 

func WithRunSourceUrl(sourceUrl string) RunOption

WithRunSourceUrl sets the source url for running the kcl package.

func WithRunSourceUrls added in v0.9.1 

func WithRunSourceUrls(sourceUrls []string) RunOption

WithRunSourceUrls sets the source urls for running the kcl package.

func WithRunSources added in v0.9.1 

func WithRunSources(sources []*downloader.Source) RunOption

WithRunSources sets the sources for running the kcl package.

func WithSettingFiles added in v0.9.1 

func WithSettingFiles(settingFiles []string) RunOption

WithSettingFiles sets the setting files for running the kcl package.

func WithShowHidden added in v0.9.1 

func WithShowHidden(showHidden bool) RunOption

WithShowHidden sets the show hidden mode for running the kcl package.

func WithSortKeys added in v0.9.1 

func WithSortKeys(sortKeys bool) RunOption

WithSortKeys sets the sort keys for running the kcl package.

func WithStrictRange added in v0.9.1 

func WithStrictRange(strictRange bool) RunOption

WithStrictRange sets the strict range mode for running the kcl package.

func WithVendor added in v0.9.1 

func WithVendor(vendor bool) RunOption

WithVendor sets the vendor mode for running the kcl package.

func WithWorkDir added in v0.9.1 

func WithWorkDir(workDir string) RunOption

WithWorkDir sets the work directory for running the kcl package.

type RunOptions added in v0.9.1 

type RunOptions struct {

	// Sources is the sources of the package.
	// It can be a local *.k path, a local *.tar/*.tgz path, a local directory, a remote git/oci path,.
	Sources []*downloader.Source
	*kcl.Option
	// contains filtered or unexported fields
}

RunOptions contains the options for running a kcl package.

type VirtualPkgVisitor added in v0.9.1 

type VirtualPkgVisitor struct {
	*PkgVisitor
}

VirtualPkgVisitor is the visitor for visiting a package which do not have a kcl.mod file in the root path.

func NewVirtualPkgVisitor added in v0.9.1 

func NewVirtualPkgVisitor(pv *PkgVisitor) *VirtualPkgVisitor

NewVirtualPkgVisitor creates a new VirtualPkgVisitor.

func (*VirtualPkgVisitor) Visit added in v0.9.1 

func (vpv *VirtualPkgVisitor) Visit(s *downloader.Source, v visitFunc) error

Visit visits a package which do not have a kcl.mod file in the root path. It will create a virtual kcl.mod file in the root path. And then kcl.mod file will be cleaned after the visitFunc is executed.

type Visitor added in v0.9.1 

type Visitor interface {
	Visit(s *downloader.Source, v visitFunc) error
}

Visitor is the interface for visiting a package which is a local path, a remote git/oci path, or a local tar path.

func NewVisitor added in v0.9.1 

func NewVisitor(source downloader.Source, kpmcli *KpmClient) Visitor

NewVisitor is a factory function to create a new Visitor.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.