Skip to main content

API for Sprinkl sprinkler controller

Project description

sprinkl-async: A Simple Python Library for Sprinkl™ Controllers

Travis CI PyPi Version License Code Coverage Maintainability

sprinkl-async is a Python library for interacting with Sprinkl™ Control SR-400

Python Versions

The python test suite requires Python 3.6 or higher; tests run on Python 3.5 will fail.

sprinkl-async is currently supported on:

  • Python 3.5
  • Python 3.6
  • Python 3.7

Installation

pip install sprinkl_async

Examples

Get controller and zones

import asyncio
from aiohttp import ClientSession
from sprinkl_async import Client

async def main() -> None:
    """Create client and login"""
    async with ClientSession() as session:
        # Create sprinkl-async client
        client = Client(session)

        # login
        auth = await client.login(email="email", password="secret")

asyncio.get_event_loop().run_until_complete(main())

Developing

  1. Install developer environment: make init
  2. Use virtual environment for development: pipenv shell
  3. Write code/tests and be happy
  4. Update README.MD with examples

Testing

  1. Write new tests for the functionality added
  2. Run tests and ensure 100% coverage: make coverage
  3. Ensure no lint errors: make lint
  4. Ensure no typing errors: make type

Contributing

Follow the developing/testing flows and follow CONTRIBUTING.MD for details.

License

Apache 2.0; see LICENSE for details.

Inspiration

The API for Sprinkl-async follow the same design principals as Regenmaschine Say Thanks

Disclaimer

This project is not an official Google project. It is not supported by Google and Google specifically disclaims all warranties as to its quality, merchantability, or fitness for a particular purpose.

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

sprinkl_async-0.0.3.tar.gz (13.8 kB view hashes)

Uploaded Source

Built Distribution

sprinkl_async-0.0.3-py3-none-any.whl (28.4 kB view hashes)

Uploaded 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