chore: update dependencies and changelog for version 4.12.0

Author: HosseinNejatiJavaremi

docs/community/changelog/4/4.11.1.md

@@ -5,7 +5,7 @@ description: "Release notes for ArchiPy 4.11.1"
 
 # 4.11.1 — 2026-06-18
 
-[← 4.11.0](4.11.0.md) | [↑ 4.x series](index.md)
+[← 4.12.0](4.12.0.md) | [4.11.0 →](4.11.0.md) | [↑ 4.x series](index.md)
 
 ## Fixed
 

docs/community/changelog/4/4.12.0.md

@@ -0,0 +1,68 @@
+---
+title: "Changelog 4.12.0"
+description: "Release notes for ArchiPy 4.12.0"
+---
+
+# 4.12.0 — 2026-06-20
+
+[← 4.11.1](4.11.1.md) | [↑ 4.x series](index.md)
+
+## Added
+
+### Adapters - MinIO
+
+- **Object Existence Check** - Added `object_exists` to `MinioPort` and `MinioAdapter` for lightweight presence checks without downloading object content.
+    - Returns `True` when the object key exists and `False` when it does not.
+    - Cached for five minutes via `@ttl_cache_decorator` to reduce repeated HEAD requests.
+- **Batch Object Deletion** - Added `remove_objects` for deleting multiple object keys in a single S3 `DeleteObjects` call.
+    - Clears object-related caches after a successful batch delete.
+- **Object Tag Operations** - Added tag management methods for per-object metadata used with lifecycle-based expiration.
+    - `set_object_tags` replaces all tags on an existing object.
+    - `get_object_tags` returns the current tag mapping (empty dict when none are set).
+    - `remove_object_tags` clears all tags from an object.
+- **Upload-Time Tags** - Extended `put_object` and `put_object_stream` with an optional `tags: dict[str, str] | None` parameter so tags can be applied at upload time.
+- **Bucket Lifecycle / TTL** - Added lifecycle configuration methods for automatic object expiration.
+    - `set_bucket_lifecycle` accepts S3-format lifecycle rule dicts (`MinioLifecycleRuleType`).
+    - `get_bucket_lifecycle` returns configured rules or an empty list when none are set.
+    - `delete_bucket_lifecycle` removes all lifecycle rules from a bucket.
+- **Object Versioning** - Added bucket versioning and version-level delete support.
+    - `set_bucket_versioning` enables or suspends versioning on a bucket.
+    - `get_bucket_versioning` returns `Enabled`, `Suspended`, or an empty string when never configured.
+    - `list_object_versions` lists version entries and delete markers with normalized metadata (`MinioObjectVersionType`).
+    - `remove_object_version` permanently deletes a specific version by `version_id`.
+
+## Changed
+
+### Adapters - StarRocks
+
+- **Type Ignore Cleanup** - Removed redundant `# type: ignore[invalid-assignment]` comments from StarRocks SQLAlchemy compiler patches, keeping only the `ty: ignore` directives.
+
+### Documentation - MinIO
+
+- **Tutorial Expansion** - Extended `docs/tutorials/adapters/minio.md` with examples for object existence checks, batch deletion, object tags, and versioning workflows.
+- **API Reference Clarification** - Updated the MinIO adapter API reference to state that the concrete adapter wraps **boto3** for S3-compatible storage.
+
+## Tests
+
+### Tests - MinIO Adapter
+
+- **Tag Scenarios** - Added BDD coverage for upload-time tags, setting tags on existing objects, and removing all tags.
+- **Lifecycle Scenarios** - Added scenarios for setting, verifying, and deleting bucket lifecycle rules.
+- **Existence and Batch Delete** - Added scenarios for `object_exists` before and after deletion, and for `remove_objects` batch cleanup.
+- **Versioning Scenarios** - Added end-to-end coverage for enabling versioning, uploading multiple versions, listing versions, and permanently deleting the oldest version.
+
+## Dependencies
+
+- **Core dependencies** - Updated base package pins in `pyproject.toml`.
+    - `pydantic-settings`: `>=2.14.1` → `>=2.14.2`
+- **Optional extras** - Updated optional adapter dependency pins.
+    - `dependency-injection`: `dependency-injector>=4.49.0` → `>=4.49.1`
+    - `minio`: `boto3>=1.43.32` → `>=1.43.34`
+    - `parsian-ipg` / `parsian-ipg-async`: `zeep>=4.3.2` → `>=4.3.3`
+- **Dev group** - Updated development tooling pins.
+    - `boto3-stubs`: `>=1.43.32` → `>=1.43.34`
+    - `ruff`: `>=0.15.17` → `>=0.15.18`
+    - `ty`: `>=0.0.50` → `>=0.0.51`
+- **Docs group** - Updated documentation tooling pins.
+    - `mkdocstrings-python`: `>=2.0.4` → `>=2.0.5`
+- **Lockfile** - Regenerated `uv.lock` to align with the updated `pyproject.toml` constraints.

