autoverse-cli 0.1.0__tar.gz

autoverse_cli-0.1.0/LICENSE

@@ -0,0 +1,33 @@
+# End-User License Agreement (EULA) of the Autonoma AutoVerse CLI
+
+This End-User License Agreement ("EULA") is a legal agreement between you and Autonoma, Inc.
+
+## License Grant
+
+Autonoma, Inc. hereby grants you a personal, non-transferable, non-exclusive licence to use the AutoVerse software in accordance with the terms of this EULA agreement.
+
+## Limitation of Liability
+The software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND, express or implied. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in action of contract, tort or otherwise, arising from, out of or in connection with the software or the use of the software.
+
+### You are NOT permitted to:
+
+- Edit, alter, modify, adapt, translate or otherwise change the whole or any part of the Software nor permit the whole or any part of the Software to be combined with or become incorporated in any other software, nor decompile, disassemble or reverse engineer the Software or attempt to do any such things
+- Reproduce, copy, distribute, resell or otherwise use the Software for any commercial purpose
+- Allow any third party to use the Software on behalf of or for the benefit of any third party
+- Use the Software in any way which breaches any applicable local, national or international law
+use the Software for any purpose that Autonoma, Inc. considers is a breach of this EULA agreement
+Intellectual Property and Ownership
+
+Autonoma, Inc. shall at all times retain ownership of the Software as originally downloaded by you and all subsequent downloads of the Software by you. The Software (and the copyright, and other intellectual property rights of whatever nature in the Software, including any modifications made thereto) are and shall remain the property of Autonoma, Inc.
+
+Autonoma, Inc. reserves the right to grant licences to use the Software to third parties.
+
+## Termination
+
+This EULA agreement is effective from the date you first use the Software and shall continue until terminated. You may terminate it at any time upon written notice to Autonoma, Inc.
+
+It will also terminate immediately if you fail to comply with any term of this EULA agreement. Upon such termination, the licenses granted by this EULA agreement will immediately terminate and you agree to stop all access and use of the Software. The provisions that by their nature continue and survive will survive any termination of this EULA agreement.
+
+## Governing Law
+
+This EULA agreement, and any dispute arising out of or in connection with this EULA agreement, shall be governed by and construed in accordance with the laws of the USA.

autoverse_cli-0.1.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.1
+Name: autoverse-cli
+Version: 0.1.0
+Summary: The Autoverse CLI
+Author-email: Dan Kamrath <dan.kamrath@autonomalabs.com>
+License: # End-User License Agreement (EULA) of the Autonoma AutoVerse CLI
+        
+        This End-User License Agreement ("EULA") is a legal agreement between you and Autonoma, Inc.
+        
+        ## License Grant
+        
+        Autonoma, Inc. hereby grants you a personal, non-transferable, non-exclusive licence to use the AutoVerse software in accordance with the terms of this EULA agreement.
+        
+        ## Limitation of Liability
+        The software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND, express or implied. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in action of contract, tort or otherwise, arising from, out of or in connection with the software or the use of the software.
+        
+        ### You are NOT permitted to:
+        
+        - Edit, alter, modify, adapt, translate or otherwise change the whole or any part of the Software nor permit the whole or any part of the Software to be combined with or become incorporated in any other software, nor decompile, disassemble or reverse engineer the Software or attempt to do any such things
+        - Reproduce, copy, distribute, resell or otherwise use the Software for any commercial purpose
+        - Allow any third party to use the Software on behalf of or for the benefit of any third party
+        - Use the Software in any way which breaches any applicable local, national or international law
+        use the Software for any purpose that Autonoma, Inc. considers is a breach of this EULA agreement
+        Intellectual Property and Ownership
+        
+        Autonoma, Inc. shall at all times retain ownership of the Software as originally downloaded by you and all subsequent downloads of the Software by you. The Software (and the copyright, and other intellectual property rights of whatever nature in the Software, including any modifications made thereto) are and shall remain the property of Autonoma, Inc.
+        
+        Autonoma, Inc. reserves the right to grant licences to use the Software to third parties.
+        
+        ## Termination
+        
+        This EULA agreement is effective from the date you first use the Software and shall continue until terminated. You may terminate it at any time upon written notice to Autonoma, Inc.
+        
+        It will also terminate immediately if you fail to comply with any term of this EULA agreement. Upon such termination, the licenses granted by this EULA agreement will immediately terminate and you agree to stop all access and use of the Software. The provisions that by their nature continue and survive will survive any termination of this EULA agreement.
+        
+        ## Governing Law
+        
+        This EULA agreement, and any dispute arising out of or in connection with this EULA agreement, shall be governed by and construed in accordance with the laws of the USA.
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Autoverse CLI
+
+The new implementation of the Autoverse CLI

