feat(DEVC-1282): migrate SDK to v2 (#110)

* feat: remove redis ping
* feat(DEVC-265): add py-typed file & update pyproject.toml accordingly
* feat(DEVC-265): ensure that lint passed; bump mypy version from mypy==0.950 -> mypy>=1.10,<2
* feat(DEVC-265): move mypy CLI args into single place - pyproject.toml file
* feat(DEVC-265): remove exclude block at mypy settings for skipping some docs/modules tutorials
* feat(DEVC-265): optimise mypy config
* feat(DEVC-1282): migrate SDK code to pydantic V2
* feat(DEVC-1282): migrate tests to pydantic v2 as well; add some fixes
* feat(DEVC-1282): improve type annotations; refactor RerunTimeRange class validators at to simplify
* feat(DEVC-1282): fix annotations for `model_validator` with mode="before"
* feat(DEVC-1282): set new minor version
* feat(DEVC-1286): Revamp redis usage (#111)

- upgrade redis version for test server
- bump bunch of related third party dependencies:
  - fakeredis[lua] -> removed prefix LUA
  - redis == 6.2.0 latest supported with Python3.9+
  - types-redis~=4.6.0
- removed:
  - all LUA bindings from RedisRepository
  - use_lua_52
  - vacuum(...) and dependant codes
  - InternalCacheSdkProtocol
  - InternalRedisSdk
  - FakeInternalCacheSdk
  - DeprecatedRedisAdapter
- Add migration logic

Author: kossman

CHANGELOG.md

@@ -6,6 +6,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.0] - 2025-09-11
+### Changed
+- Full migration from old `v1`of `pydantic` to `v2`dependencies:
+  - `pydantic` itself: `"pydantic >= 2.0, <3.0"`
+  - `pydantic-settings`: `"pydantic-settings >=2.0, <3.0"`
+- Revamp Redis, get rid of LUA scripts at all
+- Add `py.typed` for type checking
+- Upgrading a bunch of dependencies
+
+
 ## [1.15.0] - 2025-09-04
 ### Security
 - Upgraded internal dependency `urllib3` to version `2.5.0`

Makefile

@@ -58,7 +58,7 @@ coverage-html: test
 .PHONY: lint
 lint:
 	@ruff check $(srcs)
-	@mypy --check-untyped-defs $(srcs)
+	@mypy $(srcs)
 
 ## format: Format all files.
 .PHONY: format
@@ -112,7 +112,7 @@ up-cache:
 	-d \
 	--name python-sdk-redis \
 	-p 6379:6379 \
-	redis:6.0.9  # apps use 6.0.9 or 6.2.3
+	redis:7.4.0
 
 # down-cache: Stop Redis.
 .PHONY: down-cache

docs/antora-playbook.yml

@@ -7,7 +7,7 @@ content:
       start_path: docs
       branches: []
 #      branches: HEAD  # Use this for local development
-      tags: [v1.15.0]
+      tags: [v2.0.0]
 asciidoc:
   attributes:
     page-toclevels: 5

docs/modules/ROOT/examples/cache/tutorial002.py

@@ -5,9 +5,11 @@
 
 @scheduled
 def scheduled_app(event: ScheduledDataTimeEvent, api: Api, cache: Cache):
-    cache.set(key='key', value='value', ttl=1)  # <.>
+    ttl_value = 1
+    cache.set(key='key', value='value', ttl=ttl_value)  # <.>
+
     assert cache.get('key') == 'value'
 
-    time.sleep(1)  # <.>
+    time.sleep(ttl_value + 0.01)  # <.>
 
     assert cache.get('key') is None  # <.>

docs/modules/ROOT/examples/cache/tutorial006.py

@@ -26,6 +26,6 @@ def scheduled_app(event: ScheduledDataTimeEvent, api: Api, cache: Cache):
         'key_with_custom_expiry': 'value_2',
     }
 
