Skip to main content

A python wrapper for the Tibber API.

Project description

tibber.py - The Python wrapper for the Tibber API

MIT license badge Language grade: Python Code Coverage PyPI version

Tests 3.9 Tests 3.10 Publish to PyPi status

A python wrapper package for communication with the Tibber API. This package aims to cover all functionalities of the Tibber API.

Installation

Install via pip

python -m pip install tibber.py

Requirements

tibber.py depends only on aiohttp. As of now, the project requires Python 3.9+ as well (this might change in the future to support Python 3.7+).

Examples

Getting basic client data:

import tibber

client = tibber.Client(tibber.DEMO_TOKEN) # Log in with an access token. All information gets updated here and stored in cache.

# These properties are retrieved from cache
print(client.name)         # "Arya Stark"
print(client.user_id)      # "df4b53bf-0709-4679-8744-08876cbb03c1"
print(client.account_type) # ["tibber", "customer"]
print(client.login)        # "edgeir@tibber.com"

Getting basic home data:

import tibber

client = tibber.Client(tibber.DEMO_TOKEN)
home = client.homes[0]

print(home.id)                     # "cc83e83e-8cbf-4595-9bf7-c3cf192f7d9c"
print(home.time_zone)              # "Europe/Oslo"
print(home.app_nickname)           # "Ulltang casa"
print(home.app_avatar)             # "FLOORHOUSE2"
print(home.size)                   # 200
print(home.type)                   # "HOUSE"
print(home.number_of_residents)    # 4
print(home.primary_heating_source) # "AIR2AIR_HEATPUMP"
print(home.has_ventilation_system) # True
print(home.main_fuse_size)         # 63

100% API coverage TODO / Progress list

All the API features are documented here: https://developer.tibber.com/docs/reference

  • Address
  • Consumption
  • ContactInfo
  • Home
  • HomeConsumptionConnection
  • HomeConsumptionEdge
  • HomeConsumptionPageInfo
  • HomeFeatures
  • HomeProductionConnection
  • HomeProductionEdge
  • HomeProductionPageInfo
  • LegalEntity
  • LiveMeasurement
  • MeterReadingResponse
  • MeteringPointData
  • Price
  • PriceInfo
  • PriceRating
  • PriceRatingEntry
  • PriceRatingThresholdPercentages
  • PriceRatingType
  • Production
  • PushNotificationResponse
  • RootMutation
  • RootSubscription
  • Subscription
  • SubscriptionPriceConnection
  • SubscriptionPriceConnectionPageInfo
  • SubscriptionPriceEdge
  • Viewer

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

tibber.py-0.0.3rc0.tar.gz (4.4 kB view hashes)

Uploaded Source

Built Distribution

tibber.py-0.0.3rc0-py3-none-any.whl (4.7 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