fix dataclass convert issue

docs/en/README.md

@@ -25,7 +25,7 @@ utype is a data type declaration and parsing library based on Python type annota
 
 Currently, Python does not have the mechanism to guarantee types at runtime, so when we write a function, we often need to perform type assertion and constraint checking on parameters before we can start writing the actual logic. such as
 ```python
-def login(username, password):  
+def signup(username, password):  
     import re  
     if not isinstance(username, str) \  
             or not re.match('[0-9a-zA-Z]{3,20}', username):  
@@ -43,18 +43,18 @@ However, if we can declare all types and constraints in the parameters, enforce
 	from utype.types import Annotated  # compat 3.7+
 
 	@utype.parse
-	def login(
+	def signup(
 		username: Annotated[str, utype.Param(regex='[0-9a-zA-Z]{3,20}')],
 		password: Annotated[str, utype.Param(min_length=6)]
 	):
 		# # you can directly start coding
 		return username, password
 
-	print(login('alice', 123456))
+	print(signup('alice', 123456))
 	('alice', '123456')
 
 	try:
-		login('@invalid', 123456)
+		signup('@invalid', 123456)
 	except utype.exc.ParseError as e:
 		print(e)
 		"""
@@ -68,18 +68,18 @@ However, if we can declare all types and constraints in the parameters, enforce
 	import utype
 
 	@utype.parse
-	def login(
+	def signup(
 		username: str = utype.Param(regex='[0-9a-zA-Z]{3,20}'),
 		password: str = utype.Param(min_length=6)
 	):
 		# # you can directly start coding
 		return username, password
 
-	print(login('alice', 123456))
+	print(signup('alice', 123456))
 	('alice', '123456')
 
 	try:
-		login('@invalid', 123456)
+		signup('@invalid', 123456)
 	except utype.exc.ParseError as e:
 		print(e)
 		"""

docs/mkdocs.en.yml

@@ -28,6 +28,7 @@ theme:
     - toc.follow
     - navigation.tracking
     - navigation.top
+    - content.code.copy
 
 repo_name: utilmeta/utype
 repo_url: https://github.com/utilmeta/utype

docs/mkdocs.zh.yml

@@ -27,6 +27,7 @@ theme:
     - toc.follow
     - navigation.tracking
     - navigation.top
+    - content.code.copy
 
 repo_name: utilmeta/utype
 repo_url: https://github.com/utilmeta/utype

docs/zh/README.md

@@ -26,7 +26,7 @@ utype 是一个基于 Python 类型注解的数据类型声明与解析库，能
 
 目前 Python 没有在运行时解析类型与校验约束的机制，所以当我们编写一个函数时，往往需要先对参数进行类型断言和约束校验等操作，然后才能开始编写真正的逻辑，否则很可能会在运行时发生异常错误，如
 ```python
-def login(username, password):  
+def signup(username, password):  
     import re  
     if not isinstance(username, str) \  
             or not re.match('[0-9a-zA-Z]{3,20}', username):  
@@ -44,18 +44,18 @@ def login(username, password):
 	from utype.types import Annotated
 
 	@utype.parse
-	def login(
+	def signup(
 		username: Annotated[str, utype.Param(regex='[0-9a-zA-Z]{3,20}')],
 		password: Annotated[str, utype.Param(min_length=6)]
 	):
 		# 你可以直接开始编写逻辑了
 		return username, password
 
-	print(login('alice', 123456))
+	print(signup('alice', 123456))
 	('alice', '123456')
 
 	try:
-		login('@invalid', 123456)
+		signup('@invalid', 123456)
 	except utype.exc.ParseError as e:
 		print(e)
 		"""
@@ -69,18 +69,18 @@ def login(username, password):
 	import utype
 
 	@utype.parse
-	def login(
+	def signup(
 		username: str = utype.Param(regex='[0-9a-zA-Z]{3,20}'),
 		password: str = utype.Param(min_length=6)
 	):
 		# 你可以直接开始编写逻辑了
 		return username, password
 
-	print(login('alice', 123456))
+	print(signup('alice', 123456))
 	('alice', '123456')
 
 	try:
-		login('@invalid', 123456)
+		signup('@invalid', 123456)
 	except utype.exc.ParseError as e:
 		print(e)
 		"""

tests/test_cls.py

@@ -996,3 +996,13 @@ class LogicalUser(DataClass):
         assert res == {'oneOf': [{'type': 'object', 'properties':
             {'name': {'type': 'string', 'maxLength': 10}, 'age': {'type': 'integer'}}, 'required': ['name', 'age']},
                                  {'type': 'array', 'prefixItems': [{'type': 'string'}, {'type': 'integer'}]}]}
+
+    def test_pass(self):
+        class A(Schema):
+            a: str = utype.Field(no_output=True)
+
+        class B(Schema):
+            a_or: A
+
+        b = B(a_or=[A(a=3)])
+        assert b.a_or.a == '3'

utype/__init__.py

@@ -12,7 +12,7 @@
 register_transformer = TypeTransformer.registry.register
 
 
-VERSION = (0, 4, 0, None)
+VERSION = (0, 4, 1, None)
 
 
 def _get_version():

utype/parser/cls.py

@@ -574,8 +574,18 @@ def init_dataclass(
     detector=lambda cls: isinstance(getattr(cls, "__parser__", None), ClassParser),
 )
 def transform_dataclass(transformer: TypeTransformer, data, cls):
+    if isinstance(data, (list, tuple)) and not transformer.options.no_explicit_cast:
+        if data:
+            if transformer.options.no_data_loss and len(data) > 1:
+                raise TypeError
+            data = data[0]
+            # otherwise the data will become dict then fill the dataclass
+            if type(data) == cls:
+                return data
+
     if transformer.options.allow_subclasses:
         if isinstance(data, cls):
             # subclass
             return data
+
     return init_dataclass(cls, data, context=transformer.context)