Update docs

docs/api/codegen.rst

@@ -18,6 +18,7 @@ like naming conventions and aliases.
     GeneratorConfig
     GeneratorOutput
 
+    OutputFormat
     GeneratorConventions
     GeneratorAliases
     StructureStyle

docs/codegen.rst

@@ -23,6 +23,7 @@ Generate Code
 
     - :ref:`Compound fields <Type: Elements>`
     - :ref:`Docstring styles`
+    - :ref:`Dataclasses Features`
 
 
 .. code-block:: console
@@ -96,8 +97,9 @@ altogether.
 
 .. warning::
 
-    Auto :ref:`locating types <Unknown xml target type>` during parsing might not work since
-    all classes are bundled together under the same module namespace.
+    Auto :ref:`locating types <Parse with unknown xml target type>` during parsing
+    might not work since all classes are bundled together under the same module
+    namespace.
 
 
 Initialize Config

docs/examples.rst

@@ -12,6 +12,7 @@ Code Generation
     examples/xml-modeling
     examples/json-modeling
     examples/compound-fields
+    examples/dataclasses-features
 
 
 Advance Topics

docs/examples/dataclasses-features.rst

@@ -0,0 +1,41 @@
+====================
+Dataclasses Features
+====================
+
+By default xsdata with generate
+`dataclasses <https://docs.python.org/3/library/dataclasses.html>`_ with the default
+features on but you can use a :ref:`generator config <Generator Config>` to toggle
+almost all of them.
+
+
+.. literalinclude:: /../tests/fixtures/stripe/.xsdata.xml
+   :language: xml
+   :lines: 2-6
+
+
+.. tab:: Frozen Model
+
+    The code generator will use tuples instead of lists as well.
+
+    .. literalinclude:: /../tests/fixtures/stripe/models/balance.py
+       :language: python
+       :lines: 93-128
+
+.. tab:: Frozen Bindings
+
+    .. testcode::
+
+        import pprint
+        from tests import fixtures_dir
+        from tests.fixtures.stripe.models import Balance
+        from xsdata.formats.dataclass.parsers import JsonParser
+
+        xml_path = fixtures_dir.joinpath("stripe/samples/balance.json")
+        parser = JsonParser()
+        root = parser.from_path(xml_path, Balance)
+        pprint.pprint(root.pending)
+
+    .. testoutput::
+
+        (Pending(amount=835408472, currency='usd', source_types=SourceTypes(bank_account=0, card=835408472)),
+         Pending(amount=-22251, currency='eur', source_types=SourceTypes(bank_account=0, card=-22251)))

docs/examples/json-modeling.rst

@@ -9,17 +9,17 @@ duplicate classes and their fields and their field types.
 
 .. code-block:: console
 
-    $ xsdata --package tests.fixtures.series tests/fixtures/series
+    $ xsdata --package tests.fixtures.series tests/fixtures/series/samples
 
 
 .. tab:: Sample #1
 
-    .. literalinclude:: /../tests/fixtures/series/show1.json
+    .. literalinclude:: /../tests/fixtures/series/samples/show1.json
        :language: json
 
 .. tab:: Sample #2
 
-    .. literalinclude:: /../tests/fixtures/series/show2.json
+    .. literalinclude:: /../tests/fixtures/series/samples/show2.json
        :language: json
 
 

docs/models.rst

@@ -124,7 +124,7 @@ Simply follow the Python lib
 
 .. warning::
 
-    Currently only List, Dict and Union annotations are supported.
+    Currently only List, Tuple, Dict and Union annotations are supported.
     Everything else will raise an exception as unsupported.
 
 

tests/fixtures/stripe/.xsdata.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Config xmlns="http://pypi.org/project/xsdata" version="21.6">
+  <Output maxLineLength="79">
+    <Package>tests.fixtures.stripe.models.balance</Package>
+    <Format repr="true" eq="true" order="true" unsafeHash="false" frozen="true">dataclasses</Format>
+    <Structure>single-package</Structure>
+    <DocstringStyle>reStructuredText</DocstringStyle>
+    <RelativeImports>true</RelativeImports>
+    <CompoundFields>false</CompoundFields>
+  </Output>
+  <Conventions>
+    <ClassName case="pascalCase" safePrefix="type"/>
+    <FieldName case="snakeCase" safePrefix="value"/>
+    <ConstantName case="screamingSnakeCase" safePrefix="value"/>
+    <ModuleName case="snakeCase" safePrefix="mod"/>
+    <PackageName case="snakeCase" safePrefix="pkg"/>
+  </Conventions>
+  <Aliases>
+  </Aliases>
+</Config>

tests/fixtures/stripe/models/__init__.py

@@ -0,0 +1,15 @@
+from .balance import (
+    Available,
+    Balance,
+    ConnectReserved,
+    Pending,
+    SourceTypes,
+)
+
+__all__ = [
+    "Available",
+    "Balance",
+    "ConnectReserved",
+    "Pending",
+    "SourceTypes",
+]

tests/fixtures/stripe/models/balance.py

@@ -0,0 +1,128 @@
+from dataclasses import dataclass, field
+from typing import Optional, Tuple
+
+
+@dataclass(order=True, frozen=True)
+class ConnectReserved:
+    class Meta:
+        name = "connect_reserved"
+
+    amount: Optional[int] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    currency: Optional[str] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+
+
+@dataclass(order=True, frozen=True)
+class SourceTypes:
+    class Meta:
+        name = "source_types"
+
+    bank_account: Optional[int] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    card: Optional[int] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+
+
+@dataclass(order=True, frozen=True)
+class Available:
+    class Meta:
+        name = "available"
+
+    amount: Optional[int] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    currency: Optional[str] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    source_types: Optional[SourceTypes] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+
+
+@dataclass(order=True, frozen=True)
+class Pending:
+    class Meta:
+        name = "pending"
+
+    amount: Optional[int] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    currency: Optional[str] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    source_types: Optional[SourceTypes] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+
+
+@dataclass(order=True, frozen=True)
+class Balance:
+    class Meta:
+        name = "balance"
+
+    object_value: Optional[str] = field(
+        default=None,
+        metadata={
+            "name": "object",
+            "type": "Element",
+        }
+    )
+    available: Tuple[Available, ...] = field(
+        default_factory=tuple,
+        metadata={
+            "type": "Element",
+        }
+    )
+    connect_reserved: Tuple[ConnectReserved, ...] = field(
+        default_factory=tuple,
+        metadata={
+            "type": "Element",
+        }
+    )
+    livemode: Optional[bool] = field(
+        default=None,
+        metadata={
+            "type": "Element",
+        }
+    )
+    pending: Tuple[Pending, ...] = field(
+        default_factory=tuple,
+        metadata={
+            "type": "Element",
+        }
+    )