-    time.sleep(1)  # <.>
+    time.sleep(1 + 0.01)  # <.>
 
     assert cache.get_all() == {'key': 'value_1'}  # <.>

docs/modules/ROOT/pages/index.adoc

@@ -281,11 +281,6 @@ It will try to re-send the same request again with exponential back-off for HTTP
 * 503
 * 504
 
-[source,python]
-----
-include::example$api/tutorial008.py[]
-----
-
 [#cache]
 == Cache
 Apps might need to share some data between invokes.

pyproject.toml

@@ -6,19 +6,21 @@ build-backend = "setuptools.build_meta"
 name = "corva-sdk"
 description = "SDK for building Corva DevCenter Python apps."
 readme = "README.md"
-version = "1.15.0"
+version = "2.0.0"
 license = { text = "The Unlicense" }
 authors = [
   { name = "Jordan Ambra", email = "jordan.ambra@corva.ai" }
 ]
 keywords = ["corva", "sdk"]
 requires-python = ">=3.9,<4.0"
 dependencies = [
-  "fakeredis[lua] >=2.26.2, <2.30.0",
-  "pydantic >=1.8.2, <2.0.0",
-  "redis >=5.2.1, <6.0.0",
+  "fakeredis >=2.30.0, <2.32.0",
+  "pydantic >= 2.0, <3.0",
+  "pydantic-settings >=2.0, <3.0",
+  "redis == 6.4.0",
   "requests >=2.32.3, <3.0.0",
-  "urllib3==2.5.0"
+  "urllib3 == 2.5.0",
+  "semver==3.0.4"
 ]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
@@ -27,7 +29,8 @@ classifiers = [
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.9",
-  "Topic :: Software Development :: Libraries"
+  "Topic :: Software Development :: Libraries",
+  "Typing :: Typed"
 ]
 
 [project.urls]
@@ -36,9 +39,9 @@ Homepage = "https://github.com/corva-ai/python-sdk"
 [project.optional-dependencies]
 dev = [
   "ruff==0.12.11",
-  "mypy==0.950",
+  "mypy>=1.10,<2",
   "types-freezegun~=1.1.9",
-  "types-redis~=4.2.4",
+  "types-redis~=4.6.0",
   "types-requests~=2.27.27",
   "coverage==7.6.1",
   "freezegun==1.5.1",
@@ -48,10 +51,14 @@ dev = [
 ]
 
 [tool.setuptools]
+include-package-data = true
 package-dir = { "" = "src" }
 packages = { find = { where = ["src"] } }
 py-modules = ["plugin"]
 
+[tool.setuptools.package-data]
+corva = ["py.typed"]
+
 [project.entry-points."pytest11"]
 corva = "plugin"
 
@@ -82,24 +89,26 @@ omit = [
   "docs/modules/ROOT/examples/logging/tutorial003.py",
   "docs/modules/ROOT/examples/logging/tutorial004.py",
   "docs/modules/ROOT/examples/logging/tutorial005.py",
+  "docs/modules/ROOT/examples/testing/tutorial008.py",
   "docs/modules/ROOT/examples/followable/tutorial001.py",
   "src/corva/__init__.py",
   "src/version.py",
   "src/plugin.py"
 ]
 
 [tool.mypy]
-exclude = '''(?x)(
-    ^docs/modules/ROOT/examples/cache/tutorial004\.py$
-    | ^docs/modules/ROOT/examples/cache/tutorial005\.py$
-)'''
+python_version = "3.9"
+mypy_path = "src"
+explicit_package_bases = true
+check_untyped_defs = true
 
 [[tool.mypy.overrides]]
 module = "setuptools.*"
 ignore_missing_imports = true
 
 [[tool.mypy.overrides]]
 module = "docs.*"
+ignore_errors = true
 ignore_missing_imports = true
 
 [[tool.mypy.overrides]]
@@ -122,3 +131,6 @@ ignore_missing_imports = true
 module = "fakeredis.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "tests.*"
+ignore_errors = true