trmnl 0.1.0__tar.gz

trmnl-0.1.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joost Lekkerkerker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

trmnl-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: trmnl
+Version: 0.1.0
+Summary: Asynchronous Python client for TRMNL.
+License: MIT
+License-File: LICENSE.md
+Keywords: TRMNL,api,async,client
+Author: Joost Lekkerkerker
+Author-email: joostlek@outlook.com
+Maintainer: Joost Lekkerkerker
+Maintainer-email: joostlek@outlook.com
+Requires-Python: >=3.13,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: aiohttp (>=3.0.0)
+Requires-Dist: mashumaro (>=3.11,<4.0)
+Requires-Dist: orjson (>=3.9.0)
+Requires-Dist: yarl (>=1.6.0)
+Project-URL: Bug Tracker, https://github.com/joostlek/python-trmnl/issues
+Project-URL: Changelog, https://github.com/joostlek/python-trmnl/releases
+Project-URL: Documentation, https://github.com/joostlek/python-trmnl
+Project-URL: Homepage, https://github.com/joostlek/python-trmnl
+Project-URL: Repository, https://github.com/joostlek/python-trmnl
+Description-Content-Type: text/markdown
+
+# Python: TRMNL
+
+[![GitHub Release][releases-shield]][releases]
+[![Python Versions][python-versions-shield]][pypi]
+![Project Stage][project-stage-shield]
+![Project Maintenance][maintenance-shield]
+[![License][license-shield]](LICENSE.md)
+
+[![Build Status][build-shield]][build]
+[![Code Coverage][codecov-shield]][codecov]
+
+Asynchronous Python client for TRMNL.
+
+## About
+
+This package allows you to control and fetch data from your TRMNL device.
+
+## Installation
+
+```bash
+pip install trmnl
+```
+
+## Changelog & Releases
+
+This repository keeps a change log using [GitHub's releases][releases]
+functionality. The format of the log is based on
+[Keep a Changelog][keepchangelog].
+
+Releases are based on [Semantic Versioning][semver], and use the format
+of `MAJOR.MINOR.PATCH`. In a nutshell, the version will be incremented
+based on the following:
+
+- `MAJOR`: Incompatible or major changes.
+- `MINOR`: Backwards-compatible new features and enhancements.
+- `PATCH`: Backwards-compatible bugfixes and package updates.
+
+## Contributing
+
+This is an active open-source project. We are always open to people who want to
+use the code or contribute to it.
+
+We've set up a separate document for our
+[contribution guidelines](.github/CONTRIBUTING.md).
+
+Thank you for being involved! :heart_eyes:
+
+## Setting up development environment
+
+This Python project is fully managed using the [Poetry][poetry] dependency manager. But also relies on the use of NodeJS for certain checks during development.
+
+You need at least:
+
+- Python 3.13+
+- [Poetry][poetry-install]
+- NodeJS 12+ (including NPM)
+
+To install all packages, including all development requirements:
+
+```bash
+npm install
+poetry install
+```
+
+As this repository uses the [pre-commit][pre-commit] framework, all changes
+are linted and tested with each commit. You can run all checks and tests
+manually, using the following command:
+
+```bash
+poetry run pre-commit run --all-files
+```
+
+To run just the Python tests:
+
+```bash
+poetry run pytest
+```
+
+## Authors & contributors
+
+The content is by [Joost Lekkerkerker][joostlek].
+
+For a full list of all authors and contributors,
+check [the contributor's page][contributors].
+
+## License
+
+MIT License
+
+Copyright (c) 2026 Joost Lekkerkerker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+[build-shield]: https://github.com/joostlek/python-trmnl/actions/workflows/tests.yaml/badge.svg
+[build]: https://github.com/joostlek/python-trmnl/actions
+[codecov-shield]: https://codecov.io/gh/joostlek/python-trmnl/branch/master/graph/badge.svg
+[codecov]: https://codecov.io/gh/joostlek/python-trmnl
+[commits-shield]: https://img.shields.io/github/commit-activity/y/joostlek/python-trmnl.svg
+[commits]: https://github.com/joostlek/python-trmnl/commits/master
+[contributors]: https://github.com/joostlek/python-trmnl/graphs/contributors
+[joostlek]: https://github.com/joostlek
+[keepchangelog]: http://keepachangelog.com/en/1.0.0/
+[license-shield]: https://img.shields.io/github/license/joostlek/python-trmnl.svg
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
+[poetry-install]: https://python-poetry.org/docs/#installation
+[poetry]: https://python-poetry.org
+[pre-commit]: https://pre-commit.com/
+[project-stage-shield]: https://img.shields.io/badge/project%20stage-stable-green.svg
+[python-versions-shield]: https://img.shields.io/pypi/pyversions/trmnl
+[releases-shield]: https://img.shields.io/github/release/joostlek/python-trmnl.svg
+[releases]: https://github.com/joostlek/python-trmnl/releases
+[semver]: http://semver.org/spec/v2.0.0.html
+[pypi]: https://pypi.org/project/trmnl/
+

trmnl-0.1.0/README.md

@@ -0,0 +1,129 @@
+# Python: TRMNL
+
+[![GitHub Release][releases-shield]][releases]
+[![Python Versions][python-versions-shield]][pypi]
+![Project Stage][project-stage-shield]
+![Project Maintenance][maintenance-shield]
+[![License][license-shield]](LICENSE.md)
+
+[![Build Status][build-shield]][build]
+[![Code Coverage][codecov-shield]][codecov]
+
+Asynchronous Python client for TRMNL.
+
+## About
+
+This package allows you to control and fetch data from your TRMNL device.
+
+## Installation
+
+```bash
+pip install trmnl
+```
+
+## Changelog & Releases
+
+This repository keeps a change log using [GitHub's releases][releases]
+functionality. The format of the log is based on
+[Keep a Changelog][keepchangelog].
+
+Releases are based on [Semantic Versioning][semver], and use the format
+of `MAJOR.MINOR.PATCH`. In a nutshell, the version will be incremented
+based on the following:
+
+- `MAJOR`: Incompatible or major changes.
+- `MINOR`: Backwards-compatible new features and enhancements.
+- `PATCH`: Backwards-compatible bugfixes and package updates.
+
+## Contributing
+
+This is an active open-source project. We are always open to people who want to
+use the code or contribute to it.
+
+We've set up a separate document for our
+[contribution guidelines](.github/CONTRIBUTING.md).
+
+Thank you for being involved! :heart_eyes:
+
+## Setting up development environment
+
+This Python project is fully managed using the [Poetry][poetry] dependency manager. But also relies on the use of NodeJS for certain checks during development.
+
+You need at least:
+
+- Python 3.13+
+- [Poetry][poetry-install]
+- NodeJS 12+ (including NPM)
+
+To install all packages, including all development requirements:
+
+```bash
+npm install
+poetry install
+```
+
+As this repository uses the [pre-commit][pre-commit] framework, all changes
+are linted and tested with each commit. You can run all checks and tests
+manually, using the following command:
+
+```bash
+poetry run pre-commit run --all-files
+```
+
+To run just the Python tests:
+
+```bash
+poetry run pytest
+```
+
+## Authors & contributors
+
+The content is by [Joost Lekkerkerker][joostlek].
+
+For a full list of all authors and contributors,
+check [the contributor's page][contributors].
+
+## License
+
+MIT License
+
+Copyright (c) 2026 Joost Lekkerkerker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+[build-shield]: https://github.com/joostlek/python-trmnl/actions/workflows/tests.yaml/badge.svg
+[build]: https://github.com/joostlek/python-trmnl/actions
+[codecov-shield]: https://codecov.io/gh/joostlek/python-trmnl/branch/master/graph/badge.svg
+[codecov]: https://codecov.io/gh/joostlek/python-trmnl
+[commits-shield]: https://img.shields.io/github/commit-activity/y/joostlek/python-trmnl.svg
+[commits]: https://github.com/joostlek/python-trmnl/commits/master
+[contributors]: https://github.com/joostlek/python-trmnl/graphs/contributors
+[joostlek]: https://github.com/joostlek
+[keepchangelog]: http://keepachangelog.com/en/1.0.0/
+[license-shield]: https://img.shields.io/github/license/joostlek/python-trmnl.svg
+[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg
+[poetry-install]: https://python-poetry.org/docs/#installation
+[poetry]: https://python-poetry.org
+[pre-commit]: https://pre-commit.com/
+[project-stage-shield]: https://img.shields.io/badge/project%20stage-stable-green.svg
+[python-versions-shield]: https://img.shields.io/pypi/pyversions/trmnl
+[releases-shield]: https://img.shields.io/github/release/joostlek/python-trmnl.svg
+[releases]: https://github.com/joostlek/python-trmnl/releases
+[semver]: http://semver.org/spec/v2.0.0.html
+[pypi]: https://pypi.org/project/trmnl/

trmnl-0.1.0/pyproject.toml

@@ -0,0 +1,163 @@
+[tool.poetry]
+name = "trmnl"
+version = "0.1.0"
+description = "Asynchronous Python client for TRMNL."
+authors = ["Joost Lekkerkerker <joostlek@outlook.com>"]
+maintainers = ["Joost Lekkerkerker <joostlek@outlook.com>"]
+license = "MIT"
+readme = "README.md"
+homepage = "https://github.com/joostlek/python-trmnl"
+repository = "https://github.com/joostlek/python-trmnl"
+documentation = "https://github.com/joostlek/python-trmnl"
+keywords = ["TRMNL", "api", "async", "client"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Framework :: AsyncIO",
+  "Intended Audience :: Developers",
+  "Natural Language :: English",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+packages = [
+    { include = "trmnl", from = "src" },
+]
+
+[tool.poetry.dependencies]
+python = "^3.13"
+aiohttp = ">=3.0.0"
+yarl = ">=1.6.0"
+mashumaro = "^3.11"
+orjson = ">=3.9.0"
+
+[tool.poetry.group.dev.dependencies]
+codespell = "2.4.1"
+covdefaults = "2.3.0"
+coverage = {version = "7.13.4", extras = ["toml"]}
+mypy = "1.19.1"
+pre-commit = "4.5.1"
+pre-commit-hooks = "6.0.0"
+pylint = "4.0.5"
+pytest = "9.0.2"
+pytest-asyncio = "1.3.0"
+pytest-cov = "7.0.0"
+ruff = "0.15.2"
+safety = "3.7.0"
+yamllint = "1.38.0"
+syrupy = "5.1.0"
+aioresponses = "0.7.8"
+
+[tool.poetry.urls]
+"Bug Tracker" = "https://github.com/joostlek/python-trmnl/issues"
+Changelog = "https://github.com/joostlek/python-trmnl/releases"
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 50
+
+[tool.coverage.run]
+plugins = ["covdefaults"]
+source = ["trmnl"]
+
+[tool.mypy]
+# Specify the target platform details in config, so your developers are
+# free to run mypy on Windows, Linux, or macOS and get consistent
+# results.
+platform = "linux"
+python_version = "3.12"
+
+# show error messages from unrelated files
+follow_imports = "normal"
+
+# suppress errors about unsatisfied imports
+ignore_missing_imports = true
+
+# be strict
+check_untyped_defs = true
+disallow_any_generics = true
+disallow_incomplete_defs = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_untyped_decorators = true
+disallow_untyped_defs = true
+no_implicit_optional = true
+strict_optional = true
+warn_incomplete_stub = true
+warn_no_return = true
+warn_redundant_casts = true
+warn_return_any = true
+warn_unused_configs = true
+warn_unused_ignores = true
+
+[tool.pylint.MASTER]
+ignore = [
+  "tests",
+]
+
+[tool.pylint.BASIC]
+good-names = [
+  "_",
+  "ex",
+  "fp",
+  "i",
+  "id",
+  "j",
+  "k",
+  "on",
+  "Run",
+  "T",
+]
+
+[tool.pylint.DESIGN]
+max-attributes = 8
+
+[tool.pylint."MESSAGES CONTROL"]
+disable = [
+  "duplicate-code",
+  "format",
+  "unsubscriptable-object",
+  "too-many-instance-attributes",
+  "wrong-import-order",
+  "too-many-arguments",
+  "too-many-positional-arguments",
+]
+
+[tool.pylint.SIMILARITIES]
+ignore-imports = true
+
+[tool.pylint.FORMAT]
+max-line-length = 88
+
+[tool.pytest.ini_options]
+addopts = "--cov"
+asyncio_mode = "auto"
+
+[tool.ruff.lint]
+ignore = [
+  "ANN401", # Opinioated warning on disallowing dynamically typed expressions
+  "COM812", # Conflicts with other rules
+  "D203", # Conflicts with other rules
+  "D213", # Conflicts with other rules
+  "D417", # False positives in some occasions
+  "ISC001", # Conflicts with other rules
+  "PLR2004", # Just annoying, not really useful
+]
+select = ["ALL"]
+
+[tool.ruff.lint.flake8-pytest-style]
+fixture-parentheses = false
+mark-parentheses = false
+
+[tool.ruff.lint.isort]
+known-first-party = ["trmnl"]
+force-sort-within-sections = true
+split-on-trailing-comma = false
+combine-as-imports = true
+
+[tool.ruff.lint.mccabe]
+max-complexity = 25
+
+[build-system]
+build-backend = "poetry.core.masonry.api"
+requires = ["poetry-core>=1.0.0"]

trmnl-0.1.0/src/trmnl/__init__.py

@@ -0,0 +1,5 @@
+"""Asynchronous Python client for TRMNL."""
+
+from .trmnl import TRMNLClient
+
+__all__ = ["TRMNLClient"]

trmnl-0.1.0/src/trmnl/const.py

@@ -0,0 +1 @@
+"""Constants for TRMNL."""

trmnl-0.1.0/src/trmnl/exceptions.py

@@ -0,0 +1,9 @@
+"""Asynchronous Python client for TRMNL."""
+
+
+class TRMNLError(Exception):
+    """Generic exception."""
+
+
+class TRMNLAuthenticationError(TRMNLError):
+    """Authentication error."""

trmnl-0.1.0/src/trmnl/models.py

@@ -0,0 +1,109 @@
+"""Models for TRMNL."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from mashumaro import field_options
+from mashumaro.mixins.orjson import DataClassORJSONMixin
+
+
+@dataclass
+class PluginSetting(DataClassORJSONMixin):
+    """Plugin setting model."""
+
+    identifier: int = field(metadata=field_options(alias="id"))
+    name: str
+    plugin_id: int
+
+
+@dataclass
+class PluginSettingResponse(DataClassORJSONMixin):
+    """Plugin setting response."""
+
+    data: PluginSetting
+
+
+@dataclass
+class PluginSettingsResponse(DataClassORJSONMixin):
+    """Plugin settings list response."""
+
+    data: list[PluginSetting]
+
+
+@dataclass
+class Device(DataClassORJSONMixin):
+    """Device model."""
+
+    identifier: int = field(metadata=field_options(alias="id"))
+    name: str
+    friendly_id: str
+    mac_address: str
+    battery_voltage: float | None
+    rssi: int | None
+    sleep_mode_enabled: bool
+    sleep_start_time: int
+    sleep_end_time: int
+    percent_charged: float
+    wifi_strength: int
+
+
+@dataclass
+class DeviceResponse(DataClassORJSONMixin):
+    """Device response."""
+
+    data: Device
+
+
+@dataclass
+class DevicesResponse(DataClassORJSONMixin):
+    """Devices list response."""
+
+    data: list[Device]
+
+
+@dataclass
+class User(DataClassORJSONMixin):
+    """User model."""
+
+    identifier: int = field(metadata=field_options(alias="id"))
+    name: str
+    email: str
+    first_name: str
+    last_name: str
+    locale: str
+    time_zone: str
+    time_zone_iana: str
+    utc_offset: int
+    api_key: str
+
+
+@dataclass
+class UserResponse(DataClassORJSONMixin):
+    """User response."""
+
+    data: User
+
+
+@dataclass
+class PlaylistItem(DataClassORJSONMixin):
+    """Playlist item model."""
+
+    created_at: str
+    device_id: int
+    identifier: int = field(metadata=field_options(alias="id"))
+    mashup_id: int | None
+    mirror: bool
+    plugin_setting_id: int
+    rendered_at: str
+    row_order: int
+    updated_at: str
+    visible: bool
+    plugin_setting: PluginSetting
+
+
+@dataclass
+class PlaylistItemsResponse(DataClassORJSONMixin):
+    """Playlist items list response."""
+
+    data: list[PlaylistItem]

trmnl-0.1.0/src/trmnl/trmnl.py

@@ -0,0 +1,176 @@
+"""Asynchronous Python client for TRMNL."""
+
+from __future__ import annotations
+
+import asyncio
+from dataclasses import dataclass
+import logging
+from typing import Any, Self
+
+from aiohttp import ClientSession
+from aiohttp.hdrs import METH_DELETE, METH_GET, METH_PATCH, METH_POST
+from yarl import URL
+
+from trmnl.models import (
+    Device,
+    DeviceResponse,
+    DevicesResponse,
+    PlaylistItem,
+    PlaylistItemsResponse,
+    PluginSetting,
+    PluginSettingResponse,
+    PluginSettingsResponse,
+    User,
+    UserResponse,
+)
+
+VERSION = "1"
+
+_LOGGER = logging.getLogger(__package__)
+
+HOST = "trmnl.com"
+
+
+@dataclass
+class TRMNLClient:
+    """Main class for handling connections with the TRMNL API."""
+
+    token: str
+    session: ClientSession | None = None
+    request_timeout: int = 10
+    _close_session: bool = False
+
+    async def _request(
+        self,
+        uri: str,
+        *,
+        method: str = METH_GET,
+        data: dict[str, Any] | None = None,
+    ) -> str:
+        """Handle a request to the TRMNL API."""
+        url = URL.build(host=HOST, scheme="https").joinpath(f"api/{uri}")
+        headers = {
+            "User-Agent": f"python-trmnl/{VERSION}",
+            "Authorization": f"Bearer {self.token}",
+        }
+
+        if self.session is None:
+            self.session = ClientSession()
+            self._close_session = True
+
+        async with asyncio.timeout(self.request_timeout):
+            response = await self.session.request(
+                method,
+                url,
+                headers=headers,
+                json=data,
+            )
+
+        return await response.text()
+
+    async def _get(self, uri: str) -> str:
+        """Handle a GET request to the TRMNL API."""
+        return await self._request(uri, method=METH_GET)
+
+    async def _patch(self, uri: str, data: dict[str, Any]) -> str:
+        """Handle a PATCH request to the TRMNL API."""
+        return await self._request(uri, method=METH_PATCH, data=data)
+
+    async def _post(self, uri: str, data: dict[str, Any]) -> str:
+        """Handle a POST request to the TRMNL API."""
+        return await self._request(uri, method=METH_POST, data=data)
+
+    async def _delete(self, uri: str) -> None:
+        """Handle a DELETE request to the TRMNL API."""
+        await self._request(uri, method=METH_DELETE)
+
+    async def get_devices(self) -> list[Device]:
+        """Retrieve the list of devices."""
+        result = await self._get("devices")
+        return DevicesResponse.from_json(result).data
+
+    async def get_device(self, device_id: int) -> Device:
+        """Retrieve a single device by ID."""
+        result = await self._get(f"devices/{device_id}")
+        return DeviceResponse.from_json(result).data
+
+    async def update_device(
+        self,
+        device_id: int,
+        *,
+        sleep_mode_enabled: bool | None = None,
+        sleep_start_time: int | None = None,
+        sleep_end_time: int | None = None,
+        percent_charged: float | None = None,
+    ) -> None:
+        """Update a device."""
+        payload: dict[str, Any] = {}
+        if sleep_mode_enabled is not None:
+            payload["sleep_mode_enabled"] = sleep_mode_enabled
+        if sleep_start_time is not None:
+            payload["sleep_start_time"] = sleep_start_time
+        if sleep_end_time is not None:
+            payload["sleep_end_time"] = sleep_end_time
+        if percent_charged is not None:
+            payload["percent_charged"] = percent_charged
+        await self._patch(f"devices/{device_id}", payload)
+
+    async def get_me(self) -> User:
+        """Retrieve the current user."""
+        result = await self._get("me")
+        return UserResponse.from_json(result).data
+
+    async def get_playlist_items(self) -> list[PlaylistItem]:
+        """Retrieve all playlist items."""
+        result = await self._get("playlists/items")
+        return PlaylistItemsResponse.from_json(result).data
+
+    async def update_playlist_item(self, item_id: int, *, visible: bool) -> None:
+        """Update a playlist item's visibility."""
+        await self._patch(f"playlists/items/{item_id}", {"visible": visible})
+
+    async def get_plugin_settings(
+        self, plugin_id: int | None = None
+    ) -> list[PluginSetting]:
+        """Retrieve plugin settings, optionally filtered by plugin_id."""
+        uri = "plugin_settings"
+        if plugin_id is not None:
+            uri = f"{uri}?plugin_id={plugin_id}"
+        result = await self._get(uri)
+        return PluginSettingsResponse.from_json(result).data
+
+    async def create_plugin_setting(self, name: str, plugin_id: int) -> PluginSetting:
+        """Create a new plugin setting."""
+        result = await self._post(
+            "plugin_settings", {"name": name, "plugin_id": plugin_id}
+        )
+        return PluginSettingResponse.from_json(result).data
+
+    async def delete_plugin_setting(self, plugin_setting_id: int) -> None:
+        """Delete a plugin setting."""
+        await self._delete(f"plugin_settings/{plugin_setting_id}")
+
+    async def close(self) -> None:
+        """Close open client session."""
+        if self.session and self._close_session:
+            await self.session.close()
+
+    async def __aenter__(self) -> Self:
+        """Async enter.
+
+        Returns
+        -------
+            The TRMNLClient object.
+
+        """
+        return self
+
+    async def __aexit__(self, *_exc_info: object) -> None:
+        """Async exit.
+
+        Args:
+        ----
+            _exc_info: Exec type.
+
+        """
+        await self.close()