v1 milestone

venv/lib/python3.12/site-packages/minio/versioningconfig.py

@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+# MinIO Python Library for Amazon S3 Compatible Cloud Storage, (C)
+# 2020 MinIO, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Request/response of PutBucketVersioning and GetBucketVersioning APIs."""
+
+from __future__ import absolute_import, annotations
+
+from typing import Type, TypeVar
+from xml.etree import ElementTree as ET
+
+from .commonconfig import DISABLED, ENABLED
+from .xml import Element, SubElement, findtext
+
+OFF = "Off"
+SUSPENDED = "Suspended"
+
+A = TypeVar("A", bound="VersioningConfig")
+
+
+class VersioningConfig:
+    """Versioning configuration."""
+
+    def __init__(
+            self,
+            status: str | None = None,
+            mfa_delete: str | None = None,
+    ):
+        if status is not None and status not in [ENABLED, SUSPENDED]:
+            raise ValueError(f"status must be {ENABLED} or {SUSPENDED}")
+        if mfa_delete is not None and mfa_delete not in [ENABLED, DISABLED]:
+            raise ValueError(f"MFA delete must be {ENABLED} or {DISABLED}")
+        self._status = status
+        self._mfa_delete = mfa_delete
+
+    @property
+    def status(self) -> str:
+        """Get status."""
+        return self._status or OFF
+
+    @property
+    def mfa_delete(self) -> str | None:
+        """Get MFA delete."""
+        return self._mfa_delete
+
+    @classmethod
+    def fromxml(cls: Type[A], element: ET.Element) -> A:
+        """Create new object with values from XML element."""
+        status = findtext(element, "Status")
+        mfa_delete = findtext(element, "MFADelete")
+        return cls(status, mfa_delete)
+
+    def toxml(self, element: ET.Element | None) -> ET.Element:
+        """Convert to XML."""
+        element = Element("VersioningConfiguration")
+        if self._status:
+            SubElement(element, "Status", self._status)
+        if self._mfa_delete:
+            SubElement(element, "MFADelete", self._mfa_delete)
+        return element