autoverse_cli-0.1.0/README.md

@@ -0,0 +1,3 @@
+# Autoverse CLI
+
+The new implementation of the Autoverse CLI

autoverse_cli-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "autoverse-cli"
+version = "0.1.0"
+authors = [
+  { name="Dan Kamrath", email="dan.kamrath@autonomalabs.com" },
+]
+description = "The Autoverse CLI"
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+[project.scripts]
+avrs = "avrs.avrs:main"

autoverse_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

autoverse_cli-0.1.0/src/autoverse_cli.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.1
+Name: autoverse-cli
+Version: 0.1.0
+Summary: The Autoverse CLI
+Author-email: Dan Kamrath <dan.kamrath@autonomalabs.com>
+License: # End-User License Agreement (EULA) of the Autonoma AutoVerse CLI
+        
+        This End-User License Agreement ("EULA") is a legal agreement between you and Autonoma, Inc.
+        
+        ## License Grant
+        
+        Autonoma, Inc. hereby grants you a personal, non-transferable, non-exclusive licence to use the AutoVerse software in accordance with the terms of this EULA agreement.
+        
+        ## Limitation of Liability
+        The software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND, express or implied. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in action of contract, tort or otherwise, arising from, out of or in connection with the software or the use of the software.
+        
+        ### You are NOT permitted to:
+        
+        - Edit, alter, modify, adapt, translate or otherwise change the whole or any part of the Software nor permit the whole or any part of the Software to be combined with or become incorporated in any other software, nor decompile, disassemble or reverse engineer the Software or attempt to do any such things
+        - Reproduce, copy, distribute, resell or otherwise use the Software for any commercial purpose
+        - Allow any third party to use the Software on behalf of or for the benefit of any third party
+        - Use the Software in any way which breaches any applicable local, national or international law
+        use the Software for any purpose that Autonoma, Inc. considers is a breach of this EULA agreement
+        Intellectual Property and Ownership
+        
+        Autonoma, Inc. shall at all times retain ownership of the Software as originally downloaded by you and all subsequent downloads of the Software by you. The Software (and the copyright, and other intellectual property rights of whatever nature in the Software, including any modifications made thereto) are and shall remain the property of Autonoma, Inc.
+        
+        Autonoma, Inc. reserves the right to grant licences to use the Software to third parties.
+        
+        ## Termination
+        
+        This EULA agreement is effective from the date you first use the Software and shall continue until terminated. You may terminate it at any time upon written notice to Autonoma, Inc.
+        
+        It will also terminate immediately if you fail to comply with any term of this EULA agreement. Upon such termination, the licenses granted by this EULA agreement will immediately terminate and you agree to stop all access and use of the Software. The provisions that by their nature continue and survive will survive any termination of this EULA agreement.
+        
+        ## Governing Law
+        
+        This EULA agreement, and any dispute arising out of or in connection with this EULA agreement, shall be governed by and construed in accordance with the laws of the USA.
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Autoverse CLI
+
+The new implementation of the Autoverse CLI

autoverse_cli-0.1.0/src/autoverse_cli.egg-info/SOURCES.txt

@@ -0,0 +1,27 @@
+LICENSE
+README.md
+pyproject.toml
+src/autoverse_cli.egg-info/PKG-INFO
+src/autoverse_cli.egg-info/SOURCES.txt
+src/autoverse_cli.egg-info/dependency_links.txt
+src/autoverse_cli.egg-info/entry_points.txt
+src/autoverse_cli.egg-info/top_level.txt
+src/avrs/__init__.py
+src/avrs/app_version.py
+src/avrs/avrs.py
+src/avrs/cfg.py
+src/avrs/launcher.py
+src/avrs/launcher_util.py
+src/avrs/tests.py
+src/avrs/requests/can.py
+src/avrs/requests/demo.py
+src/avrs/requests/input.py
+src/avrs/requests/log_path.py
+src/avrs/requests/move_to_landmark.py
+src/avrs/requests/npc.py
+src/avrs/requests/request.py
+src/avrs/requests/reserve_mv_slot.py
+src/avrs/requests/reset_to_track.py
+src/avrs/requests/restart.py
+src/avrs/requests/teleport.py
+src/avrs/requests/vd.py

