Skip to content

Commit 460a2c6

Browse files
committed
Add notes in documentation that I no longer use SmartThings
1 parent f69d6bf commit 460a2c6

File tree

5 files changed

+18
-7
lines changed

5 files changed

+18
-7
lines changed

Changelog

+1-3
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,8 @@ Version 0.7.1 unreleased
33
* Pull in latest version of run-script-framework.
44
* Upgrade to poetry-dynamic-versioning v1.5.2 for minor fixes.
55
* Add .python-version in preferred order to support pyenv.
6-
7-
Version 0.7.1 unreleased
8-
96
* Adjust pyproject.toml comments to fix pip build at readthedocs.
7+
* Add notes in documentation that I no longer use SmartThings.
108

119
Version 0.7.0 08 Jan 2025
1210

PyPI.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,14 @@
99
[![coverage](https://coveralls.io/repos/github/pronovic/smartapp-sdk/badge.svg?branch=main)](https://coveralls.io/github/pronovic/smartapp-sdk?branch=main)
1010
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
1111

12+
_Note: As of January 2025, I have migrated my home automation infrastructure from SmartThings to Home Assistant, so I no longer actively use this software. I will continue to maintain the library, keeping dependencies up-to-date, and supporting new Python versions, etc. Time permitting, I will also continue to accept GitHub issues for bug fixes and enhancement requests. If you submit an issue, please keep in mind that I no longer have a SmartThings environment to test with, so I will expect you to coordinate with me on testing before I release any changes._
13+
14+
---
15+
1216
smartapp-sdk is a Python library to build a [webhook-based SmartApp](https://developer-preview.smartthings.com/docs/connected-services/smartapp-basics/) for the [SmartThings platform](https://www.smartthings.com/).
1317

1418
The SDK is intended to be easy to use no matter how you choose to structure your code, whether that's a traditional Python webapp (such as FastAPI on Uvicorn) or a serverless application (such as AWS Lambda).
1519

1620
The SDK handles all the mechanics of the [webhook lifecycle interface](https://developer-preview.smartthings.com/docs/connected-services/lifecycles/) on your behalf. You just implement a single endpoint to accept the SmartApp webhook requests, and a single callback class where you define specialized behavior for the webhook events. A clean [attrs](https://www.attrs.org/en/stable/) object interface is exposed for use by your callback.
1721

18-
SDK documentation is found at [smartapp-sdk.readthedocs.io](https://smartapp-sdk.readthedocs.io/en/stable/). Look there for installation instructions, the class model documentation, and example code. The [smartapp-sensortrack](https://github.com/pronovic/smartapp-sensortrack) repo on GitHub is also a good example of how to use this SDK to build a traditional Python webapp.
22+
SDK documentation is found at [smartapp-sdk.readthedocs.io](https://smartapp-sdk.readthedocs.io/en/stable/). Look there for installation instructions, the class model documentation, and example code.

README.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,16 @@
99
[![coverage](https://coveralls.io/repos/github/pronovic/smartapp-sdk/badge.svg?branch=main)](https://coveralls.io/github/pronovic/smartapp-sdk?branch=main)
1010
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
1111

12+
_Note: As of January 2025, I have migrated my home automation infrastructure from SmartThings to Home Assistant, so I no longer actively use this software. I will continue to maintain the library, keeping dependencies up-to-date, and supporting new Python versions, etc. Time permitting, I will also continue to accept GitHub issues for bug fixes and enhancement requests. If you submit an issue, please keep in mind that I no longer have a SmartThings environment to test with, so I will expect you to coordinate with me on testing before I release any changes._
13+
14+
---
15+
1216
smartapp-sdk is a Python library to build a [webhook-based SmartApp](https://developer-preview.smartthings.com/docs/connected-services/smartapp-basics/) for the [SmartThings platform](https://www.smartthings.com/).
1317

1418
The SDK is intended to be easy to use no matter how you choose to structure your code, whether that's a traditional Python webapp (such as FastAPI on Uvicorn) or a serverless application (such as AWS Lambda).
1519

1620
The SDK handles all the mechanics of the [webhook lifecycle interface](https://developer-preview.smartthings.com/docs/connected-services/lifecycles/) on your behalf. You just implement a single endpoint to accept the SmartApp webhook requests, and a single callback class where you define specialized behavior for the webhook events. A clean [attrs](https://www.attrs.org/en/stable/) object interface is exposed for use by your callback.
1721

18-
SDK documentation is found at [smartapp-sdk.readthedocs.io](https://smartapp-sdk.readthedocs.io/en/stable/). Look there for installation instructions, the class model documentation, and example code. The [smartapp-sensortrack](https://github.com/pronovic/smartapp-sensortrack) repo on GitHub is also a good example of how to use this SDK to build a traditional Python webapp.
22+
SDK documentation is found at [smartapp-sdk.readthedocs.io](https://smartapp-sdk.readthedocs.io/en/stable/). Look there for installation instructions, the class model documentation, and example code.
1923

2024
Developer documentation for the smartapp-sdk repo is found in [DEVELOPER.md](DEVELOPER.md). See that file for notes about how the code is structured, how to set up a development environment, etc.

SECURITY.md

+5
Original file line numberDiff line numberDiff line change
@@ -7,3 +7,8 @@ This repository uses [Semantic Versioning](https://semver.org/). The latest MAJ
77
## Reporting a Vulnerability
88

99
To report a security issue, please use the GitHub Security Advisory ["Report a Vulnerability"](https://github.com/pronovic/smartapp-sdk/security/advisories/new) tab.
10+
11+
## Testing Expectations
12+
13+
As of January 2025, I have migrated my home automation infrastructure from SmartThings to Home Assistant, so I no longer actively use this software. If you submit an issue, please keep in mind that I no longer have a SmartThings environment to test with, so I will expect you to coordinate with me on testing before I release any changes.
14+

docs/index.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ API Documentation
5151
Using the SDK
5252
-------------
5353

54-
Below are some notes on how to use the SDK. The `smartapp-sensortrack <https://github.com/pronovic/smartapp-sensortrack>`_ repo on GitHub is also a good example of how to use the SDK to build a traditional Python webapp.
54+
Below are some notes on how to use the SDK.
5555

5656
Event Handler
5757
~~~~~~~~~~~~~
@@ -236,4 +236,4 @@ for the installed application. So, if your SmartApp is built around event
236236
handling and scheduled actions triggered by SmartThings, your handler can
237237
probably be stateless. There is probably is not any need to persist any of the
238238
data returned in the ``INSTALL`` or ``UPDATE`` lifecycle events into your own
239-
data store. This is the model folowed in the `smartapp-sensortrack <https://github.com/pronovic/smartapp-sensortrack>`_ example.
239+
data store.

0 commit comments

Comments
 (0)