Add include-optional directive.

- Add ``include-optional`` for INI configuration files that may be
  absent, skipping missing local files and HTTP 404 responses while
  preserving mandatory includes. This allows projects to define an
  optional include for client-specific customizations.

- Fix HTTP error logging during INI inclusion and preserve the original
  exception.

- Fix relative INI includes from URLs with a directory path.

Co-authored-by: Codex <noreply@openai.com>

Author: thet

CHANGES.md

@@ -1,9 +1,15 @@
 ## Changes
- 
+
 ## 5.4.2 (unreleased)
 
 <!-- Add future changes here -->
 
+- Add `include-optional` for INI configuration files that may be absent, skipping
+  missing local files and HTTP 404 responses while preserving mandatory includes.
+  This allows projects to define an optional include for client-specific
+  customizations.
+- Fix HTTP error logging during INI inclusion and preserve the original exception.
+- Fix relative INI includes from URLs with a directory path.
 
 ## 5.4.1 (2026-08-04)
 
@@ -12,7 +18,6 @@
   now rejects the trailing newline and the error was silently swallowed. Lines are
   now stripped before parsing and unparseable lines are logged at debug level. [jensens]
 
-
 ## 5.4.0 (2026-06-01)
 
 - The uv hook now writes the fully resolved constraints (including external `-c`/`-r`
@@ -35,7 +40,6 @@
   directory already exists under the sources directory and does not fetch, copy, or symlink
   anything (refs #76). [jensens]
 
-
 ## 5.3.2 (2026-05-30)
 
 - Fix: Restore backward compatibility for hook config sections named
@@ -48,7 +52,6 @@
   Migration: rename `[ns-section]` to `[ns:section]` and set `namespace = "ns"`.
   [jensens]
 
-
 ## 5.3.1 (2026-05-29)
 
 - Fix: A hook namespace no longer swallows packages whose name merely starts with it.
@@ -59,13 +62,11 @@
   the `[namespace-section]` form as a deprecation rather than a hard break — see below.)
   [jensens]
 
-
 ## 5.3.0 (2026-05-29)
 
 - Feature: The `uv` hook now also propagates `version-overrides` from `mx.ini` to `[tool.uv] override-dependencies` in `pyproject.toml`. This keeps version pins in sync between mxdev and uv-managed projects.
   [frapell]
 
-
 ## 5.2.0 (2026-05-28)
 
 - Feature: Built-in integration with `uv` through `pyproject.toml`. When `mxdev` is run, it checks if the project has a `pyproject.toml` containing `[tool.uv]` with `managed = true`. If so, mxdev automatically adds checked-out packages to `[tool.uv.sources]`. This allows for seamless use of `uv sync` or `uv run` with local checkouts. `tomlkit` is now an optional dependency (install with `mxdev[uv]`) to preserve `pyproject.toml` formatting during updates.
@@ -138,10 +139,9 @@
 - Enhance test coverage [jensens]
 - Fix Makefile. [jensens]
 
-
 ## 4.1.0 (2025-06-03)
 
-- Support environment variable `GIT_CLONE_DEPTH` for setting a default git depth for all checkouts.  Useful for CI.
+- Support environment variable `GIT_CLONE_DEPTH` for setting a default git depth for all checkouts. Useful for CI.
   [maurits]
 
 - Fix #47: Do not add packages with capital names uncommented at the bottom ignore list when checked out.
@@ -152,7 +152,6 @@
 - Fix #45: Packages with capital names do not get ignored when checked out.
   [jensens]
 
-
 ## 4.0.2 (2024-03-13)
 
 - Fix #42: deprecated use of `pkg_resoures` to load entry points and parse requirements.
@@ -216,7 +215,6 @@
   When false, the source is not checked out, and the version for this package is not overridden.
   [maurits]
 
-
 ### 3.0.0b1 (2022-11-21)
 
 - Do not use `libvcs`, but recycled and updated (type hints, tests) `mr.developer` VCS code.
@@ -247,7 +245,6 @@
   State object contains all required runtime data.
   [rnix]
 
-
 ### 2.0.0 (2022-01-31)
 
 - Depend on pip 22, where interdependency mode is no longer needed.
@@ -269,39 +266,33 @@
   New setting `ignores` with a list of packages (one per line) to ignore constraints without providing a version.
   [jensens]
 
-
 ### 1.0.1 (2021-12-21)
 
-- Fix: If a developed package depends on another developed package the dependent package was ignored *sometimes* (!?).
+- Fix: If a developed package depends on another developed package the dependent package was ignored _sometimes_ (!?).
   Instead, the last release was taken.
-  Solution: Install it with the `--pre` option in order to allow the other non-final/in-development *release*.
+  Solution: Install it with the `--pre` option in order to allow the other non-final/in-development _release_.
   [jensens]
 
-
 ### 1.0.0 (2021-12-12)
 
 - Defaults for "outfiles" are `*-mxdev.txt` now.
   [jensens]
 
-
 ### 1.0.0b4 (2021-12-07)
 
 - Fix interdependency mode.
   [jensens]
 
-
 ### 1.0.0b3 (2021-12-07)
 
 - Fix: Do not apply override disabling on requirements.
   [jensens]
 
-
 ### 1.0.0b2 (2021-12-07)
 
 - Add feature: version overrides.
   [jensens]
 
-
 ### 1.0.0b1 (2021-12-04)
 
 - Add `-s` or `--silent` option.
@@ -313,13 +304,11 @@
 - Fixed missing CR if `*.txt` does not end with a newline.
   [jensens]
 
-
 ### 1.0.0a9 (2021-12-01)
 
 - Added auto correction for pip URLs, so that GitHub or GitLab URLs can be used as copied in `sources.ini`.
   [zworkb]
 
-
 ### 1.0.0a8 (2021-11-30)
 
 - Added interdependency handling to avoid manual dependency order resolution.
@@ -331,37 +320,31 @@
 - Removed position feature.
   [jensens, gogobd]
 
-
 ### 1.0.0a7 (2021-11-30)
 
 - Removed Workaround for libvcs and depend on libvcs>=0.10.1.
   [jensens]
 
-
 ### 1.0.0a6 (2021-11-30)
 
 - Workaround for libvcs bug https://github.com/vcs-python/libvcs/issues/295
   [jensens, gogobd]
 
-
 ### 1.0.0a5 (2021-11-30)
 
 - Workaround for libvcs bug https://github.com/vcs-python/libvcs/issues/293
   [jensens, gogobd]
 
-
 ### 1.0.0a4 (2021-11-29)
 
 - Fix: editable can be configured to be processed before or after initial requirements.
   [jensens]
 
-
 ### 1.0.0a3 (2021-11-23)
 
 - Fix #1: Re-run of pip vanishes committed changes
   [jensens]
 
-
 ### 1.0.0a2 (2021-11-21)
 
 - Fix/simplify packaging.
@@ -373,7 +356,6 @@
 - Implement package extras
   [jensens]
 
-
 ### 1.0.0a1 (2021-11-21)
 
 - Initial work.