appdaemon 4.5.1__tar.gz → 4.5.3__tar.gz

appdaemon-4.5.3/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: appdaemon
+Version: 4.5.3
+Summary: Apps for the Home Assistant home automation package.
+Author-email: Andrew I Cockburn <appdaemon@acockburn.com>
+Project-URL: documentation, https://appdaemon.readthedocs.io
+Project-URL: repository, https://github.com/AppDaemon
+Project-URL: changelog, https://github.com/AppDaemon/appdaemon/blob/master/docs/HISTORY.rst
+Keywords: appdaemon,home,automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Home Automation
+Requires-Python: <3.13,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: importlib-metadata; python_version < "3.8"
+Requires-Dist: aiohttp<3.12.0,>=3.9.0
+Requires-Dist: aiohttp_jinja2<1.7.0,>=1.5.1
+Requires-Dist: astral~=3.2
+Requires-Dist: bcrypt<4.3.0,>=4.0.1
+Requires-Dist: deepdiff==8.2.0
+Requires-Dist: feedparser~=6.0.10
+Requires-Dist: iso8601<2.2,>=1.1
+Requires-Dist: paho-mqtt<2.2.0,>=1.6.1
+Requires-Dist: pid~=3.0.4
+Requires-Dist: python-dateutil<2.10.0,>=2.8.2
+Requires-Dist: python-socketio<5.12,>=5.5
+Requires-Dist: pytz<2025.2.0,>=2022.7.1
+Requires-Dist: pyyaml~=6.0.1
+Requires-Dist: requests<2.33.0,>=2.28.2
+Requires-Dist: sockjs<0.14,>=0.11
+Requires-Dist: uvloop==0.21.0; sys_platform != "win32"
+Requires-Dist: tomli==2.2.1
+Requires-Dist: tomli_w<1.3,>=1.0
+Requires-Dist: pydantic~=2.10.6
+Provides-Extra: dev
+Requires-Dist: pip-tools<7.5.0,>=6.12.3; extra == "dev"
+Requires-Dist: build<1.3,>=0.10; extra == "dev"
+Requires-Dist: flake8~=7.1.1; extra == "dev"
+Requires-Dist: black<25.2,>=23.1; extra == "dev"
+Requires-Dist: pre-commit<3.9.0,>=3.1.1; python_version > "3.7" and extra == "dev"
+Requires-Dist: pytest<8.4.0,>=7.2.1; extra == "dev"
+Requires-Dist: ruff<0.7.0,>=0.0.261; extra == "dev"
+Requires-Dist: codespell>=2.4.1; extra == "dev"
+Provides-Extra: doc
+Requires-Dist: sphinx-autobuild<2024.10.0,>=2021.3.14; extra == "doc"
+Requires-Dist: sphinx-rtd-theme==3.0.2; extra == "doc"
+Requires-Dist: pygments<2.20,>=2.14; extra == "doc"
+Requires-Dist: myst-parser==4.0.0; extra == "doc"
+Dynamic: license-file
+
+# Description
+
+AppDaemon is a loosely coupled, multi-threaded, sandboxed python
+execution environment for writing automation apps for various types of Home Automation Software including [Home
+Assistant](https://home-assistant.io/) and MQTT. It has a pluggable architecture allowing it to be integrated with
+practically any event driven application.
+
+It also provides a configurable dashboard (HADashboard)
+suitable for wall mounted tablets.
+
+## Getting started
+
+For full instructions on installation and usage check out the [AppDaemon Project Documentation](http://appdaemon.readthedocs.io).
+
+## Release Cycle Frequency
+
+AppDaemon has reached a very stable point, works reliably and is fairly feature rich at this point
+in its development. For that reason, releases have been slow in recent months. This does not mean that AppDaemon has been abandoned -
+ it is used every day by the core developers and has an active discord server [here](https://discord.gg/sgSr79jW5x) - please join us for tips
+and tricks, AppDaemon discussions and general home automation.
+
+## Contributing
+
+This is an active open-source project. We are always open to people who want to use the code or contribute to it. Thank you for being involved!
+Have a look at the [official documentation](https://appdaemon.readthedocs.io/en/latest/DEV.html) for more information.

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/adapi.py

@@ -489,7 +489,8 @@ class ADAPI:
     # Threading
     #
 
-    def set_app_pin(self, pin: bool) -> None:
+    @utils.sync_decorator
+    async def set_app_pin(self, pin: bool) -> None:
         """Sets an App to be pinned or unpinned.
 
         Args:
@@ -506,7 +507,8 @@ class ADAPI:
         """
         self.AD.app_management.set_app_pin(self.name, pin)
 
-    def get_app_pin(self) -> bool:
+    @utils.sync_decorator
+    async def get_app_pin(self) -> bool:
         """Finds out if the current App is currently pinned or not.
 
         Returns:
@@ -519,7 +521,8 @@ class ADAPI:
         """
         return self.AD.app_management.get_app_pin(self.name)
 
-    def set_pin_thread(self, thread: int) -> None:
+    @utils.sync_decorator
+    async def set_pin_thread(self, thread: int) -> None:
         """Sets the thread that the App will be pinned to.
 
         Args:
@@ -537,7 +540,8 @@ class ADAPI:
         """
         self.AD.app_management.set_pin_thread(self.name, thread)
 
-    def get_pin_thread(self) -> int:
+    @utils.sync_decorator
+    async def get_pin_thread(self) -> int:
         """Finds out which thread the App is pinned to.
 
         Returns:
@@ -590,7 +594,8 @@ class ADAPI:
         # Keeping namespace get/set functions for legacy compatibility
         return self.namespace
 
-    def namespace_exists(self, namespace: str) -> bool:
+    @utils.sync_decorator
+    async def namespace_exists(self, namespace: str) -> bool:
         """Check the existence of a namespace in AppDaemon.
 
         See the `namespace documentation <APPGUIDE.html#namespaces>`__ for more information.
@@ -668,7 +673,8 @@ class ADAPI:
 
         return await self.AD.state.remove_namespace(namespace)
 
-    def list_namespaces(self) -> list[str]:
+    @utils.sync_decorator
+    async def list_namespaces(self) -> list[str]:
         """Get a list of all the namespaces in AppDaemon.
 
         Examples:
@@ -909,7 +915,8 @@ class ADAPI:
         """
         return devices.split(",")
 
-    def get_plugin_config(self, namespace: str | None = None) -> Any:
+    @utils.sync_decorator
+    async def get_plugin_config(self, namespace: str | None = None) -> Any:
         """Gets any useful metadata that the plugin may have available.
 
         For instance, for the HASS plugin, this will return Home Assistant configuration
@@ -931,7 +938,8 @@ class ADAPI:
         namespace = namespace or self.namespace
         return self.AD.plugins.get_plugin_meta(namespace)
 
-    def friendly_name(self, entity_id: str, namespace: str | None = None) -> str:
+    @utils.sync_decorator
+    async def friendly_name(self, entity_id: str, namespace: str | None = None) -> str:
         """Gets the Friendly Name of an entity.
 
         Args:
@@ -1380,7 +1388,7 @@ class ADAPI:
     # State
     #
 
-    @overload
+    @overload # single entity
     @utils.sync_decorator
     async def listen_state(
         self,
@@ -1399,7 +1407,7 @@ class ADAPI:
         **kwargs: Any
     ) -> str: ...
 
-    @overload
+    @overload # multiple entities
     @utils.sync_decorator
     async def listen_state(
         self,
@@ -3642,7 +3650,8 @@ class ADAPI:
         self.AD.futures.add_future(self.name, future)
         return future
 
-    def create_task(
+    @utils.sync_decorator
+    async def create_task(
         self,
         coro: Coroutine[Any, Any, T],
         callback: Callable | None = None,

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/adbase.py

@@ -5,8 +5,9 @@ from pathlib import Path
 from typing import TYPE_CHECKING
 
 from appdaemon import adapi
+from appdaemon import utils
 from appdaemon.models.config.app import AppConfig
-from appdaemon.utils import StateAttrs
+
 
 # Check if the module is being imported using the legacy method
 if __name__ == Path(__file__).name:
@@ -31,7 +32,7 @@ class Entities:  # @todo
         pass
 
     def __get__(self, instance, owner):
-        stateattrs = StateAttrs(instance.get_state())
+        stateattrs = utils.StateAttrs(instance.get_state())
         return stateattrs
 
 
@@ -165,7 +166,8 @@ class ADBase:
     def get_ad_api(self) -> adapi.ADAPI:
         return adapi.ADAPI(self.AD, self.config_model)
 
-    def get_plugin_api(self, plugin_name: str):
+    @utils.sync_decorator
+    async def get_plugin_api(self, plugin_name: str):
         """Get the plugin API for a specific plugin."""
         if isinstance(cfg := self.app_config.root.get(self.name), AppConfig):
             return self.AD.plugins.get_plugin_api(plugin_name, cfg)

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/app_management.py

@@ -615,7 +615,7 @@ class AppManagement:
                     self._compare_sequences(update_actions, cfg, files_to_read)
                     continue
 
-                if name in self.non_apps:
+                if name in self.non_apps or cfg.disable:
                     continue
 
                 # New config found
@@ -685,8 +685,14 @@ class AppManagement:
                 if not module_name.startswith("appdaemon"):
                     self.logger.debug("Importing '%s'", module_name)
                     importlib.import_module(module_name)
-        except SyntaxError as exc:
-            path = Path(exc.filename)
+        except Exception as exc:
+            match exc:
+                case SyntaxError():
+                    path = Path(exc.filename)
+                case NameError():
+                    path = Path(traceback.extract_tb(exc.__traceback__)[-1].filename)
+                case _:
+                    raise exc
             mtime = self.dependency_manager.python_deps.files.mtimes.get(path)
             self.dependency_manager.python_deps.bad_files.add((path, mtime))
             raise exc
@@ -989,13 +995,16 @@ class AppManagement:
             update_actions.apps.reload -= failed_to_stop
 
     async def _start_apps(self, update_actions: UpdateActions):
+        if failed := update_actions.apps.failed:
+            self.logger.warning('Failed to start apps: %s', failed)
+
         start_order = update_actions.apps.start_sort(self.dependency_manager)
         if start_order:
             self.logger.info("Starting apps: %s", update_actions.apps.init_set)
             self.logger.debug("App start order: %s", start_order)
 
             for app_name in start_order:
-                if isinstance((cfg := self.app_config.root[app_name]), AppConfig):
+                if isinstance((cfg := self.app_config.root[app_name]), AppConfig) and not cfg.disable:
                     @ade.wrap_async(self.error, self.AD.app_dir, f"'{app_name}' instantiation")
                     async def safe_create(self: "AppManagement"):
                         try:

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/dependency.py

@@ -92,6 +92,7 @@ def get_file_deps(file_path: str | Path) -> set[str]:
             mod: ast.Module = ast.parse(file_content, filename=file_path)
         except Exception as e:
             logger.warning(f"Error parsing python module with AST: {e}")
+            raise e
         else:
             for node in get_imports(mod):
                 match node:
@@ -107,18 +108,32 @@ def get_file_deps(file_path: str | Path) -> set[str]:
     return set(gen_modules())
 
 
-def get_dependency_graph(files: Iterable[Path], exclude: set[Path] | None = None):
-    graph = {
-        get_full_module_name(f): get_file_deps(f)
-        for f in files
-        if exclude is None or f not in exclude
-    }
+def get_dependency_graph(
+    files: Iterable[Path],
+    exclude: set[Path] | None = None
+) -> tuple[dict[str, set[str]], set[Path]]:
+    """Gets the dependency graph for some Python files.
+
+    Returns:
+        A tuple containing:
+        - A dictionary where keys are module names and values are sets of module names that the key module depends on.
+        - A set of paths that failed to parse or resolve dependencies.
+    """
+    graph = {}
+    failed = set()
+    for f in files:
+        if exclude is None or f not in exclude:
+            try:
+                graph[get_full_module_name(f)] = get_file_deps(f)
+            except Exception:
+                failed.add(f)
+                continue
 
     for mod, deps in graph.items():
         if mod in deps:
             deps.remove(mod)
 
-    return graph
+    return graph, failed
 
 
 def get_all_nodes(deps: dict[str, set[str]]) -> set[str]:

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/dependency_manager.py

@@ -1,4 +1,5 @@
 from abc import ABC
+from copy import deepcopy
 from dataclasses import InitVar, dataclass, field
 from pathlib import Path
 from typing import Iterable
@@ -16,14 +17,14 @@ class Dependencies(ABC):
     ext: str = field(init=False)  # this has to be defined by the children classes
     dep_graph: dict[str, set[str]] = field(init=False)
     rev_graph: dict[str, set[str]] = field(init=False)
-    bad_files: set[Path] = field(default_factory=set, init=False)
+    bad_files: set[tuple[Path, float]] = field(default_factory=set, init=False)
 
     def __post_init__(self):
         self.refresh_dep_graph()
 
     def update(self, new_files: Iterable[Path]):
         self.files.update(new_files)
-        for bf, mtime in self.bad_files:
+        for bf, mtime in deepcopy(self.bad_files):
             new_mtime = self.files.mtimes.get(bf)
             if new_mtime != mtime:
                 assert new_mtime > mtime, f"File {bf} was modified in the future"
@@ -65,7 +66,12 @@ class PythonDeps(Dependencies):
         if self.bad_files:
             bad_files, _ = zip(*self.bad_files)
             bad_files = set(bad_files)
-        self.dep_graph = get_dependency_graph(self.files, exclude=bad_files)
+
+        self.dep_graph, failed = get_dependency_graph(self.files, exclude=bad_files)
+
+        for file in failed:
+            self.bad_files.add((file, self.files.mtimes.get(file, 0)))
+
         self.rev_graph = reverse_graph(self.dep_graph)
 
     def modules_to_import(self) -> set[str]:

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/entity.py

@@ -355,8 +355,6 @@ class Entity:
 
         Args:
             service (str): The service name, without the domain (e.g "toggle")
-            return_result(bool, option): If `return_result` is provided and set to `True` AD will attempt
-                to wait for the result, and return it after execution
             callback: The non-async callback to be executed when complete.
             **kwargs: Each service has different parameter requirements. This argument
                 allows you to specify a comma-separated list of keyword value pairs, e.g.,

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/exceptions.py

@@ -54,9 +54,10 @@ def user_exception_block(logger: Logger, exception: AppDaemonException, app_dir:
     """Function to generate a user-friendly block of text for an exception. Gets the whole chain of exception causes to decide what to do.
     """
     width = 75
+    spacing = 4
     inset = 5
     if header is not None:
-        header = f'{"=" * inset}  {header}  {"=" * (width - inset - len(header))}'
+        header = f'{"=" * inset}  {header}  {"=" * (width - spacing - inset - len(header))}'
     else:
         header = '=' * width
     logger.error(header)
@@ -86,10 +87,12 @@ def user_exception_block(logger: Logger, exception: AppDaemonException, app_dir:
                         logger.error(f'{indent}{filename} line {line} in {func_name}')
             case OSError() if str(exc).endswith('address already in use'):
                 logger.error(f'{indent}{exc.__class__.__name__}: {exc}')
-            case NameError():
+            case NameError() | ImportError():
                 logger.error(f'{indent}{exc.__class__.__name__}: {exc}')
                 if tb := traceback.extract_tb(exc.__traceback__):
                     frame = tb[-1]
+                    file = Path(frame.filename).relative_to(app_dir.parent)
+                    logger.error(f'{indent}  line {frame.lineno} in {file.name}')
                     logger.error(f'{indent}  {frame._line.rstrip()}')
                     error_len = frame.end_colno - frame.colno
                     logger.error(f'{indent}  {" " * (frame.colno - 1)}{"^" * error_len}')
@@ -112,7 +115,7 @@ def user_exception_block(logger: Logger, exception: AppDaemonException, app_dir:
                     for line in lines:
                         logger.error(f'{indent}{line}')
 
-    logger.error('=' * 75)
+    logger.error('=' * width)
 
 
 def unexpected_block(logger: Logger, exception: Exception):

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/http.py

@@ -96,9 +96,7 @@ def route_secure(myfunc):
             return await myfunc(*args)
 
         elif "adcreds" in request.cookies:
-            match = await utils.run_in_executor(
-                self, bcrypt.checkpw, str.encode(self.password), str.encode(request.cookies["adcreds"])
-            )
+            match = await utils.run_in_executor(self, bcrypt.checkpw, str.encode(self.password), str.encode(request.cookies["adcreds"]))
             if match:
                 return await myfunc(*args)
 
@@ -176,12 +174,19 @@ class HTTP:
 
         try:
             url = urlparse(self.url)
-
             self.host = url.hostname
-            try:
+            self.scheme = url.scheme
+
+            if url.port is None:
+                match url.scheme:
+                    case "http":
+                        self.port = 80
+                    case "https":
+                        self.port = 443
+                    case _:
+                        self.port = None  # let the validation catch it
+            else:
                 self.port = url.port
-            except IndexError:
-                self.port = 80
 
             if self.host == "":
                 raise ValueError("Invalid host for 'url'")
@@ -373,9 +378,7 @@ class HTTP:
 
         self._process_arg("url", http)
         if not self.url:
-            self.logger.warning(
-                "'{arg}' is '{value}'. Please configure appdaemon.yaml".format(arg="url", value=self.url)
-            )
+            self.logger.warning("'{arg}' is '{value}'. Please configure appdaemon.yaml".format(arg="url", value=self.url))
             exit(0)
 
         self._process_arg("transport", http)

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/models/config/plugin.py

@@ -100,7 +100,6 @@ class HASSConfig(PluginConfig):
         BeforeValidator(utils.parse_timedelta)
     ] = Field(default_factory=lambda: timedelta(seconds=10))
     """Default timeout for waiting for responses from the websocket connection"""
-    # return_result: bool | None = None
     suppress_log_messages: bool = False
     retry_secs: int = 5
     services_sleep_time: int = 60

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/models/internal/app_management.py

@@ -71,7 +71,7 @@ class LoadingActions:
         Uses a dependency graph to sort the internal ``init`` and ``reload`` sets together
         """
         items = copy(self.init_set)
-        items |= find_all_dependents(items, dm.app_deps.rev_graph)
+        items |= find_all_dependents(items, dm.app_deps.dep_graph)
         priorities = {
             app_name: dm.app_deps.app_config.root[app_name].priority
             for app_name in items

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/plugins/hass/hassapi.py

@@ -260,7 +260,8 @@ class Hass(ADBase, ADAPI):
         """
         return self.get_state(*args, **kwargs)
 
-    def anyone_home(self, person: bool = True, namespace: str | None = None) -> bool:
+    @utils.sync_decorator
+    async def anyone_home(self, person: bool = True, namespace: str | None = None) -> bool:
         """Determines if the house/apartment is occupied.
 
         A convenience function to determine if one or more person is home. Use
@@ -285,10 +286,11 @@ class Hass(ADBase, ADAPI):
             >>>     do something
 
         """
-        details = self.get_tracker_details(person, namespace, copy=False)
+        details = await self.get_tracker_details(person, namespace, copy=False)
         return any(state['state'] == 'home' for state in details.values())
 
-    def everyone_home(self, person: bool = True, namespace: str | None = None) -> bool:
+    @utils.sync_decorator
+    async def everyone_home(self, person: bool = True, namespace: str | None = None) -> bool:
         """Determine if all family's members at home.
 
         A convenience function to determine if everyone is home. Use this in
@@ -312,10 +314,11 @@ class Hass(ADBase, ADAPI):
             >>>    do something
 
         """
-        details = self.get_tracker_details(person, namespace, copy=False)
+        details = await self.get_tracker_details(person, namespace, copy=False)
         return all(state['state'] == 'home' for state in details.values())
 
-    def noone_home(self, person: bool = True, namespace: str | None = None) -> bool:
+    @utils.sync_decorator
+    async def noone_home(self, person: bool = True, namespace: str | None = None) -> bool:
         """Determines if the house/apartment is empty.
 
         A convenience function to determine if no people are at home. Use this
@@ -340,7 +343,7 @@ class Hass(ADBase, ADAPI):
             >>>     do something
 
         """
-        return not self.anyone_home(person, namespace)
+        return not await self.anyone_home(person, namespace)
 
     #
     # Built-in constraints
@@ -1375,7 +1378,7 @@ class Hass(ADBase, ADAPI):
         except (SyntaxError, ValueError):
             return result
 
-    def _template_command(self, command: str, *args: tuple[str, ...]) -> str | list[str]:
+    def _template_command(self, command: str, *args: str) -> str | list[str]:
         """Internal AppDaemon function to format calling a single template command correctly."""
         if len(args) == 0:
             return self.render_template(f'{{{{ {command}() }}}}')
@@ -1478,6 +1481,10 @@ class Hass(ADBase, ADAPI):
         <https://www.home-assistant.io/docs/configuration/templating/#entities-for-an-integration>`_ for more
         information.
         """
+        entities = self._template_command('integration_entities', integration)
+        assert isinstance(entities, list) and all(isinstance(e, str) for e in entities), \
+            'Invalid return type from integration_entities'
+        return entities
 
     # Labels
     # https://www.home-assistant.io/docs/configuration/templating/#labels

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/plugins/mqtt/mqttapi.py

@@ -229,23 +229,17 @@ class Mqtt(adbase.ADBase, adapi.ADAPI):
         result = self.call_service(service, **kwargs)
         return result
 
-    def _run_service_call(self, task: str, topic: Union[str, list], **kwargs: Optional[Any]) -> None:
+    def _run_service_call(self, task: str, topic: str | list[str], **kwargs: Optional[Any]) -> None:
         """Used to process the subscribe/unsubscribe service calls"""
 
         # first we validate the topic
         if not isinstance(topic, (str, list)):
             raise ValueError(f"The given topic {topic} is not supported. Please only strs and lists are supported")
 
-        if isinstance(topic, str):
-            kwargs["topic"] = topic
-            service = f"mqtt/{task}"
-            self.call_service(service, **kwargs)
+        kwargs["topic"] = topic
+        service = f"mqtt/{task}"
+        return self.call_service(service, **kwargs)
 
-        else:  # its a list
-            for t in topic:
-                kwargs["topic"] = t
-                service = f"mqtt/{task}"
-                self.call_service(service, **kwargs)
 
     def mqtt_subscribe(self, topic: Union[str, list], **kwargs: Optional[Any]) -> None:
         """Subscribes to a MQTT topic.
@@ -284,7 +278,7 @@ class Mqtt(adbase.ADBase, adapi.ADAPI):
 
         """
 
-        self._run_service_call("subscribe", topic, **kwargs)
+        return self._run_service_call("subscribe", topic, **kwargs)
 
     def mqtt_unsubscribe(self, topic: Union[str, list], **kwargs: Optional[Any]) -> None:
         """Unsubscribes from a MQTT topic.
@@ -323,7 +317,7 @@ class Mqtt(adbase.ADBase, adapi.ADAPI):
 
         """
 
-        self._run_service_call("unsubscribe", topic, **kwargs)
+        return self._run_service_call("unsubscribe", topic, **kwargs)
 
     @utils.sync_decorator
     async def is_client_connected(self, **kwargs: Optional[Any]) -> bool:

{appdaemon-4.5.1 → appdaemon-4.5.3}/appdaemon/version.py

@@ -1,2 +1,2 @@
-__version__ = "4.5.1"
+__version__ = "4.5.3"
 __version_comments__ = ""

appdaemon-4.5.3/appdaemon.egg-info/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: appdaemon
+Version: 4.5.3
+Summary: Apps for the Home Assistant home automation package.
+Author-email: Andrew I Cockburn <appdaemon@acockburn.com>
+Project-URL: documentation, https://appdaemon.readthedocs.io
+Project-URL: repository, https://github.com/AppDaemon
+Project-URL: changelog, https://github.com/AppDaemon/appdaemon/blob/master/docs/HISTORY.rst
+Keywords: appdaemon,home,automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Home Automation
+Requires-Python: <3.13,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: importlib-metadata; python_version < "3.8"
+Requires-Dist: aiohttp<3.12.0,>=3.9.0
+Requires-Dist: aiohttp_jinja2<1.7.0,>=1.5.1
+Requires-Dist: astral~=3.2
+Requires-Dist: bcrypt<4.3.0,>=4.0.1
+Requires-Dist: deepdiff==8.2.0
+Requires-Dist: feedparser~=6.0.10
+Requires-Dist: iso8601<2.2,>=1.1
+Requires-Dist: paho-mqtt<2.2.0,>=1.6.1
+Requires-Dist: pid~=3.0.4
+Requires-Dist: python-dateutil<2.10.0,>=2.8.2
+Requires-Dist: python-socketio<5.12,>=5.5
+Requires-Dist: pytz<2025.2.0,>=2022.7.1
+Requires-Dist: pyyaml~=6.0.1
+Requires-Dist: requests<2.33.0,>=2.28.2
+Requires-Dist: sockjs<0.14,>=0.11
+Requires-Dist: uvloop==0.21.0; sys_platform != "win32"
+Requires-Dist: tomli==2.2.1
+Requires-Dist: tomli_w<1.3,>=1.0
+Requires-Dist: pydantic~=2.10.6
+Provides-Extra: dev
+Requires-Dist: pip-tools<7.5.0,>=6.12.3; extra == "dev"
+Requires-Dist: build<1.3,>=0.10; extra == "dev"
+Requires-Dist: flake8~=7.1.1; extra == "dev"
+Requires-Dist: black<25.2,>=23.1; extra == "dev"
+Requires-Dist: pre-commit<3.9.0,>=3.1.1; python_version > "3.7" and extra == "dev"
+Requires-Dist: pytest<8.4.0,>=7.2.1; extra == "dev"
+Requires-Dist: ruff<0.7.0,>=0.0.261; extra == "dev"
+Requires-Dist: codespell>=2.4.1; extra == "dev"
+Provides-Extra: doc
+Requires-Dist: sphinx-autobuild<2024.10.0,>=2021.3.14; extra == "doc"
+Requires-Dist: sphinx-rtd-theme==3.0.2; extra == "doc"
+Requires-Dist: pygments<2.20,>=2.14; extra == "doc"
+Requires-Dist: myst-parser==4.0.0; extra == "doc"
+Dynamic: license-file
+
+# Description
+
+AppDaemon is a loosely coupled, multi-threaded, sandboxed python
+execution environment for writing automation apps for various types of Home Automation Software including [Home
+Assistant](https://home-assistant.io/) and MQTT. It has a pluggable architecture allowing it to be integrated with
+practically any event driven application.
+
+It also provides a configurable dashboard (HADashboard)
+suitable for wall mounted tablets.
+
+## Getting started
+
+For full instructions on installation and usage check out the [AppDaemon Project Documentation](http://appdaemon.readthedocs.io).
+
+## Release Cycle Frequency
+
+AppDaemon has reached a very stable point, works reliably and is fairly feature rich at this point
+in its development. For that reason, releases have been slow in recent months. This does not mean that AppDaemon has been abandoned -
+ it is used every day by the core developers and has an active discord server [here](https://discord.gg/sgSr79jW5x) - please join us for tips
+and tricks, AppDaemon discussions and general home automation.
+
+## Contributing
+
+This is an active open-source project. We are always open to people who want to use the code or contribute to it. Thank you for being involved!
+Have a look at the [official documentation](https://appdaemon.readthedocs.io/en/latest/DEV.html) for more information.