Metadata-Version: 2.1
Name: oceanbolt.sdk
Version: 0.1.5
Summary: A Python wrapper around the Oceanbolt client API
Home-page: https://github.com/oceanbolt/oceanbolt-python-sdk
Author: Oceanbolt
Author-email: support@oceanbolt.com
License: MIT
Description: # Oceanbolt Python SDK
        
        [![Github CI](https://github.com/oceanbolt/oceanbolt-python-sdk/actions/workflows/python-ci.yml/badge.svg)](https://github.com/oceanbolt/oceanbolt-python-sdk/actions)
        [![Netlify Status](https://api.netlify.com/api/v1/badges/0c776868-ce00-4c64-a4e1-1817953d3169/deploy-status)](https://app.netlify.com/sites/oceanbolt-python-sdk/deploys)
        
        
        The Oceanbolt Python SDK provides access to Oceanbolt data. It is a python wrapper around the Oceanbolt Data API.
        
        It can be easily integrated existing tools such as jupyter notebooks, scripts, and applications.
        
        Data is returned in the form of pandas.DataFrame, which allows for easy manipulation and further data processing. 
        
        The python SDK is available to all Oceanbolt API clients (API authentication token required in order to get access). API tokens can be generated in the Oceanbolt App (app.oceanbolt.com)
        
        ## Project Status
        
        **IMPORTANT**: The oceanbolt-python-sdk is still undergoing development, and certain features may be changed/removed before the launch of version 1.0.0 
        
        ## Setup
        
        The SDK supports the following python versions: 3.6, 3.7, 3.8, and 3.9
        
        In order to install, run the following:
        
            pip install oceanbolt.sdk
        
        In order to upgrade an existing installation, run the following:
        
            pip install oceanbolt.sdk --upgrade
            
        ## Docs
        Documentation : https://python-sdk.oceanbolt.com
        
        ## Quick Example
        
        ````python
        from oceanbolt.sdk.client import APIClient
        from oceanbolt.sdk.data.port_calls import PortCalls
        from datetime import date, timedelta
        
        # Create the base API client using your token. Tokens can be created in the Oceanbolt App (app.oceanbolt.com)
        base_client = APIClient("<your API access token>")
        
        # Connect to one of the Oceanbolt's data endpoints using the base client object, ie: PortCalls
        port_calls_client = PortCalls(base_client)
        
        # Get a list of Port Hedland exports over the last week
        hedland_portcalls = port_calls_client.get(
            start_date=date.today() - timedelta(days=7),
            segment=["capesize"],
            unlocode=["AUPHE"],
        )
        
        ````
        
        
Platform: Posix; MacOS X; Windows
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: docs
Provides-Extra: test
Provides-Extra: publish
