Feature/improve package install (#203)

* need to work with strings, not posixpath

* try to slim down and improve requirements/deps process

* separate app dir and project dir

* set log level in __main__

* improve docker docs

* replace em dashes with dashes

* additional docs cleanup

* remove value converters doc, will re-add when i have time to make a good one that i trust

* update changelog, fix links to not use ./

Author: NodeJSmith

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [0.18.1] - 2025-12-13
+
+### Changed
+- Improve docker startup script and dependency handling
+- Rewrite docker docs to be more clear about project structure and dependency installation
+
+### Fixed
+- Fixed a bug in autodetect apps exclusion directories
+  - Previous commit had mapped the exclusion dirs to Path objects, which broke the set comparison, this has been reverted
+
 ## [0.18.0.dev3] - 2025-12-13
 
 ### Changed

Dockerfile

@@ -35,6 +35,7 @@ RUN apt-get update \
     curl \
     tini \
     tzdata \
+    fd-find \
     && rm -rf /var/lib/apt/lists/*
 
 WORKDIR /app

docs/_static/style.css

@@ -5,28 +5,36 @@
 
 /* Match link-in-code color to normal code-literal red */
 .rst-content a.reference code.literal {
-  color: #e74c3c !important; /* tweak to taste */
-  text-decoration: underline; /* optional — helps signal it's clickable */
+    color: #e74c3c !important;
+    /* tweak to taste */
+    text-decoration: underline;
+    /* optional - helps signal it's clickable */
 }
 
 /* Optional hover state: slightly darker red for clarity */
 .rst-content a.reference:hover code.literal {
-  color: #a60000 !important; /* tweak to taste */
+    color: #a60000 !important;
+    /* tweak to taste */
 }
 
 
 /* Center it, make it responsive, trim vertical whitespace */
 .rst-content img.hero {
-  display: block;                 /* make margin auto work */
-  margin: 2rem auto 2rem !important;  /* top/bottom tighter, centered */
-  padding: 0 !important;
-  max-width: 420px;               /* cap huge screens */
-  height: auto;
-  filter: drop-shadow(0 20px 20px rgba(0, 0, 0, 0.15));
+    display: block;
+    /* make margin auto work */
+    margin: 2rem auto 2rem !important;
+    /* top/bottom tighter, centered */
+    padding: 0 !important;
+    max-width: 420px;
+    /* cap huge screens */
+    height: auto;
+    filter: drop-shadow(0 20px 20px rgba(0, 0, 0, 0.15));
 
 }
 
 /* On very small screens, widen a bit */
 @media (max-width: 480px) {
-  .rst-content img.hero { width: 80%; }
+    .rst-content img.hero {
+        width: 80%;
+    }
 }

docs/index.md

@@ -47,7 +47,7 @@ Get running with Hassette in just a few steps.
 Ready to build something more complex? Explore the rest of the docs:
 
 - Follow the [getting started guide](pages/getting-started/index.md) for local development.
-- Deploy with [Docker Compose](pages/getting-started/docker.md) for production.
+- Deploy with [Docker Compose](pages/getting-started/docker/index.md) for production.
 - Dive into [core app patterns](pages/core-concepts/apps/index.md).
 - See how Hassette stacks up in the [AppDaemon comparison](pages/appdaemon-comparison.md).
 - Dive into the [advanced concepts](pages/advanced/index.md).

docs/pages/advanced/dependency-injection.md

@@ -361,7 +361,6 @@ The TypeRegistry provides comprehensive built-in conversions for common types:
 - **Numeric types**: `str` ↔ `int`, `float`, `Decimal`
 - **Boolean**: `str` → `bool` (handles `"on"`, `"off"`, `"true"`, `"false"`, etc.)
 - **DateTime types**: `str` → `datetime`, `date`, `time` (stdlib), and `whenever` types
-- **And more**: See [Value Converters Reference](value-converters.md)
 
 **Examples:**
 ```python
@@ -518,6 +517,5 @@ The core implementation lives in:
 
 ## See Also
 
-- [Type Registry](type-registry.md) — automatic type conversion system
-- [Value Converters](value-converters.md) — complete list of built-in type conversions
-- [State Registry](state-registry.md) — domain to state model mapping
+- [Type Registry](type-registry.md) - automatic type conversion system
+- [State Registry](state-registry.md) - domain to state model mapping

docs/pages/advanced/index.md

@@ -4,10 +4,10 @@ Hassette does a lot under the hood to make building Home Assistant automations e
 
 These features are:
 
-- Dependency injection
-- Custom states
-- The State Registry
-- The Type Registry
+- [Dependency injection](dependency-injection.md)
+- [Custom states](custom-states.md)
+- [The State Registry](state-registry.md)
+- [The Type Registry](type-registry.md)
 
 ## Dependency Injection
 
@@ -19,7 +19,7 @@ For example, `StateNew` is a built-in provider that extracts the new state from
 
 This is as simple as using the [`Annotated`][typing.Annotated] type hint to specify a type and an extractor. Hassette does have an [accessor][hassette.event_handling.accessors] module that has built-in extractors, so for this example you could use `get_state_attr_new`. Combining these tools allows you to create powerful, reusable DI providers for your specific needs.
 
-Read more in the [Dependency Injection guide][pages/advanced/dependency-injection.md].
+Read more in the [Dependency Injection guide](dependency-injection.md).
 
 ## Custom States
 
@@ -30,7 +30,7 @@ Home Assistant has many built in states, but many many more states that come fro
 Custom states can be defined as simply as creating a new State class from [`BaseState`][hassette.models.states.base.BaseState] or one if it's subclasses. `BaseState`
 uses `__init_subclass__` to automatically register the class with the [State Registry][hassette.core.state_registry.StateRegistry] based on its `domain` attribute. This means that once you have defined the class, it will be used automatically whenever a state with the matching domain is encountered in your automations.
 
-There is a dedicated [Custom States guide][pages/advanced/custom-states.md] that goes into more detail on how to define and use custom states in your Hassette apps.
+There is a dedicated [Custom States guide](custom-states.md) that goes into more detail on how to define and use custom states in your Hassette apps.
 
 ## Registries
 
@@ -42,7 +42,7 @@ The State Registry contains a map of state domain names to their corresponding S
 
 The State Registry generally does not need to be interacted with directly, as the `__init_subclass__` hook automatically registers new State classes when they are defined.
 
-You can read more about the State Registry in the [State Registry guide][pages/advanced/state-registry.md].
+You can read more about the State Registry in the [State Registry guide](state-registry.md).
 
 ### Type Registry
 
@@ -51,4 +51,4 @@ The Type Registry contains a map of custom types to their corresponding type con
 The `TypeRegistry` allows for manually registering new type converters, giving you full control over how custom types are handled in your automations. You can also
 access the registry directly if needed, which can allow you to convert between types without having to rewrite your type conversion logic.
 
-You can read more about the Type Registry in the [Type Registry guide][pages/advanced/type-registry.md].
+You can read more about the Type Registry in the [Type Registry guide](type-registry.md).

docs/pages/advanced/state-registry.md

@@ -374,7 +374,6 @@ state = convert_state_dict_to_model(
 
 ## See Also
 
-- [Type Registry](type-registry.md) — automatic value type conversion
-- [Dependency Injection](dependency-injection.md) — using StateRegistry via DI annotations
-- [Custom States](custom-states.md) — defining your own state classes
-- [Value Converters](value-converters.md) — complete list of built-in type conversions
+- [Type Registry](type-registry.md) - automatic value type conversion
+- [Dependency Injection](dependency-injection.md) - using StateRegistry via DI annotations
+- [Custom States](custom-states.md) - defining your own state classes

docs/pages/advanced/type-registry.md

@@ -529,4 +529,3 @@ def str_with_units_to_float(value: str) -> float:
 - [State Registry](state-registry.md) - Domain to model class mapping
 - [Dependency Injection](dependency-injection.md) - Using TypeRegistry with custom extractors
 - [State Models](../core-concepts/states/index.md) - State model reference
-- [Value Converters](value-converters.md) - Complete list of built-in converters