Skip to main content

FastrPI is a client to interact with a FastrPI repository storing Fastr Networks and (Dockerized) Tools.

Project description

The package fastrpi is the client to interact with the FastrPI, the Fastr Package Index, where Fastr Networks, Tools and Datatypes are gathered to use with Fastr. In the FastrPI repository the Fastr Network, Tool and Datatype definitions are stored, as well as Dockerized versions of the Fastr Tools. By using the FastrPI client the networks can easily be retrieved and run using either Docker or Singularity.

The code can be found on Gitlab and the documentation is available through ReadTheDocs.

The FastrPI repository itself is currently not open to the public.

Install

To use fastrpi it is necessary to have Git (>=1.7.0) installed and either Docker or Singularity. Install and set up FastrPI by running: .. codeblock:

pip install fastrpi
fastrpi init

During the initialization process you will be guided through the setup process. To use the private repository and to publish packages you will need to set an SSH connection with GitLab and have a GitLab API token. See the documentation for more information.

Usage

The fastrpi package can be used to install, run, create, edit and publish Fastr Tools and Networks. Here is a quick introduction to installing and running a network.

Before you can run a Network it needs to be installed. You can do so by using:

fastrpi install network network_name -v version

During the installation of this network the necessary Tools will also be installed. With this installation the Docker containers associated with these Tools will also be pulled using either Docker or Singularity. The available Networks and Tools in the FastrPI repository can be viewed using fastrpi list networks and fastrpi list tools.

After installing a Network it can be run using:

fastrpi run network_name -v version --source_sink ./source_sink.py

The file ./source_sink.py must contain the functions get_source_data() and get_sink_data(). These functions must return dictionaries containing the Sources and Sinks, as described here.

Further information about the functionality of FastrPI can be found in the documentation.

Known issues

  • The package is not yet tested on Windows.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastrpi-1.0.1.tar.gz (46.4 kB view details)

Uploaded Source

Built Distribution

fastrpi-1.0.1-py3-none-any.whl (57.6 kB view details)

Uploaded Python 3

File details

Details for the file fastrpi-1.0.1.tar.gz.

File metadata

  • Download URL: fastrpi-1.0.1.tar.gz
  • Upload date:
  • Size: 46.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.15

File hashes

Hashes for fastrpi-1.0.1.tar.gz
Algorithm Hash digest
SHA256 8eaac700c6e4f68bb8fe45b20d629ae7e6ea2fbd46e1f3de8df3881ec6bd4663
MD5 cb56f94007769f968bc137a5f8fd0fa8
BLAKE2b-256 4c9a7adb793d8beaba6569d7734b8e4195c5cb4442d9d50874c9d6064c76bc45

See more details on using hashes here.

File details

Details for the file fastrpi-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: fastrpi-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 57.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.15

File hashes

Hashes for fastrpi-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 98c693d5772d47786b22f5d9437fd2ee1e265ff19d267ee2915cebafa2715848
MD5 db20638fba3d218f78e47362a8f22823
BLAKE2b-256 dfdf92ae181c0c8d76f729a7edf9ee58a33664c6066f4a647e7332628f4993c3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page