csit/libraries/NexusKeywords.robot

   1 *** Settings ***
   2 Documentation     Nexus repository access keywords, and supporting Java and Maven handling.
   3 ...
   4 ...               Copyright (c) 2015,2016 Cisco Systems, Inc. and others. All rights reserved.
   5 ...
   6 ...               This program and the accompanying materials are made available under the
   7 ...               terms of the Eclipse Public License v1.0 which accompanies this distribution,
   8 ...               and is available at http://www.eclipse.org/legal/epl-v10.html
   9 ...
  10 ...
  11 ...               This library encapsulates a bunch of somewhat complex and commonly used
  12 ...               Nexus operations into reusable keywords to make writing test suites easier.
  13 ...
  14 ...               Currently, Java version detection is incorporated so that Java tools can be run reliably.
  15 ...               Also, suport for installing and running Maven is added, as that needs the Java detection.
  16 ...               TODO: Move Java detection and Maven to a separate Resource, or rename this Resource.
  17 Library           Collections
  18 Library           OperatingSystem
  19 Library           SSHLibrary
  20 Library           String
  21 Library           XML
  22 Library           Collections
  23 Library           RequestsLibrary
  24 Resource          ${CURDIR}/CompareStream.robot
  25 Resource          ${CURDIR}/SSHKeywords.robot
  26 Resource          ${CURDIR}/Utils.robot
  27
  28 *** Variables ***
  29 &{COMPONENT_MAPPING}    netconf=netconf-impl    bgpcep=pcep-impl    carpeople=clustering-it-model    yangtools=yang-data-impl    bindingv1=mdsal-binding-generator-impl    odl-micro=odlmicro-impl
  30 @{RELEASE_INTEGRATED_COMPONENTS}    mdsal    odlparent    yangtools    carpeople    netconf    bgpcep
  31 ${JDKVERSION}     None
  32 ${JAVA_8_HOME_CENTOS}    /usr/lib/jvm/java-1.8.0
  33 ${JAVA_8_HOME_UBUNTU}    /usr/lib/jvm/java-8-openjdk-amd64
  34 ${JAVA_11_HOME_CENTOS}    /usr/lib/jvm/java-11-openjdk
  35 ${JAVA_11_HOME_UBUNTU}    /usr/lib/jvm/java-11-openjdk-amd64
  36 ${JAVA_OPTIONS}    -Xmx2560m    # Note that '-Xmx=3g' is wrong syntax. Also 3GB heap may not fit in 4GB RAM.
  37 ${MAVEN_DEFAULT_OUTPUT_FILENAME}    default_maven.log
  38 ${MAVEN_OPTIONS}    -Pq -Djenkins
  39 ${MAVEN_REPOSITORY_PATH}    /tmp/r
  40 ${MAVEN_SETTINGS_URL}    https://raw.githubusercontent.com/opendaylight/odlparent/master/settings.xml
  41 ${MAVEN_VERSION}    3.3.9
  42 ${NEXUS_FALLBACK_URL}    ${NEXUSURL_PREFIX}/content/repositories/opendaylight.snapshot
  43 ${NEXUS_RELEASE_BASE_URL}    https://nexus.opendaylight.org/content/repositories/opendaylight.release
  44 ${NEXUS_RELEASES_URL}    ${NEXUS_RELEASE_BASE_URL}/org/opendaylight/integration/karaf
  45
  46 *** Keywords ***
  47 Initialize_Artifact_Deployment_And_Usage
  48     [Arguments]    ${tools_system_connect}=True
  49     [Documentation]    Places search utility to ODL system, which will be needed for version detection.
  50     ...    By default also initialize a SSH connection to Tools system,
  51     ...    as following Keywords assume a working connection towards target system.
  52     # Connect to the ODL machine.
  53     ${odl} =    SSHKeywords.Open_Connection_To_ODL_System
  54     # Deploy the search tool.
  55     SSHLibrary.Put_File    ${CURDIR}/../../tools/deployment/search.sh
  56     SSHLibrary.Close_Connection
  57     # Optionally connect to the Tools System machine.
  58     BuiltIn.Return_From_Keyword_If    not (${tools_system_connect})    # the argument may be a convoluted Python expression
  59     SSHKeywords.Open_Connection_To_Tools_System
  60
  61 NexusKeywords__Get_Items_To_Look_At
  62     [Arguments]    ${component}
  63     [Documentation]    Get a list of items that might contain the version number that we are looking for.
  64     ...
  65     ...    &{COMPONENT_MAPPING} is the centralized place to maintain the mapping
  66     ...    from a stream independent component nickname to the list of artifact names to search for.
  67     Collections.Dictionary_Should_Contain_Key    ${COMPONENT_MAPPING}    ${component}    Component not supported by NexusKeywords version detection: ${component}
  68     BuiltIn.Run_Keyword_And_Return    Collections.Get_From_Dictionary    ${COMPONENT_MAPPING}    ${component}
  69
  70 NexusKeywords__Detect_Version_To_Pull
  71     [Arguments]    ${component}
  72     [Documentation]    Determine the exact Nexus directory to be used as a source for a particular test tool
  73     ...    Figure out what version of the tool needs to be pulled out of the
  74     ...    Nexus by looking at the version directory of the subsystem from
  75     ...    which the tool is being pulled. This code is REALLY UGLY but there
  76     ...    is no way around it until the bug
  77     ...    https://bugs.opendaylight.org/show_bug.cgi?id=5206 gets fixed.
  78     ...    I also don't want to depend on maven-metadata-local.xml and other
  79     ...    bits and pieces of ODL distribution which are not required for ODL
  80     ...    to function properly.
  81     ${itemlist} =    NexusKeywords__Get_Items_To_Look_At    ${component}
  82     ${current_ssh_connection} =    SSHLibrary.Get Connection
  83     SSHKeywords.Open_Connection_To_ODL_System
  84     ${version}    ${result} =    SSHLibrary.Execute_Command    sh search.sh ${WORKSPACE}/${BUNDLEFOLDER}/system ${itemlist}    return_rc=True
  85     SSHLibrary.Close_Connection
  86     SSHKeywords.Restore Current SSH Connection From Index    ${current_ssh_connection.index}
  87     BuiltIn.Log    ${version}
  88     BuiltIn.Run_Keyword_If    ${result}!=0    BuiltIn.Fail    Component "${component}": searching for "${itemlist}" found no version, cannot locate test tool.
  89     ${version}    ${location} =    String.Split_String    ${version}    max_split=1
  90     [Return]    ${version}    ${location}
  91
  92 Deploy_From_Url
  93     [Arguments]    ${url}
  94     [Documentation]    On active SSH conenction execute download ${url} command, log output, check RC and return file name.
  95     ${filename} =    String.Fetch_From_Right    ${url}    /
  96     ${response}    ${result} =    SSHLibrary.Execute_Command    wget -q -N '${url}' 2>&1    return_rc=True
  97     BuiltIn.Log    ${response}
  98     BuiltIn.Run_Keyword_If    ${result} != 0    BuiltIn.Fail    File ${filename} could not be downloaded from ${url}
  99     [Return]    ${filename}
 100
 101 Deploy_Artifact
 102     [Arguments]    ${component}    ${artifact}    ${name_prefix}=${artifact}-    ${name_suffix}=-executable.jar    ${fallback_url}=${NEXUS_FALLBACK_URL}    ${explicit_url}=${EMPTY}    ${build_version}=${EMPTY}    ${build_location}=${EMPTY}
 103     [Documentation]    Deploy the specified artifact from Nexus to the cwd of the machine to which the active SSHLibrary connection points.
 104     ...    ${component} is a name part of an artifact present in system/ of ODl installation with the same version as ${artifact} should have.
 105     ...    Must have ${BUNDLE_URL} variable set to the URL from which the
 106     ...    tested ODL distribution was downloaded and this place must be
 107     ...    inside a repository created by a standard distribution
 108     ...    construction job. If this is detected to ne be the case, fallback URL is used.
 109     ...    If ${explicit_url} is non-empty, Deploy_From_Utrl is called instead.
 110     ...    TODO: Allow deploying to a specific directory, we have SSHKeywords.Execute_Command_At_Cwd_Should_Pass now.
 111     BuiltIn.Run_Keyword_And_Return_If    """${explicit_url}""" != ""    Deploy_From_Url    ${explicit_url}
 112     ${urlbase} =    String.Fetch_From_Left    ${BUNDLE_URL}    /org/opendaylight
 113     # If the BUNDLE_URL points somewhere else (perhaps *patch-test* job in Jenkins),
 114     # ${urlbase} is the whole ${BUNDLE_URL}, in which case we use the ${fallback_url}
 115     # If we are working with a "release integrated" project, we always will want to look for
 116     # a released version, not in the snapshots
 117     ${urlbase} =    BuiltIn.Set_Variable_If    '${urlbase}' != '${BUNDLE_URL}'    ${urlbase}    ${fallback_url}
 118     CompareStream.Run_Keyword_If_At_Most_Magnesium    Collections.Remove_Values_From_List    ${RELEASE_INTEGRATED_COMPONENTS}    carpeople
 119     CompareStream.Run_Keyword_If_At_Most_Aluminium    Collections.Remove_Values_From_List    ${RELEASE_INTEGRATED_COMPONENTS}    netconf
 120     CompareStream.Run_Keyword_If_At_Most_Silicon    Collections.Remove_Values_From_List    ${RELEASE_INTEGRATED_COMPONENTS}    bgpcep
 121     ${version}    ${location} =    BuiltIn.Run_Keyword_If    '${build_version}'=='${EMPTY}'    NexusKeywords__Detect_Version_To_Pull    ${component}
 122     ...    ELSE    BuiltIn.Set_Variable    ${build_version}    ${build_location}
 123     BuiltIn.Run_Keyword_If    'SNAPSHOT' in '${version}'    Collections.Remove_Values_From_List    ${RELEASE_INTEGRATED_COMPONENTS}    netconf    bgpcep
 124     # check if the bundle url is pointing to a staging artifact
 125     # when we are pointing at a staged artifact we need to use the staging repo instead of release/snapshot artifacts
 126     ${is_staged} =    BuiltIn.Set_Variable_If    "opendaylight.release" not in '${urlbase}' and "opendaylight.snapshot" not in '${urlbase}'    "TRUE"    "FALSE"
 127     # if we have a staged artifact we need to use the urlbase given to us in the job params
 128     ${is_mri_component} =    BuiltIn.Set_Variable_If    '${component}' in ${RELEASE_INTEGRATED_COMPONENTS}    "TRUE"    "FALSE"
 129     ${urlbase} =    BuiltIn.Set_Variable_If    ${is_mri_component} == "TRUE" and ${is_staged} == "FALSE"    ${NEXUS_RELEASE_BASE_URL}    ${urlbase}
 130     # TODO: Use RequestsLibrary and String instead of curl and bash utilities?
 131     ${url} =    BuiltIn.Set_Variable    ${urlbase}/${location}/${artifact}/${version}
 132     # TODO: Review SSHKeywords for current best keywords to call.
 133     ${metadata} =    SSHKeywords.Execute_Command_Should_Pass    curl -L ${url}/maven-metadata.xml
 134     ${status}    ${namepart} =    BuiltIn.Run_Keyword_And_Ignore_Error    SSHKeywords.Execute_Command_Should_Pass    echo "${metadata}" | grep value | head -n 1 | cut -d '>' -f 2 | cut -d '<' -f 1    stderr_must_be_empty=${True}
 135     ${length} =    BuiltIn.Get_Length    ${namepart}
 136     ${namepart} =    BuiltIn.Set_Variable_If    "${status}" != "PASS" or ${length} == 0    ${version}    ${namepart}
 137     ${filename} =    BuiltIn.Set_Variable    ${name_prefix}${namepart}${name_suffix}
 138     BuiltIn.Log    ${filename}
 139     ${url} =    BuiltIn.Set_Variable    ${url}/${filename}
 140     ${response}    ${result} =    SSHLibrary.Execute_Command    wget -q -N '${url}' 2>&1    return_rc=True
 141     BuiltIn.Log    ${response}
 142     BuiltIn.Return_From_Keyword_If    ${result} == 0    ${filename}
 143     # staged autorelease for non-mri project might not contain the artifact we need so we need to fallback to grabbing it from the release repo
 144     ${release_url} =    String.Replace_String_Using_Regexp    ${url}    autorelease-[0-9]{4}    opendaylight.release
 145     ${response}    ${result} =    SSHLibrary.Execute_Command    wget -q -N '${release_url}' 2>&1    return_rc=True
 146     BuiltIn.Run_Keyword_If    ${result} != 0    BuiltIn.Fail    Artifact "${artifact}" in component "${component}" could not be downloaded from ${release_url} nor ${url}
 147     [Return]    ${filename}
 148
 149 Deploy_Test_Tool
 150     [Arguments]    ${component}    ${artifact}    ${suffix}=executable    ${fallback_url}=${NEXUS_FALLBACK_URL}    ${explicit_url}=${EMPTY}    ${build_version}=${EMPTY}    ${build_location}=${EMPTY}
 151     [Documentation]    Deploy a test tool.
 152     ...    The test tools have naming convention of the form
 153     ...    "<repository_url>/some/dir/somewhere/<tool-name>/<tool-name>-<version-tag>-${suffix}.jar"
 154     ...    where "<tool-name>" is the name of the tool and "<version-tag>" is
 155     ...    the version tag that is digged out of the maven metadata. This
 156     ...    keyword calculates ${name_prefix} and ${name_suffix} for
 157     ...    "Deploy_Artifact" and then calls "Deploy_Artifact" to do the real
 158     ...    work of deploying the artifact.
 159     ${name_prefix} =    BuiltIn.Set_Variable    ${artifact}-
 160     ${extension} =    BuiltIn.Set_Variable_If    '${component}'=='odl-micro'    tar    jar
 161     ${name_suffix} =    BuiltIn.Set_Variable_If    "${suffix}" != ""    -${suffix}.${extension}    .${extension}
 162     ${filename} =    Deploy_Artifact    ${component}    ${artifact}    ${name_prefix}    ${name_suffix}    ${fallback_url}
 163     ...    ${explicit_url}    ${build_version}    ${build_location}
 164     [Return]    ${filename}
 165
 166 Install_And_Start_Java_Artifact
 167     [Arguments]    ${component}    ${artifact}    ${suffix}=executable    ${tool_options}=${EMPTY}    ${java_options}=${EMPTY}    ${openjdk}=${JDKVERSION}
 168     ...    ${fallback_url}=${NEXUS_FALLBACK_URL}    ${explicit_url}=${EMPTY}
 169     [Documentation]    Deploy the artifact, assign name for log file, figure out java command, write the command to active SSH connection and return the log name.
 170     ...    This keyword does not examine whether the artifact was started successfully or whether is still running upon return.
 171     # TODO: Unify this keyword with what NexusKeywords.Install_And_Start_Testtool does.
 172     ${actual_java_options} =    BuiltIn.Set_Variable_If    """${java_options}""" != ""    ${java_options}    ${JAVA_OPTIONS}
 173     ${filename} =    Deploy_Test_Tool    ${component}    ${artifact}    ${suffix}    ${fallback_url}    ${explicit_url}
 174     ${command} =    Compose_Full_Java_Command    ${actual_java_options} -jar ${filename} ${tool_options}
 175     ${logfile} =    Utils.Get_Log_File_Name    ${artifact}
 176     SSHLibrary.Write    ${command} >${logfile} 2>&1
 177     [Return]    ${logfile}
 178
 179 Compose_Dilemma_Filepath
 180     [Arguments]    ${default_path}    ${specific_path}
 181     [Documentation]    Query active SSH connection, return specific path if it exists else default path.
 182     ${out}    ${rc} =    SSHLibrary.Execute_Command    ls -lA ${specific_path} 2>&1    return_rc=True
 183     BuiltIn.Return_From_Keyword_If    ${rc} == 0    ${specific_path}
 184     BuiltIn.Return_From_Keyword    ${default_path}
 185
 186 Compose_Base_Java_Command
 187     [Arguments]    ${openjdk}=${JDKVERSION}
 188     [Documentation]    Return string suitable for launching Java programs over SSHLibrary, depending on JRE version needed.
 189     ...    This requires that the SSH connection on which the command is going to be used is active as it is needed for querying files.
 190     ...    Commands composed for one SSH connection shall not be reused on other SSH connections as the two connections may have different Java setups.
 191     ...    Not directly related to Nexus, but versioned Java tools may need this.
 192     # Check whether the user set the override and return it if yes.
 193     BuiltIn.Run_Keyword_And_Return_If    """${openjdk}""" == "openjdk8"    Compose_Dilemma_Filepath    ${JAVA_8_HOME_CENTOS}/bin/java    ${JAVA_8_HOME_UBUNTU}/bin/java
 194     BuiltIn.Run_Keyword_And_Return_If    """${openjdk}""" == "openjdk11"    Compose_Dilemma_Filepath    ${JAVA_11_HOME_CENTOS}/bin/java    ${JAVA_11_HOME_UBUNTU}/bin/java
 195     # Attempt to call plain "java" command directly. If it works, return it.
 196     ${out}    ${rc} =    SSHLibrary.Execute_Command    java -version 2>&1    return_rc=True
 197     BuiltIn.Return_From_Keyword_If    ${rc} == 0    java
 198     # Query the virtual machine for the JAVA_HOME environment variable and
 199     # use it to assemble a (hopefully) working command. If that worked out,
 200     # return the result.
 201     ${java} =    SSHLibrary.Execute_Command    echo $JAVA_HOME/bin/java 2>&1
 202     ${out}    ${rc} =    SSHLibrary.Execute_Command    ${java} -version 2>&1    return_rc=True
 203     BuiltIn.Return_From_Keyword_If    ${rc} == 0    ${java}
 204     # There are bizzare test environment setups where the (correct) JAVA_HOME
 205     # is set in the VM where Robot is running but not in the VM where the
 206     # tools are supposed to run (usually because these two are really one
 207     # and the same system and idiosyncracies of BASH prevent easy injection
 208     # of the JAVA_HOME environment variable into a place where connections
 209     # made by SSHLibrary would pick it up). So try to use that value to
 210     # create a java command and check that it works.
 211     ${JAVA_HOME} =    OperatingSystem.Get_Environment_Variable    JAVA_HOME    ${EMPTY}
 212     ${java} =    BuiltIn.Set_Variable_If    """${JAVA_HOME}"""!=""    ${JAVA_HOME}/bin/java    false
 213     ${out}    ${rc} =    SSHLibrary.Execute_Command    ${java} -version 2>&1    return_rc=True
 214     BuiltIn.Return_From_Keyword_If    ${rc} == 0    ${java}
 215     # Nothing works, most likely java is not installed at all on the target
 216     # machine or it is hopelesly lost. Bail out with a helpful message
 217     # telling the user how to make it accessible for the script.
 218     BuiltIn.Fail    Unable to find Java; specify \${JDKVERSION}, put it to your PATH or set JAVA_HOME environment variable.
 219
 220 Compose_Full_Java_Command
 221     [Arguments]    ${options}    ${openjdk}=${JDKVERSION}
 222     [Documentation]    Return full Bash command to run Java with given options.
 223     ...    This requires that the SSH connection on which the command is going to be used is active as it is needed for querying files.
 224     ...    The options may include JVM options, application command line arguments, Bash redirects and other constructs.
 225     ${base_command} =    Compose_Base_Java_Command    openjdk=${openjdk}
 226     ${full_command} =    BuiltIn.Set_Variable    ${base_command} ${options}
 227     BuiltIn.Log    ${full_command}
 228     [Return]    ${full_command}
 229
 230 Compose_Java_Home
 231     [Arguments]    ${openjdk}=${JDKVERSION}
 232     [Documentation]    Compose base java command and strip trailing "/bin/java".
 233     ${java_command} =    Compose_Base_Java_Command
 234     ${java_home}    ${bin}    ${java} =    String.Split_String_From_Right    ${java_command}    separator=/    max_split=2
 235     [Return]    ${java_home}
 236
 237 Install_Maven_Bare
 238     [Arguments]    ${maven_version}=3.3.9    ${openjdk}=${JDKVERSION}
 239     [Documentation]    Download and unpack Maven, prepare launch command with proper Java version and download settings file.
 240     ...    This Keyword requires an active SSH connection to target machine.
 241     ...    This Keyword sets global variables, so that suites can reuse existing installation.
 242     ...    This Keyword can only place Maven (and settings) to remote current working directory.
 243     ...    This Keyword does not perform any initial or final cleanup.
 244     # Avoid multiple initialization by several downstream libraries.
 245     ${installed_version} =    BuiltIn.Get_Variable_Value    \${Maven__installed_version}    None
 246     BuiltIn.Return_From_Keyword_If    """${installed_version}""" == """${maven_version}"""
 247     BuiltIn.Set_Global_Variable    \${Maven__installed_version}    ${maven_version}
 248     BuiltIn.Set_Global_Variable    \${maven_directory}    apache-maven-${maven_version}
 249     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    rm -rf '${maven_directory}'
 250     ${maven_archive_filename} =    BuiltIn.Set_Variable    ${maven_directory}-bin.tar.gz
 251     ${maven_download_url} =    BuiltIn.Set_Variable    http://www-us.apache.org/dist/maven/maven-3/${maven_version}/binaries/${maven_archive_filename}
 252     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    wget -N '${maven_download_url}'    stderr_must_be_empty=False
 253     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    tar xvf '${maven_archive_filename}'
 254     ${java_home} =    NexusKeywords.Compose_Java_Home    openjdk=${openjdk}
 255     BuiltIn.Set_Global_Variable    \${maven_bash_command}    export JAVA_HOME='${java_home}' && export MAVEN_OPTS='${JAVA_OPTIONS}' && ./${maven_directory}/bin/mvn
 256     # TODO: Get settings files from Jenkins settings provider, somehow.
 257     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    wget '${MAVEN_SETTINGS_URL}' -O settings.xml    stderr_must_be_empty=False
 258
 259 Install_Maven
 260     [Arguments]    ${maven_version}=3.3.9    ${openjdk}=${JDKVERSION}    ${branch}=${EMPTY}    ${patches}=${EMPTY}
 261     [Documentation]    Install Maven.
 262     ...    Depending on arguments, perform a multipatch build to populate local Maven repository with patched artifacts.
 263     Install_Maven_Bare    maven_version=${maven_version}    openjdk=${openjdk}
 264     BuiltIn.Return_From_Keyword_If    """${patches}""" == ""    No post-install build requested.
 265     BuiltIn.Run_Keyword_If    """${branch}""" == ""    BuiltIn.Fail    BRANCH needs to be specified for multipatch builds.
 266     ${script_name} =    BuiltIn.Set_Variable    include-raw-integration-multipatch-distribution-test.sh
 267     ${script_url} =    BuiltIn.Set_Variable    https://raw.githubusercontent.com/opendaylight/releng-builder/master/jjb/integration/${script_name}
 268     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    wget -N '${script_url}'    stderr_must_be_empty=False
 269     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    export WORKSPACE='${WORKSPACE}' && export BRANCH='${branch}' && export PATCHES_TO_BUILD='${patches}' && bash '${script_name}'    stderr_must_be_empty=False
 270     Run_Maven    pom_file=${WORKSPACE}/patch_tester/pom.xml
 271
 272 Run_Maven
 273     [Arguments]    ${pom_file}=pom.xml    ${log_file}=${MAVEN_DEFAULT_OUTPUT_FILENAME}
 274     [Documentation]    Determine arguments to use and call mvn command against given pom file.
 275     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    mkdir -p '${MAVEN_REPOSITORY_PATH}'
 276     ${maven_repository_options} =    BuiltIn.Set_Variable    -Dmaven.repo.local=${MAVEN_REPOSITORY_PATH} -Dorg.ops4j.pax.url.mvn.localRepository=${MAVEN_REPOSITORY_PATH}
 277     SSHKeywords.Execute_Command_At_Cwd_Should_Pass    ${maven_bash_command} clean install dependency:tree -V -B -DoutputFile=dependency_tree.log -s './settings.xml' -f '${pom_file}' ${MAVEN_OPTIONS} ${maven_repository_options} > '${log_file}'
 278
 279 Get_ODL_Versions_From_Nexus
 280     [Documentation]    Returns name of last release found on nexus and list of all versions.
 281     RequestsLibrary.Create_Session    nexus    ${NEXUS_RELEASES_URL}    verify=${TRUE}
 282     ${uri}=    BuiltIn.Set_Variable    maven-metadata.xml
 283     ${response}=    RequestsLibrary.Get_Request    nexus    ${uri}
 284     BuiltIn.Log    ${response.text}
 285     ${root}=    XML.Parse_XML    ${response.text}
 286     ${element}=    XML.Get_Element    ${root}    versioning/latest
 287     ${latest}=    BuiltIn.Set_Variable    ${element.text}
 288     BuiltIn.Log    ${latest}
 289     @{elements}=    XML.Get_Elements    ${root}    .//version
 290     ${versions}=    BuiltIn.Create_List
 291     FOR    ${element}    IN    @{elements}
 292         BuiltIn.Run_Keyword_If    'Carbon' not in $element.text    Collections.Append_To_List    ${versions}    ${element.text}
 293     END
 294     Collections.Sort_List    ${versions}
 295     BuiltIn.Log_Many    @{versions}
 296     [Return]    ${latest}    @{versions}
 297
 298 Get_Latest_ODL_Release_From_Nexus
 299     [Documentation]    Returns name of last release found on nexus
 300     ${latest}    @{versions}=    Get_ODL_Versions_From_Nexus
 301     [Return]    ${latest}
 302
 303 Get_Latest_ODL_Stream_Release
 304     [Arguments]    ${stream}=latest
 305     [Documentation]    Returns name for last release for specified stream.
 306     ${latest}    @{versions}=    Get_ODL_Versions_From_Nexus
 307     BuiltIn.Return_From_Keyword_If    '${stream}'=='latest'    ${latest}
 308     ${latest_version}=    BuiltIn.Set_Variable    xxx
 309     FOR    ${version}    IN    @{versions}
 310         ${latest_version}=    BuiltIn.Set_Variable_If    '${stream}'.title() in '${version}'    ${version}    ${latest_version}
 311     END
 312     BuiltIn.Run_Keyword_If    '${latest_version}'=='xxx'    BuiltIn.Fail    Could not find latest release for stream ${stream}
 313     BuiltIn.Log    ${latest_version}
 314     [Return]    ${latest_version}
 315
 316 Get_Latest_ODL_Stream_Release_URL
 317     [Arguments]    ${stream}=latest    ${format}=.zip
 318     [Documentation]    Returns URL for last release for specified stream. Default format is .zip.
 319     ${latest_version}=    Get_Latest_ODL_Stream_Release    ${stream}
 320     ${url}=    BuiltIn.Set_Variable    ${NEXUS_RELEASES_URL}/${latest_version}/karaf-${latest_version}${format}
 321     BuiltIn.Log    ${url}
 322     [Return]    ${url}
 323
 324 Get_Latest_ODL_Previous_Stream_Release
 325     [Arguments]    ${stream}=${ODL_STREAM}
 326     [Documentation]    Returns name for last release for previous stream of specified stream.
 327     ...    Note: If specified stream is not found on nexus, then it is taken as new one (not released yet).
 328     ...    So in this case, latest release version is return.
 329     ...
 330     ...    NOTE: the below logic is stripping the initial 0. values from the 0.x.x version string that is
 331     ...    the current (and future) version numbering scheme. There is always a leading 0. to the version
 332     ...    strings and stripping it makes is easier to do int comparison to find the largest version in the
 333     ...    list. Comparing as strings does not work. There are some python libs like distutils.version
 334     ...    or packaging that can do a better job comparing versions, but since ODL version numbering is simple
 335     ...    at this point, this convention will suffice. The leading 0. will be added back after the the latest
 336     ...    version is found from the list. The CompareStream.robot library keeps a mapping of major version
 337     ...    numbers to the global variable ${ODL_STREAM} so that is used to ensure we get a major version that is
 338     ...    older than the current running major version.
 339     ${latest}    @{versions}=    Get_ODL_Versions_From_Nexus
 340     ${current_version}=    BuiltIn.Set_Variable    ${Stream_dict}[${ODL_STREAM}].0
 341     ${latest_version}=    BuiltIn.Set_Variable    0.0
 342     FOR    ${version}    IN    @{versions}
 343         ${version} =    String.Replace String Using Regexp    ${version}    ^0\.    ${EMPTY}
 344         ${latest_version}=    Set Variable If    ${version} > ${latest_version} and ${version} < ${current_version}    ${version}    ${latest_version}
 345     END
 346     ${latest_version}=    Set Variable    0.${latest_version}
 347     BuiltIn.Run_Keyword_If    '${latest_version}'=='0.0.0'    BuiltIn.Fail    Could not find latest previous release for stream ${stream}
 348     BuiltIn.Log    ${latest_version}
 349     [Return]    ${latest_version}
 350
 351 Get_Latest_ODL_Previous_Stream_Release_URL
 352     [Arguments]    ${stream}=${ODL_STREAM}    ${format}=.zip
 353     [Documentation]    Returns URL for last release for previous stream of specified stream. Default format is .zip.
 354     ${latest_version}=    Get_Latest_ODL_Previous_Stream_Release    ${stream}
 355     ${url}=    BuiltIn.Set_Variable    ${NEXUS_RELEASES_URL}/${latest_version}/karaf-${latest_version}${format}
 356     BuiltIn.Log    ${url}
 357     [Return]    ${url}