get

Purpose

The get command is used to download a package and its dependencies.

Parameters

ram get options_without_values package_ID package_version options_with_values

Argument	Description	Required
-n	Use the -n parameter to download only the package and none of its dependencies.	No
package_ID	The ID of the package to download.	Yes, unless you specify a .json file containing a list of packages to download.
package_version	The version of the package to download. If you do not supply a package version, the most recent version is downloaded. If you supply a complete and explicit package version, then that version is downloaded. If you supply a package version that includes the wildcard (*) character, then the most recent version is downloaded.	No
-q query	Use the -q parameter to provide a query string to use when searching for the package to download.	No
-l package_list.json	Use the -l parameter to specify a .json file that contains a list of packages to download.	Yes, unless you specify a package ID.
-s snapshot_name:snapshot_version	The name and version of an environment snapshot package to create on the library server. An environment snapshot package represents all of the packages downloaded by the get command.	No
-id build_ID	The build ID to associate with the downloaded packages. The build ID is used to resolve the SNAPSHOT variable.	No
-d pathname	The location to download the package to. If no location is specified, the package is downloaded to the current directory.	No
-config configuration_file	The complete path to the configuration file to use for communication with the library server. If you do not specify a configuration file on the command line, the default configuration file in the .ram subdirectory in the home directory of the current user is used.	No, as long as the default configuration file exists in the .ram subdirectory of the home directory of the current user.

Package list syntax

Use the -l parameter to specify a .json file that contains a list of packages to download.

id

The package ID is required unless you provide a query string.

version

If you do not supply a package version, the most recent version is downloaded. If you supply a complete and explicit package version, then that version is downloaded. If you supply a package version that includes the wildcard (*) character, then the most recent version is downloaded.

query

If you do not specify an ID, you must specify a query string to use when searching for the package to download.

Example package list file

{
  "packages" : [
    { "id" : "jke" , "version" : "2.1.0-*" },
    { "id" : "devops_cookbooks-3.0", "query" : "state:(ready for verification)" }
  ]}

ram get -n newpackage 2.1.0-*