autoverse_cli-0.1.0/src/autoverse_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

autoverse_cli-0.1.0/src/autoverse_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+avrs = avrs.avrs:main

autoverse_cli-0.1.0/src/autoverse_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+avrs

autoverse_cli-0.1.0/src/avrs/app_version.py

@@ -0,0 +1,24 @@
+import http.client
+import json
+
+def get_app_version():
+    return '0.1.0'
+
+def check_app_is_latest():
+    pass
+    # contact API to examine version
+
+    # This is slow, which will make the CLI annoying to use. This means
+    # we need an approach that can try to do this in the background and then
+    # caches somewhere so that the user is notified on the next run
+
+    # api_url = 'zn5boqqk60.execute-api.us-east-1.amazonaws.com'
+
+    # connection = http.client.HTTPSConnection(api_url)
+    # headers = {'Content-type': 'application/json'}
+    # body = json.dumps({'hello': 'hello'}).encode('utf-8')
+    # connection.request('POST', '/test', body, headers)
+    # response = connection.getresponse()
+    # if response.status != 200:
+    #     print('response had status code {}'.format(response))
+    # print('{}'.format(response.read().decode('utf-8')))

autoverse_cli-0.1.0/src/avrs/avrs.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+import argparse
+from argparse import RawDescriptionHelpFormatter
+from argparse import RawTextHelpFormatter
+
+from avrs.app_version import *
+from avrs.cfg import *
+from avrs.launcher import *
+
+from avrs.requests.move_to_landmark import MoveToLandmarkRequest
+from avrs.requests.restart import Restart
+from avrs.requests.reset_to_track import ResetToTrack
+from avrs.requests.teleport import Teleport
+#from src.requests.can import Can
+from avrs.requests.npc import Npc
+from avrs.requests.reserve_mv_slot import ReserveMvSlot
+from avrs.requests.vd import Vd
+from avrs.requests.input import InputRequest
+from avrs.requests.log_path import LogPath
+from avrs.requests.demo import AvrsDemoRequest
+
+
+def get_version():
+    return get_app_version()
+
+def main():
+    parser = argparse.ArgumentParser(
+            prog='avrs', 
+            description='Autoverse CLI',
+            epilog='',
+            formatter_class=RawDescriptionHelpFormatter)
+
+    version_psr = parser.add_argument(
+            '--version', 
+            help='show the cli version', 
+            action='version', 
+            version=get_version())
+
+    sps = parser.add_subparsers(required=True, help='sub-command help')
+
+    cfg = load_cfg('avrs')
+    check_app_is_latest()
+
+    AvrsLauncher(sps, cfg)
+
+
+    MoveToLandmarkRequest(sps, cfg)
+    Restart(sps, cfg)
+    ResetToTrack(sps, cfg)
+    #Can(sps, cfg)
+    Teleport(sps, cfg)
+    Npc(sps, cfg)
+    ReserveMvSlot(sps, cfg)
+    Vd(sps, cfg)
+    #InputRequest(sps, cfg)
+    LogPath(sps, cfg)
+    #AvrsDemoRequest(sps, cfg)
+    
+
+    args = parser.parse_args()
+    args.func(args)
+
+if __name__ == '__main__':
+    main()

autoverse_cli-0.1.0/src/avrs/cfg.py

@@ -0,0 +1,26 @@
+import json
+import os
+
+def get_cfg_dir(cli_name):
+    return os.path.join(os.environ['HOME'], '.config', cli_name)
+
+def get_cfg_file(cli_name):
+    return os.path.join(get_cfg_dir(cli_name), 'config.json')
+
+def load_cfg(cli_name):
+    cfg_dir = get_cfg_dir(cli_name)
+    if not os.path.exists(cfg_dir):
+        os.makedirs(cfg_dir)
+
+    cfg_path = get_cfg_file(cli_name)
+    cfg = {}
+
+    if os.path.exists(cfg_path):
+        with open(cfg_path, 'r', encoding='utf-8') as f:
+            cfg = json.load(f)
+    return cfg
+
+def save_cfg(cli_name, cfg):
+    cfg_path = get_cfg_file(cli_name)
+    with open(cfg_path, 'w', encoding='utf-8') as f:
+            json.dump(cfg, f, ensure_ascii=False, indent=4)

