Translate class-attributes.md to Japanese

Co-Authored-By: yukinarit <[email protected]>

docs/en/class-attributes.md

@@ -148,7 +148,7 @@ See [examples/custom_legacy_class_serializer.py](https://github.com/yukinarit/py
 
 ### **`type_check`**
 
-New in v0.9.0. See [Type Check](#type-check.md).
+New in v0.9.0. See [Type Check](type-check.md).
 
 ### **`serialize_class_var`**
 
@@ -162,4 +162,4 @@ class Foo:
 
 See [examples/class_var.py](https://github.com/yukinarit/pyserde/blob/main/examples/class_var.py) for complete example.
 
-[^1]: https://docs.python.org/3/library/dataclasses.html#dataclasses.fields
+[^1]: [dataclasses.fields](https://docs.python.org/3/library/dataclasses.html#dataclasses.fields)

docs/ja/class-attributes.md

@@ -0,0 +1,183 @@
+# Class Attributes
+
+クラス属性は、クラスのデシリアライズの動作をカスタマイズするために `serialize` / `deserialize` デコレータの引数として指定できます。  
+フィールドをカスタマイズしたい場合は、[フィールド属性](field-attributes.md)の使用を検討してください。
+
+## dataclassesの属性
+
+### **`frozen`**
+
+dataclassの `frozen` クラス属性は期待通りに機能します。
+
+### **`kw_only`**
+
+バージョン0.12.2で新規追加。dataclassの `kw_only` クラス属性は期待通りに機能します。
+
+```python
+@serde
+@dataclass(kw_only=True)
+class Foo:
+    i: int
+    s: str
+    f: float
+    b: bool
+```
+
+完全な例については、[examples/kw_only.py](https://github.com/yukinarit/pyserde/blob/main/examples/kw_only.py)を参照してください。
+
+## pyserdeの属性
+
+### **`rename_all`**
+
+`rename_all` を使うと、フィールド名を指定されたケーススタイルに変換できます。  
+以下の例では、キャメルケースのフィールド名をスネークケースに変換しています。
+ケーススタイルの変換処理は [python-casefy](https://github.com/dmlls/python-casefy) パッケージに依存しています。  
+サポートされるケーススタイルの一覧は [python-casefy のドキュメント](https://dmlls.github.io/python-casefy/api.html)を参照してください。
+
+```python
+@serde(rename_all = 'camelcase')
+class Foo:
+    int_field: int
+    str_field: str
+
+f = Foo(int_field=10, str_field='foo')
+print(to_json(f))
+```
+
+上記のコードを実行すると、`int_field` は `intField` に、`str_field` は `strField` に変換されます。
+
+```json
+{"intField": 10, "strField": "foo"}
+```
+
+> **注記:** `rename_all` クラス属性と `rename` フィールド属性が同時に使用される場合、`rename` が優先されます。
+>
+> ```python
+> @serde(rename_all = 'camelcase')
+> class Foo:
+>     int_field: int
+>     str_field: str = field(rename='str-field')
+>
+> f = Foo(int_field=10, str_field='foo')
+> print(to_json(f))
+> ```
+> 上記のコードは以下を出力します。
+> ```
+> {"intField": 10, "str-field": "foo"}
+> ```
+
+完全な例については、[examples/rename_all.py](https://github.com/yukinarit/pyserde/blob/main/examples/rename_all.py)を参照してください。
+
+### **`tagging`**
+
+バージョン0.7.0で新規追加。詳細は [Union](union.md) を参照してください。
+
+### **`class_serializer`** と **`class_deserializer`**
+
+バージョン0.13.0で新規追加。  
+
+クラスレベルでカスタムデシリアライザを使用したい場合、`class_serializer` および `class_deserializer` 属性にデシリアライザオブジェクトを渡すことができます。  
+カスタムデシリアライザは、C++のように複数のメソッドのオーバーロードを可能にするPythonライブラリ [plum](https://github.com/beartype/plum) に依存しています。  
+plumを使用すると、堅牢なカスタムデシリアライザを簡単に書くことができます。
+
+```python
+class MySerializer:
+    @dispatch
+    def serialize(self, value: datetime) -> str:
+        return value.strftime("%d/%m/%y")
+
+class MyDeserializer:
+    @dispatch
+    def deserialize(self, cls: Type[datetime], value:
+
+ Any) -> datetime:
+        return datetime.strptime(value, "%d/%m/%y")
+
+@serde(class_serializer=MySerializer(), class_deserializer=MyDeserializer())
+class Foo:
+    v: datetime
+```
+
+旧来の `serializer` と `deserializer` との大きな違いは、 新しい`class_serializer` と `class_deserializer` が pyserde のコード生成レベルでより深く統合されていることです。  
+これにより Optional や List、ネストされた dataclass を自分で処理する必要はありません。  
+
+カスタムクラスのデシリアライザはすべてのデシリアライズのレベル（単純なデータ型から複雑なネストされたデータ構造まで、あらゆる種類のデシリアライズ処理）で使用されるため、サードパーティ製の型もビルトイン型のように扱うことが可能です。
+
+また、
+* フィールドシリアライザとクラスシリアライザの両方が指定されている場合、フィールドシリアライザが優先されます。
+* 旧と新のクラスシリアライザの両方が指定されている場合、新しいクラスシリアライザが優先されます。
+
+> 💡 ヒント：複数の `serialize` メソッドを実装する場合、型チェッカーから、`Redefinition of unused serialize`という警告が出ることがあります。  
+> その場合は、`plum.overload` と `plum.dispatch` を使用して回避してください。  
+> 詳細は [plumのドキュメント](https://beartype.github.io/plum/integration.html) を参照してください。
+>
+> ```python
+> from plum import dispatch, overload
+> 
+> class Serializer:
+>    # @overload を使用
+>    @overload
+>    def serialize(self, value: int) -> Any:
+>        return str(value)
+>
+>    # @overload を使用
+>    @overload
+>    def serialize(self, value: float) -> Any:
+>        return int(value)
+>
+>    # メソッド追加時は必ず @dispatch を追加してください。Plumが型チェッカーからの警告を消してくれます
+>    @dispatch
+>    def serialize(self, value: Any) -> Any:
+>        ...
+> ```
+
+完全な例については、[examples/custom_class_serializer.py](https://github.com/yukinarit/pyserde/blob/main/examples/custom_class_serializer.py)を参照してください。
+
+
+### **`serializer`** と **`deserializer`**
+
+> **注記:** `serializer`** と **`deserializer`は、バージョン0.13.0以降、非推奨となりました。  
+> `class_serializer` および `class_deserializer` の使用を検討してください。
+
+クラスレベルでカスタムのデシリアライザを使用したい場合、`serializer` および `deserializer` 属性にデシリアライザメソッドを渡すことができます。
+
+```python
+def serializer(cls, o):
+    if cls is datetime:
+        return o.strftime('%d/%m/%y')
+    else:
+        raise SerdeSkip()
+
+def deserializer(cls, o):
+    if cls is datetime:
+        return datetime.strptime(o, '%d/%m/%y')
+    else:
+        raise SerdeSkip()
+
+@serde(serializer=serializer, deserializer=deserializer)
+class Foo:
+    a: datetime
+```
+
+完全な例については、[examples/custom_legacy_class_serializer.py](https://github.com/yukinarit/pyserde/blob/main/examples/custom_legacy_class_serializer.py) を参照してください。
+
+### **`type_check`**
+
+バージョン0.9.0で新規追加。詳細は [Type Check](type-check.md) を参照してください。
+
+### **`serialize_class_var`**
+
+バージョン0.9.8で新規追加。  
+
+`dataclasses.fields` はクラス変数を含まないため[^1]、pyserdeはデフォルトでクラス変数をシリアライズしません。  
+`serialize_class_var` を使用することで `typing.ClassVar` のフィールドをシリアライズすることができます。
+
+```python
+@serde(serialize_class_var=True)
+class Foo:
+    a: ClassVar[int] = 10
+```
+
+完全な例については、[examples/class_var.py](https://github.com/yukinarit/pyserde/blob/main/examples/class_var.py) を参照してください。
+
+[^1]: [dataclasses.fields](https://docs.python.org/3/library/dataclasses.html#dataclasses.fields)