Skip to main content

Ocean/squid-py wrapper.

Project description

starfish-py

Travis (.com) Codacy Badge GitHub contributors Squid Version Barge Version


Table of Contents


About

Starfish is an open-sourced developer toolkit for the data economy. Available in flavours of Java, Python, and Clojure, it allows developers, data scientists and enterprises to create, interact, integrate and manage a data supply line through standardised and simple-to-use APIs.

Based on an underlying data ecosystem standard, Starfish provides high-level APIs for common tasks within the data economy, for example, registering/publishing an asset, for subsequent use in a data supply line. In this case, an asset can be any data set, model or data service. The high-level API also allows developers to invoke operation on an asset, e.g. computing a predictive model or anonymising sensitive personal information, among other capabilities.

Starfish works with blockchain networks, such as Ocean Protocol, and common web services through agents, allowing unprecedented flexibility in asset discovery and data supply line management.

Starfish-py provides user access and tools to work with the Ocean Protocol Network, delegating certain functions via the python library squid-py.

While we strive to deliver code at a high quality, please note, that there exist parts of the library that still need thorough testing. Contributions – whether it is in the form of new features, better documentation or tests – are welcome.

Prerequisites

Python 3.6

Development

  1. Clone this repo

    clone https://github.com/DEX-Company/starfish-py.git
    cd starfish-py
    
  2. Set up a virtual environment

    virtualenv venv
    source venv/bin/activate
    
  3. Install package requirements for starfish

    pip install -r requirements_dev.txt
    
  4. Run the unit tests, without any supporting software/libraries outside of starfish

    pytest tests/unit
    
  5. To run the full test using the current remote implementation of barge.

    git clone https://github.com/DEX-Company/barge.git
    cd barge
    git checkout tags/dex-2019-09-11
    ./start_ocean.sh --no-brizo --no-pleuston --local-spree-node
    

    Or to run barge locally, using the same method above but using a script instead.

    export BARGE_URL=http://localhost
    scripts/setup_for_local_barge.sh
    
  6. Run the integration tests

    pytest tests/integration
    
  7. Run the all tests

    pytest tests
    

Documentation

  1. Build Sphinx documentation

    To build the Syphinx auto documentation, you need to do the following:

    make docs
    

The documentation for this repo.

Testing

Automatic tests are setup via Travis, executing tox. Our test use pytest framework. The testing uses the remote barge server to test with

New Version

The bumpversion.sh script helps to bump the project version. You can execute the script using as first argument {major|minor|patch} to bump accordingly the version.

Mailing Lists

  • [developer@dex.sg][starfish-qa] -- General questions regarding the usage of Starfish.

Maintainers

[Developer Dex team][developer@dex.sg]

License

Copyright 2018 Ocean Protocol Foundation Ltd.
Copyright 2018-2019 DEX Pte. Ltd.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


Project details


Release history Release notifications | RSS feed

This version

0.5.5

Download files

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

Source Distribution

starfish-py-0.5.5.tar.gz (118.6 kB view hashes)

Uploaded Source

Built Distribution

starfish_py-0.5.5-py2.py3-none-any.whl (68.0 kB view hashes)

Uploaded Python 2 Python 3

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