autoverse_cli-0.1.0/src/avrs/launcher.py

@@ -0,0 +1,164 @@
+import os
+import json
+import http.client
+import boto3
+from avrs.cfg import *
+from avrs.launcher_util import *
+
+class AvrsLauncher:
+    def __init__(self, parent_parser, cfg):
+        self.cfg = cfg
+        provision_parser = parent_parser.add_parser(
+            'launcher', 
+            help='launcher operations, such as license registration or updating a sim install')
+        sps = provision_parser.add_subparsers(required=True, help='launcher options')
+
+        register_license_psr = sps.add_parser(
+            'register-license', 
+            help='registers a user license, allowing certain functionaility')
+        register_license_psr.add_argument(
+            'license_path', 
+            help='the path to the license file to register')
+        register_license_psr.set_defaults(func=self.register_license)
+
+        license_status_psr = sps.add_parser(
+            'license-status', 
+            help='shows information related to a user license')
+        license_status_psr.set_defaults(func=self.license_status)
+
+        get_latest_psr = sps.add_parser(
+            'get-latest-sim-version', 
+            help='ask the build info api for the latest sim version')
+        get_latest_psr.set_defaults(func=self.get_latest_sim_version)
+
+        download_sim_psr = sps.add_parser('download-simulator', help='download the simulator')
+        download_sim_psr.add_argument('install_path', help='path to install the simulator')
+        download_sim_psr.add_argument(
+            '--copy-saved-from', 
+            default='', 
+            help='path to an existing installation from which to copy saved information')
+        download_sim_psr.add_argument(
+            '--update-existing', 
+            action='store_true', 
+            help='indicates that the user understands that they are updating an existing installation')
+        download_sim_psr.set_defaults(func=self.download_simulator)
+
+    def register_license(self, args):
+        print('Trying to Register License File: {}'.format(args.license_path))
+
+        # Load and validate provided license file
+        license_ok, license_status, license = validate_license_file(args.license_path)
+        if not license_ok:
+            print('Error Reading License File: {}'.format(license_status))
+            return
+
+        # Cache license info in config
+        license_name = os.path.basename(args.license_path)
+        self.cfg['license'] = {
+            'filename': os.path.basename(license_name),
+            'data': license
+        }
+        save_cfg('avrs', self.cfg)
+        print('License Registration Success: {}'.format(self.cfg['license']['filename']))
+
+        # Try to exchange license info for download keys
+        print('Retrieving Launcher Download Keys...')
+        (dl_keys_ok, dl_keys_status, self.cfg) = try_get_launcher_download_keys(self.cfg)
+        if not dl_keys_ok:
+            print('Error Getting Launcher Download Keys: {}'.format(dl_keys_status))
+            return
+        save_cfg('avrs', self.cfg)
+        print('Download Key Retrieval Success')
+
+    def license_status(self, args):
+        status = get_launcher_license_status_string(self.cfg)
+        print('Launcher License Status: {}'.format(status))
+
+    def get_available_sim_versions(self, args):
+        pass
+
+        # query something to find out what versions of the sim we can download
+
+    def get_latest_sim_version(self, args):
+        # Validate status of download keys
+        dl_keys_ok, dl_keys_status = has_launcher_download_keys(self.cfg)
+        if not dl_keys_ok:
+            print('Launcher Download Keys Error: {}'.format(dl_keys_status))
+            return
+
+        # Get latest build info from API
+        build_info_ok, build_info_status, latest_version, latest_url = get_launcher_build_info(self.cfg)
+        if not build_info_ok:
+            print('Error Getting Latest Version Info: {}'.format(build_info_status))
+            return
+        print('{}'.format(latest_version))
+
+    def download_simulator(self, args):
+
+        file_path = args.install_path
+        if not os.path.exists(file_path):
+            print('Cannot Install Simulator at: {} (Invalid Path)'.format(file_path))
+            return
+
+        # Validate status of download keys
+        dl_keys_ok, dl_keys_status = has_launcher_download_keys(self.cfg)
+        if not dl_keys_ok:
+            print('Launcher Download Keys Error: {}'.format(dl_keys_status))
+            return
+
+        # Get latest build info from API
+        build_info_ok, build_info_status, latest_version, latest_url = get_launcher_build_info(self.cfg)
+        if not build_info_ok:
+            print('Error Getting Latest Version Info: {}'.format(build_info_status))
+            return
+
+        # If we want to copy saved info from another installation
+        copy_saved = False
+        copy_saved_cache = ''
+        if args.copy_saved_from != '':
+            if not is_installed_sim(args.copy_saved_from):
+                print('The Path: {} Is not an Existing Installation. Cannot Copy Saved'.format(args.copy_saved_from))
+                return
+            else:
+                copy_saved = True
+
+        if copy_saved:
+            print('Caching Saved from Existing Installation at: {}'.format(args.copy_saved_from))
+            copy_from_saved_dir = os.path.join(args.copy_saved_from, 'Linux', 'Autoverse', 'Saved')
+            copy_saved_cache = os.path.join(args.install_path, 'autoverse-saved-cache')
+            shutil.copytree(copy_from_saved_dir, copy_saved_cache)
+
+        package_zip_name = 'autoverse-linux-{}.zip'.format(latest_version)
+        package_name = 'autoverse-linux'
+        bucket_path = 'mainline/{}'.format(package_zip_name)
+        dl_path = os.path.join(args.install_path, package_zip_name)
+        unzip_path = os.path.join(args.install_path, package_name)
+
+        if is_installed_sim(unzip_path) and not args.update_existing:
+            print('''
+Downloading at {} will update an existing installation and override its saved information. 
+make sure you have backups of any configuration or use the --copy-saved-from option.
+If you are sure, re-run with the --update-existing flag
+                '''.format(unzip_path))
+            return
+
+        print('Downloading {} to {}. This May Take Several Minutes Depending on Connection Speed'.format(bucket_path, dl_path))
+        #download_simulator_archive(self.cfg, bucket_path, dl_path)
+
+        print('Extracting {} to {}'.format(dl_path, unzip_path))
+        shutil.unpack_archive(dl_path, unzip_path)
+
+        if copy_saved:
+            print('Migrating Saved Files')
+            shutil.copytree(copy_saved_cache, os.path.join(unzip_path, 'Linux', 'Autoverse', 'Saved'), dirs_exist_ok=True)
+            shutil.rmtree(copy_saved_cache)
+
+        # Install license if missing
+        if not copy_saved:
+            print('Installing Registered License: {}'.format(self.cfg['license']['filename']))
+            license_install_path = os.path.join(unzip_path, 'Linux', 'Autoverse', 'Saved', self.cfg['license']['filename'])
+            with open(license_install_path, 'w', encoding='utf-8') as f:
+                json.dump(self.cfg['license']['data'], f, ensure_ascii=False, indent=4)
+
+        print('Cleaning up')
+        os.remove(dl_path)

