% coronado(5) Version 1.3.47 | Triple API Python wrapper
coronado - Native language wrapper for the Triple API. The Triple API enables partners to integrate with the Triple platform. The full API documentation is available from https://api.tripleup.dev/docs
Python API reference implementation:
JVM API:
Typescript/JavaScript API:
Service URL: https://api.partners.dev.tripleupdev.com
Service build: 0.0.0
| coronado - Auth, TripleObjects, and business objects manipulation API | triplchk - CLI for reporting if the Triple service is available and healthy | triplwhoami - CLI tool for reporting client ID, content provider info for the current API user and scope
triplechk takes no arguments. The Triple configuration file must exist in the system-dependent configuration directory.
triplewhoami takes a scope argument, where scope is one of:
| CONTENT_PROVIDERS | PORTFOLIOS | PUBLISHERS | VIEW_OFFERS | NONE
Executables install to /usr/local/bin unless coronado is installed in a
virtual environment, in which case they are installed to $VIRTUALENV/bin.
Reference implementation wrapper for the Triple API. All wrappers are implemented under the umbrella project Coronado, can can be viewed on-line at:
Use of this API requires credentials issued by tripleup.com and access to an S3 bucket provided by them. Contact tripleup.com to assist you in setting up access.
The coronado package is available in PyPI, Maven Central, NPM, CRAN, and other indices and repositories. Use the corresponding best-practice mechanism to install.
Python
pip install coronado
This makes the Triple API modules available in the current Python environment. You may verify this with the command:
pip list | awk 'NR < 3 { print; next; } /coronado/'
JVM - Kotlin, Java, Scala
<dependency>
<groupId>io.github.coronado-fi</groupId>
<artifactId>coronado-jvm</artifactId>
<version>0.0.1-SNAPSHOT</version>
<type>pom</type>
</dependency>
mvn build
Typescript/Javascript
npm install coronado
This component requires OAuth2 credentials available from Triple - please contact a Triple representative to get this information. Credentials cover:
Authentication tokens and service information are stored in the coronado.auth.Auth objects. API users need only create an instance of Auth and use it across all services in the corresponding scope. The Auth object guarantees that a valid, current token is always available, regardless of the OAuth2 expiration policy set. If the token expires, Auth objects will request a new token without user or programmer intervention.
General use:
auth = Auth( tokenURL,
clientID = 'somevalue',
clientSecret = '53cr3+',
scope = Scopes.PUBLISHERS)
This example leverages the Publisher object and service, but the concepts shown here apply to all the Coronado API business objects. A better, more detailed explanation is available via https://github.com/coronado-fi/coronado/quick-start-guide.ipynb or by running the same notebook in Lucyfer or Jupyter.
# Once per run-time, per Coronado class:
Publisher.initialize(serviceURL, auth)
pubsList = Publisher.list()
pubObject = Publisher.byID(42)
assert pubsList[3].assumedName == pubObject.assumedName
print(pubObject.address)
All Coronado TripleObject classes and subclasses can be imported into pandas or Kotlin DataFrame objects straight from the API, without further modifications:
import pandas as pd
panel = pd.DataFrame([ publisher.__dict__ for publisher in pubsList ])
panel.index = panel.objID
del(panel['objID'])
Under construction
The API references for all supporte languages are available from:
See GitHub issues: https://github.com/coronado-fi/coronado/issues
Coronado provides a simple configuration service via API that resolves a JSON configuration file from system-specific, well-known file system locations. All paths are assumed to be under a service user in $HOME.
All implementations use the paths resolved by the Python AppDirs object for user configuration.
numo LLC and Triple LLC, <coronado.project AT numo.com>
FAQs
Coronado - Triple API Python wrapper and reference implementation.
We found that coronado demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.