Merge pull request #150 from python-odin/development

Release 2.8

Author: timsavage

.github/workflows/tests.yml

@@ -14,7 +14,7 @@ jobs:
         python-version: [3.8, 3.9, "3.10", "3.11"]
         experimental: [false]
         include:
-          - python-version: "3.11-dev"
+          - python-version: "3.12-dev"
             experimental: true
 
     steps:

.pre-commit-config.yaml

@@ -0,0 +1,44 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+default_language_version:
+    python: python3.10
+repos:
+#-   repo: https://github.com/pre-commit/pre-commit-hooks
+#    rev: v4.4.0
+#    hooks:
+#    -   id: check-added-large-files
+#    -   id: check-toml
+#    -   id: check-yaml
+#        args:
+#        -   --unsafe
+#    -   id: end-of-file-fixer
+#    -   id: trailing-whitespace
+-   repo: https://github.com/asottile/pyupgrade
+    rev: v3.3.1
+    hooks:
+    -   id: pyupgrade
+        args:
+        - --py38-plus
+        - --keep-runtime-typing
+-   repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.0.270
+    hooks:
+    -   id: ruff
+        args:
+        - --fix
+        - --exit-non-zero-on-fix
+-   repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+    -   id: isort
+        name: isort (python)
+    -   id: isort
+        name: isort (cython)
+        types: [cython]
+    -   id: isort
+        name: isort (pyi)
+        types: [pyi]
+-   repo: https://github.com/psf/black
+    rev: 23.1.0
+    hooks:
+    -   id: black

HISTORY

@@ -1,3 +1,27 @@
+2.8
+===
+
+Changes
+-------
+
+- Change behaviour of create_resource_from_dict to not raise Validation errors
+  from ``field.to_python`` when ``full_clean`` is ``False``.
+
+  Allows for invalid documents to still be loaded with invalid data to allow
+  for correction of data and to prevent data loss.
+
+- Introduce Pre-commit, PyUpgrade, isort, ruff and black.
+
+
+2.7
+===
+
+Bug fixes
+---------
+
+- TypedDictField now includes a prepare method to ensure types are cast correctly for serailisation.
+
+
 2.6
 ===
 

docs/conf.py

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 #
 # Odin documentation build configuration file, created by
 # sphinx-quickstart on Tue Aug 20 18:57:24 2013.
@@ -11,8 +10,8 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import sys
 import os
+import sys
 
 HERE = os.path.dirname(__file__)
 
@@ -53,8 +52,8 @@
 master_doc = "contents"
 
 # General information about the project.
-project = u"Odin"
-copyright = u"2023, Tim Savage"
+project = "Odin"
+copyright = "2023, Tim Savage"
 author = "Tim Savage <tim@savage.company>"
 
 # The version info for the project you're documenting, acts as replacement for
@@ -205,8 +204,8 @@
     (
         "index",
         "Odin.tex",
-        u"Odin Documentation",
-        u"Tim Savage \\textless{}tim@savage.company\\textgreater{}",
+        "Odin Documentation",
+        "Tim Savage \\textless{}tim@savage.company\\textgreater{}",
         "manual",
     ),
 ]
@@ -236,7 +235,7 @@
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [("index", "odin", u"Odin Documentation", [author], 1)]
+man_pages = [("index", "odin", "Odin Documentation", [author], 1)]
 
 # If true, show URL addresses after external links.
 # man_show_urls = False
@@ -251,7 +250,7 @@
     (
         "index",
         "Odin",
-        u"Odin Documentation",
+        "Odin Documentation",
         author,
         "Odin",
         "One line description of project.",

poetry.lock

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "odin"
-version = "2.6"
+version = "2.8"
 description = "Data-structure definition/validation/traversal, mapping and serialisation toolkit for Python"
 authors = ["Tim Savage <tim@savage.company>"]
 license = "BSD-3-Clause"
@@ -53,4 +53,32 @@ msgpack = ["msgpack"]
 toml = ["toml"]
 pint = ["pint"]
 arrow = ["arrow"]
-rich = ["rich"]
+rich = ["rich"]
+
+[tool.isort]
+profile = "black"
+
+[tool.ruff]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    # "I",  # isort
+    "C",  # flake8-comprehensions
+    "B",  # flake8-bugbear
+]
+ignore = [
+    "E501",  # line too long, handled by black
+    "B008",  # do not perform function calls in argument defaults
+    "C901",  # too complex
+]
+
+# Assume Python 3.8.
+target-version = "py38"
+
+[tool.ruff.per-file-ignores]
+"tests/test_adapters.py" = ["F403", "F405"]
+"tests/test_codec*.py" = ["F403", "F405"]
+"tests/test_fields.py" = ["F403", "F405"]
+"tests/test_kitchensink.py" = ["F403", "F405"]
+"tests/test_mapping.py" = ["F403", "F405"]

pyproject.toml

@@ -4,16 +4,16 @@
 logging.getLogger("odin.registration").addHandler(logging.NullHandler())
 
 from odin import exceptions  # noqa
+from odin.adapters import ResourceAdapter  # noqa
+from odin.annotated_resource import *  # noqa
+from odin.annotated_resource import type_aliases as types  # noqa
 from odin.fields import *  # noqa
 from odin.fields.composite import *  # noqa
 from odin.fields.virtual import *  # noqa
+from odin.helpers import *  # noqa
 from odin.mapping import *  # noqa
-from odin.resources import Resource  # noqa
-from odin.adapters import ResourceAdapter  # noqa
 from odin.proxy import ResourceProxy  # noqa
-from odin.annotated_resource import *  # noqa
-from odin.annotated_resource import type_aliases as types  # noqa
-from odin.helpers import *  # noqa
+from odin.resources import Resource  # noqa
 
 __authors__ = "Tim Savage <tim@savage.company>"
 __copyright__ = "Copyright (C) 2021 Tim Savage"

src/odin/__init__.py

@@ -1,4 +1,5 @@
 from functools import cached_property
+
 from odin.utils import field_iter_items, getmeta
 
 __all__ = ("ResourceAdapter",)

src/odin/adapters.py

@@ -12,18 +12,19 @@
 
 """
 import copy
-from typing import Any, Dict, Tuple, Type, Optional, TypeVar, Iterable
+from typing import Any, Dict, Iterable, Optional, Tuple, Type, TypeVar
 
 from odin import registration
 from odin.fields import BaseField
 from odin.resources import (
-    ResourceBase,
-    ResourceOptions,
     DEFAULT_TYPE_FIELD,
     NotProvided,
+    ResourceBase,
+    ResourceOptions,
 )
-from .type_resolution import process_attribute, Options
+
 from ..exceptions import ResourceDefError
+from .type_resolution import Options, process_attribute
 
 __all__ = (
     "Options",

src/odin/annotated_resource/__init__.py

@@ -1,5 +1,5 @@
 """Type aliases for string formatted types."""
-from typing import Callable, Union, Any, Sequence, Tuple
+from typing import Any, Callable, Sequence, Tuple, Union
 
 __all__ = (
     "Email",