Package: tellcore-py
Python wrapper for Telldus Coretellcore-py is a Python wrapper forTelldus’home
automation libraryTelldus Core.Documentation:https://tellcore-py.readthedocs.org/Official home page:https://github.com/erijo/tellcore-pyPython package index:https://pypi.python.org/pypi/tellcore-pyPlease report any problem as aGitHub issue report.FeaturesWraps the C-interface with a python interface (with classes and exceptions).Automatically frees memory for returned strings.Throws an exception (TelldusError) in case a library function returns an
error.Supports python 3 with automatic handling of strings (i.e. converting between
bytes used by the C-library and strings as used by python).Takes care of making callbacks from the library thread-safe.Unit tested.Besides being useful with the regular Python implementation (a.k.a.CPython), it also works withpypy.Open source (GPLv3+).Works on Linux, Mac OS X and Windows.RequirementsPython 2.7, 3.2+ or pypyTelldus Core libraryInstallation$pipinstalltellcore-pyCan also be installed by cloning theGIP repositoryor downloading theZIP archivefrom GitHub and
unpacking it. Then change directory to tellcore-py and run:$pythonsetup.pyinstallUsersHome Assistant- Open-source home automation
platform running on Python 3Tellprox- A local server to
use in place of Telldus Livetellive-py- A Python wrapper for
Telldus LiveExampleA simple example for adding a new “lamp” device, turning it on and then turning
all devices off.fromtellcore.telldusimportTelldusCorecore=TelldusCore()lamp=core.add_device("lamp","arctech","selflearning-switch",house=12345,unit=1)lamp.turn_on()fordeviceincore.devices():device.turn_off()More examples can be found in thebindirectory.InternalsAt the bottom there is the Library class which is actypeswrapper and closely matches the
API of the underlying Telldus Core library. The library class takes care of
freeing memory returned from the base library and converts errors returned to
TelldusException. The library class is not intended to be used directly.Instead, the TelldusCore class provides a more python-ish API on top of the
library class. This class is used for e.g. adding new devices, or enumerating
the existing devices, sensors and/or controllers. E.g. calling the devices()
method returns a list of Device instances. The Device class in turn has methods
for turning the device on, off, etc.Changelog1.1.3 (2016-11-22)Added datetime attribute toSensorValue.Fixed strange problem inLibrarywhere the class itself could
sometimes be None in__del__.1.1.2 (2015-06-24)Added option toLibraryto make it possible to select if strings should
be decoded or not.Made tellcore_tool not decode strings (i.e. convert to unicode) when running
under Python 2.x to avoid unicode errors when printing non ascii characters.1.1.1 (2015-05-01)Fixed a bug that made tellcore_tool not work with Python 3.x.1.1.0 (2014-11-19)The callback dispatcher is no longer global, but tied to aLibraryinstance. Applications wishing to use callbacks must now pass an explicit
dispatcher instance to theTelldusCoreconstructor.1.0.4 (2014-11-05)Madelast_sent_valuereturn an int instead of string.1.0.3 (2014-02-02)Work around crash in Telldus Core (< v2.1.2) when re-initalizing the library
aftertdClose.1.0.2 (2014-01-28)Packaging fixes.1.0.1 (2014-01-26)AddedAsyncioCallbackDispatcherclass for integrating callbacks with the
new event loop available in Python 3.4 (asyncio).Include tools from bin/ when installing.1.0.0 (2014-01-09)Added high level support for device groups in the form of the new classDeviceGroup.More complete documentation.Removed the methods process_callback and process_pending_callbacks fromTelldusCore. Instead, callback_dispatcher is now a public attribute ofTelldusCoreand the default callback dispatcherQueuedCallbackDispatcherimplements the two methods instead.0.9.0 (2014-01-03)Telldus functions that used to return bool (tdSetName,tdSetProtocol,tdSetModel,tdSetDeviceParameterandtdRemoveDevice) now raise an
exception instead of returning False.Support for rain- and windsensors.Include data type inSensorValue.0.8.0 (2013-08-11)Improved callback handling to simplify integration with different event
loops. Parameter conversion is now done in the library code and the
adaptation to different event loops is done by a simple callback dispatch
class. The default dispatcher (when usingTelldusCore) is still done
using a queue.New documentation for parts of the package. Can be read online athttps://tellcore-py.readthedocs.org/.Fix problem with strings and python 3 (issue #2).0.1.0 (2013-06-26)First release.