autoverse_cli-0.1.0/src/avrs/launcher_util.py

@@ -0,0 +1,158 @@
+import os
+import json
+import http.client
+import boto3
+import sys
+import shutil
+
+def validate_license_file(file_path):
+    """ 
+    Given file path, load and validate license info. Returns tuple of bool
+    indicating success, string for status, and dict of license info from file
+    """
+    status = ''
+    license = {}
+
+    # Ensure it's a file
+    if not os.path.isfile(file_path):
+        status = 'no license file at {}'.format(file_path)
+        return (False, status, license)
+
+    # Parse it and check format
+    with open(file_path, 'r', encoding='utf-8') as f:
+        license = json.load(f)
+
+    if 'id' not in license:
+        status = 'malformed license file. missing id field'
+        return (False, status, license)
+    if 'public_key' not in license:
+        status = 'malformed license file. missing public key field'
+        return (False, status, license)
+    if 'shipping_signature' not in license:
+        status = 'malformed license file. missing shipping signature'
+        return (False, status, license)
+    return (True, status, license)
+
+
+def try_get_launcher_download_keys(cfg):
+    """
+    Uses license info stored in config to requrest download keys from API.
+    These keys can be used to authenticate downloads from bucket
+    """
+    status = ''
+    out_cfg = cfg
+
+    api_url = 'uu6fmbvrhk.execute-api.us-east-1.amazonaws.com'
+    connection = http.client.HTTPSConnection(api_url)
+    headers = {'Content-type': 'application/json'}
+    body = json.dumps({
+        'id': cfg['license']['data']['id'],
+        'licenseSignature': cfg['license']['data']['shipping_signature']
+    }).encode('utf-8')
+    connection.request('POST', '/test', body, headers)
+    response = connection.getresponse()
+    if response.status != 200:
+        status = 'response had status code {}'.format(response)
+        return (False, status, out_cfg)
+    dlinfo = json.loads(json.loads(response.read().decode('utf-8'))['body'])
+
+    out_cfg['dlkey_id'] = dlinfo['dlkey_id']
+    out_cfg['dlkey'] = dlinfo['dlkey']
+    return (True, status, out_cfg)
+
+def has_launcher_download_keys(cfg):
+    """
+    Checks for required config values for download keys
+    """
+    status = ''
+    if 'dlkey_id' not in cfg or 'dlkey' not in cfg:
+        status += 'Config has no Download Keys'
+        return (False, status)
+    return (True, status)
+
+def get_launcher_license_status_string(cfg):
+    """
+    Builds a string representation of where the CLI stands
+    as far as being configured as a launcher able to download simulator builds
+    """
+    status = ''
+    if 'license' not in cfg:
+        status += 'no license has been registered\n'
+    else:
+        status += 'license registered as {}\n'.format(cfg['license']['filename'])
+
+    if 'dlkey_id' not in cfg:
+        status += 'no download key ID found\n'
+    else:
+        status += 'download key id obtained\n'
+
+    if 'dlkey' not in cfg:
+        status += 'no download key found\n'
+    else:
+        status += 'download key obtained\n'
+    return status
+
+def get_launcher_build_info(cfg):
+    """
+    Contacts API to discover the current latest build version
+    """
+    status = ''
+    db_resource = boto3.resource(
+        'dynamodb',
+        'us-east-1',
+        aws_access_key_id=cfg['dlkey_id'],
+        aws_secret_access_key=cfg['dlkey'])
+
+    table = db_resource.Table('autoverse-ci-meta')
+    item = table.get_item(Key={'package-name': 'autoverse'})
+
+    if not 'Item' in item or 'latest' not in item['Item']:
+        status = 'Unable to Retrieve Latest Version'
+        return (False, status, '', '')
+
+    latest_version = item['Item']['latest']
+    version_url = item['Item']['package-url']
+    return (True, status, latest_version, version_url)
+
+def download_simulator_archive(cfg, source_path, target_path):
+    """
+    Downloads the latest version of the simulator from the builds bucket
+    """
+    s3_client = boto3.client(
+        's3',
+        aws_access_key_id=cfg['dlkey_id'],
+        aws_secret_access_key=cfg['dlkey'])
+    s3_download_with_progress(s3_client, 'autoverse-builds', source_path, target_path)
+
+def is_installed_sim(file_path):
+    """
+    Check if the given path appears to be the root of
+    a simulator installation
+    """
+    if not os.path.exists(file_path):
+        return False
+
+    if not os.path.isdir(os.path.join(file_path, 'Linux', 'Autoverse')):
+        return False
+
+    if not os.path.isfile(os.path.join(file_path, 'Linux', 'Autoverse', 'Saved', 'simconfig.json')):
+        return False
+
+    return True
+
+def s3_download_with_progress(s3_client, s3_bucket, s3_object_key, local_file_path):
+
+    meta_data = s3_client.head_object(Bucket=s3_bucket, Key=s3_object_key)
+    total_length = int(meta_data.get('ContentLength', 0))
+    downloaded = 0
+
+    def progress(chunk):
+        nonlocal downloaded
+        downloaded += chunk
+        done = int(50 * downloaded / total_length)
+        sys.stdout.write("\r[%s%s]" % ('=' * done, ' ' * (50-done)) )
+        sys.stdout.flush()
+
+    with open(local_file_path, 'wb') as f:
+        s3_client.download_fileobj(s3_bucket, s3_object_key, f, Callback=progress)
+    print('\n')