Method Command

cmds/cmd_configure.go:63–249

(celer *configs.Celer)

}

func (c *configureCmd) Command(celer *configs.Celer) *cobra.Command {
	c.celer = celer
	command := &cobra.Command{
		Use:   "configure",
		Short: "Configure settings for your workspace.",
		Long: `Configure settings for your workspace.

This command allows you to modify various configuration settings that affect
how celer works. You can configure one setting or one related group of settings
in a single command (do not mix flags from different groups).

Available Configuration Options:

  Platform Configuration:
    --platform                  Set the target platform (e.g., x86_64-linux-ubuntu-22.04-gcc-11.5.0)

  Project Configuration:
    --project                   Set the current project configuration

  Build Configuration:
    --build-type                Set the build type (Release, Debug, RelWithDebInfo, MinSizeRel)
    --downloads                 Set the download directory
    --jobs                      Set the number of parallel build jobs

  Runtime Options:
    --offline                   Enable/disable offline mode (true/false)
    --verbose                   Enable/disable verbose output (true/false)

  PkgCache Configuration:
    --pkgcache-dir              Set the pkgcache directory path
    --pkgcache-writable         Set whether the package cache is writable (true/false)
    --pkgcache-cache-artifacts  Cache built artifacts into the package cache (true/false)
    --pkgcache-cache-downloads  Cache downloaded sources into the package cache (true/false)

  Proxy Configuration:
    --proxy-host                Set the proxy server hostname
    --proxy-port                Set the proxy server port number

  CCache Configuration:
    --ccache-enabled            Enable/disable ccache (true/false)
    --ccache-dir                Set the ccache directory path
    --ccache-maxsize            Set the maximum cache size (e.g., "5G", "1024M")
    --ccache-remote-storage     Set remote storage address for ccache (e.g., http://host:port/path)
    --ccache-remote-only        Use remote ccache only, skip local cache (true/false)

  Port Configuration:
    --port                      Target port to update, in name@version form (e.g., eigen@3.4.0)
    --port-url                  New source URL for the port (requires --port)
    --port-ref                  New ref for the port — branch, tag, or commit (requires --port)

Examples:
  celer configure --platform=x86_64-linux-ubuntu-22.04-gcc-11.5.0  # Set target platform
  celer configure --project=myproject                              # Set current project
  celer configure --build-type=Release                             # Set build type to Release
  celer configure --downloads=/home/xxx/Downloads                  # Set download directory
  celer configure --jobs=8                                         # Use 8 parallel build jobs
  celer configure --offline=true                                   # Enable offline mode
  celer configure --verbose=false                                  # Disable verbose output