def main(args):
'''Retrieve all instrument deployment events, group them by array subsite,
and print the response as a JSON object'''
status = 1
# Create the UFrame instance
if args.base_url:
uframe = UFrame(base_url=args.base_url, timeout=args.timeout)
else:
uframe = UFrame(timeout=args.timeout)
# Fetch the events request
uframe.fetch_events()
if not uframe.events:
sys.stderr.write('No events requested: {:s}\n'.format(uframe))
sys.stdout.write('[]\n')
return status
# Get only the .DeploymentEvents
deployment_events = uframe.search_events_by_type('.DeploymentEvent')
if not deployment_events:
sys.stderr.write('No .DeploymentEvents found: {:s}\n'.format(uframe))
sys.stdout.write('[]\n')
return status
# Create the grouping of instrument deployments organized by array subsite
instruments = group_instrument_deployment_events_by_subsite(deployment_events)
# JSON encode and print to STDOUT
sys.stdout.write('{:s}\n'.format(json.dumps(instruments)))
status = 0
return status
def main(args):
'''Return the list of request urls that conform to the UFrame API for the
partial or fully-qualified reference_designator and all telemetry types.
The start and end times for each query are set to the deployment start
and end times taken from UFrame's asset management web-service API.
The URLs request all stream L0, L1 and L2 dataset parameters over the entire
time-coverage. The urls are printed to STDOUT.
'''
status = 0
base_url = args.base_url
if not base_url:
if args.verbose:
sys.stderr.write('No uframe_base specified. Checking UFRAME_BASE_URL environment variable\n')
base_url = os.getenv('UFRAME_BASE_URL')
if not base_url:
sys.stderr.write('No UFrame instance specified')
sys.stderr.flush()
return 1
# Create a UFrame instance
if args.verbose:
sys.stderr.write('Creating UFrame API instance\n')
uframe = UFrame(base_url=base_url,
timeout=args.timeout,
validate=args.validate_uframe)
# Fetch the table of contents from UFrame
if args.verbose:
t0 = datetime.datetime.utcnow()
sys.stderr.write('Fetching and creating UFrame table of contents...')
# Fetch the UFrame table of contents
uframe.fetch_toc()
# Fetch the UFrame events
uframe.fetch_events()
# Set args.tense to None if not either 'past' or 'present'
if args.tense.lower() not in ['past', 'present']:
args.tense = None
if args.verbose:
t1 = datetime.datetime.utcnow()
dt = t1 - t0
sys.stderr.write('Complete ({:d} seconds)\n'.format(dt.seconds))
if (args.reference_designator):
instruments = uframe.search_instruments(args.reference_designator)
else:
instruments = uframe.instruments
if not instruments:
sys.stderr.write('No instruments found for reference designator: {:s}\n'.format(args.reference_designator))
sys.stderr.flush()
urls = []
for instrument in instruments:
request_urls = uframe.instrument_to_deployment_query(instrument,
deployment_number = args.deployment_number,
tense = args.tense,
telemetry=args.telemetry,
time_check=args.time_check,
exec_dpa=args.no_dpa,
application_type=args.format,
provenance=args.no_provenance,
limit=args.limit,
annotations=args.no_annotations,
user=args.user,
email=args.email)
for request_url in request_urls:
urls.append(request_url)
for url in urls:
sys.stdout.write('{:s}\n'.format(url))
return status
