Introduce versioning: All models moved from maloident ➡️ maloident.v1 (#25)

Author: hf-kklein

README.md

@@ -25,7 +25,8 @@ pip install maloident
 Then use it:
 
 ```python
-from maloident.models import ResultNegative
+from maloident.v1.models import ResultNegative
+
 my_json = {
     "decisionTree": "E_0594",
     "responseCode": "A10",
@@ -42,10 +43,10 @@ See the [tests](unittests/test_models.py) for more examples.
 ## Project Structure
 
 This project is based on [`datamodel-code-generator`](https://github.com/koxudaxi/datamodel-code-generator/).
-Most of the classes are autogenerated from the [`openapi.yml`](openapi/openapi.yml) which can be found on [SwaggerHub](https://app.swaggerhub.com/apis/edi-energy/MaLoIdent_2024-07-03/v1.0.0).
+Most of the classes are autogenerated from the [`openapi.yml`](openapi/v1/openapi.yml) which can be found on [SwaggerHub](https://app.swaggerhub.com/apis/edi-energy/MaLoIdent_2024-07-03/v1.0.0).
 
 Note that we fixed some errors in the official OpenAPI spec.
-Our changes are mentioned at the beginning of the [`openapi.yml`](openapi/openapi.yml) file.
+Our changes are mentioned at the beginning of the [`openapi.yml`](openapi/v1/openapi.yml) file.
 
 https://github.com/Hochfrequenz/malo-ident-python-models/blob/3cfe0aea3cff051303ef5e513d06ab6c5741f21a/openapi/openapi.yml#L4-L10
 

openapi/openapi.yml openapi/v1/openapi.yml

@@ -75,7 +75,7 @@ truethy-bool = true
 disable_error_code = []
 
 [[tool.mypy.overrides]]
-module = "maloident._autogenerated"
+module = "maloident.v1._autogenerated"
 ignore_errors = true
 
 

pyproject.toml

@@ -0,0 +1,5 @@
+"""
+v1 contains the models of the v1 API.
+This allows us to maintain different versions of the models (for different API versions)
+in the same python/pip package/repository.
+"""

src/maloident/v1/__init__.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.yml
-#   timestamp: 2024-10-02T11:57:20+00:00
+#   timestamp: 2024-10-02T12:07:18+00:00
 
 from __future__ import annotations
 

src/maloident/_autogenerated.py src/maloident/v1/_autogenerated.py

@@ -75,9 +75,9 @@ deps =
     .[formatting]
     .[codegen]
 commands =
-    datamodel-codegen --encoding utf-8 --input openapi/openapi.yml --output src/maloident/_autogenerated.py --input-file-type openapi --output-model-type pydantic_v2.BaseModel
-    black src/maloident/_autogenerated.py
-    isort src/maloident/_autogenerated.py
+    datamodel-codegen --encoding utf-8 --input openapi/v1/openapi.yml --output src/maloident/v1/_autogenerated.py --input-file-type openapi --output-model-type pydantic_v2.BaseModel
+    black src/maloident/v1/_autogenerated.py
+    isort src/maloident/v1/_autogenerated.py
 
 [testenv:dev]
 # the dev environment contains everything you need to start developing on your local machine.

src/maloident/models.py src/maloident/v1/models.py

@@ -2,9 +2,9 @@
 
 import pytest
 
-from maloident.models import IdentificationParameter, ResultNegative, ResultPositive
+from maloident.v1.models import IdentificationParameter, ResultNegative, ResultPositive
 
-from .example_jsons import negative_response_body, positive_response_body, request_body
+from .example_jsons_v1 import negative_response_body, positive_response_body, request_body
 
 
 @pytest.mark.parametrize(