docs/community/changelog/4/index.md

@@ -9,6 +9,7 @@ description: "Release history for ArchiPy 4.x series"
 
 | Version             | Date       | Summary                                                                                         |
 |---------------------|------------|-------------------------------------------------------------------------------------------------|
+| [4.12.0](4.12.0.md) | 2026-06-20 | MinIO TTL/lifecycle, object tags, batch deletion, existence checks, and versioning support      |
 | [4.11.1](4.11.1.md) | 2026-06-18 | FastAPI compatibility pin to <0.137, removed parallel behave settings, docs alignment           |
 | [4.11.0](4.11.0.md) | 2026-06-18 | MinIO stream upload/download APIs, IPG DTO extraction, and FastAPI large-file upload tests      |
 | [4.10.2](4.10.2.md) | 2026-06-15 | httpx2 HTTP client migration, gRPC/app-utils fixes, and dependency updates                      |

docs/community/changelog/index.md

@@ -9,7 +9,7 @@ All notable changes to ArchiPy are documented here, organized by major version s
 
 ## [4.x Series](4/index.md)
 
-31 releases — from 4.0.0 to 4.11.1
+32 releases — from 4.0.0 to 4.12.0
 
 ## [3.x Series](3/index.md)
 

pyproject.toml

@@ -10,7 +10,7 @@ version = "0.1.0" # This vesrion set on publish flow!
 requires-python = ">=3.14,<4"
 dependencies = [
     "pydantic>=2.13.4",
-    "pydantic-settings>=2.14.1",
+    "pydantic-settings>=2.14.2",
     "requests>=2.34.2",
     "jdatetime>=5.3.0",
 ]
@@ -21,7 +21,7 @@ license = { file = "LICENSE" }
 aiosqlite = ["aiosqlite>=0.22.1"]
 behave = ["behave>=1.3.3"]
 cache = ["cachetools>=7.1.4", "async-lru>=2.3.0"]
-dependency-injection = ["dependency-injector>=4.49.0"]
+dependency-injection = ["dependency-injector>=4.49.1"]
 elastic-apm = ["elastic-apm>=6.26.1"]
 elasticsearch = ["elasticsearch>=9.4.1"]
 elasticsearch-async = ["elasticsearch[async]>=9.4.1"]
@@ -31,9 +31,9 @@ grpc = ["grpcio>=1.81.1", "grpcio-health-checking>=1.81.1", "protobuf>=6.33.6"]
 jwt = ["pyjwt>=2.13.0"]
 kafka = ["confluent-kafka>=2.14.2"]
 keycloak = ["python-keycloak>=7.1.1", "cachetools>=7.1.4", "async-lru>=2.3.0"]
-minio = ["boto3>=1.43.32", "cachetools>=7.1.4", "async-lru>=2.3.0"]
-parsian-ipg = ["zeep>=4.3.2", "requests[socks]>=2.34.2"]
-parsian-ipg-async = ["zeep[async]>=4.3.2", "httpx2[socks]>=2.4.0"]
+minio = ["boto3>=1.43.34", "cachetools>=7.1.4", "async-lru>=2.3.0"]
+parsian-ipg = ["zeep>=4.3.3", "requests[socks]>=2.34.2"]
+parsian-ipg-async = ["zeep[async]>=4.3.3", "httpx2[socks]>=2.4.0"]
 postgres = ["psycopg[binary,pool]>=3.3.4"]
 prometheus = ["prometheus-client>=0.25.0"]
 redis = ["redis[hiredis]>=8.0.0"]
@@ -56,12 +56,12 @@ build-backend = "hatchling.build"
 dev = [
     "add-trailing-comma>=4.0.0",
     "bandit>=1.9.4",
-    "boto3-stubs>=1.43.32",
+    "boto3-stubs>=1.43.34",
     "codespell>=2.4.2",
     "pre-commit-hooks>=6.0.0",
     "pre-commit>=4.6.0",
-    "ruff>=0.15.17",
-    "ty>=0.0.50",
+    "ruff>=0.15.18",
+    "ty>=0.0.51",
     "types-cachetools>=7.0.0.20260518",
     "types-grpcio>=1.0.0.20260614",
     "types-protobuf>=7.34.1.20260518",
@@ -75,7 +75,7 @@ docs = [
     "mkdocs-autorefs>=1.4.4",
     "mkdocs-material>=9.7.6",
     "mkdocs>=1.6.1",
-    "mkdocstrings-python>=2.0.4",
+    "mkdocstrings-python>=2.0.5",
     "mkdocstrings>=1.0.4",
     "pymdown-extensions>=10.21.3",
 ]