pystandards 0.0.1__tar.gz

pystandards-0.0.1/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pystandards-0.0.1/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: pystandards
+Version: 0.0.1
+Summary: Standards but in Python
+License-File: LICENSE
+Author: danialcala94
+Author-email: danielalcalavalera@gmail.com
+Requires-Python: >=3.8,<3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: exrex (>=0.0.1,<9999.0.0)
+Requires-Dist: yta_validation (>=0.0.1,<1.0.0)
+Description-Content-Type: text/markdown
+
+# pystandards  -  Standards but in Python
+
+> Typed standards, constants, enums and canonical values for Python.
+
+`pystandards` provides strongly-typed constants and standardized values for common domains such as HTTP, MIME types, file extensions, languages, encodings, and more.
+
+Designed for:
+
+- Clean APIs
+- Type safety
+- IDE autocompletion
+- Validation
+- Better developer experience
+
+---
+
+# Features
+
+- Typed enums based on a custom `BaseEnum`
+- Safe conversion from raw values
+- Canonical standards and constants
+- Consistent API across domains
+- Lightweight and dependency-free
+- Fully type-hinted
+
+---
+
+# Installation
+
+```bash
+pip install pystandards
+```
+---
+
+💪 Build fast, believe in yourself and keep going. Never stop!

pystandards-0.0.1/README.md

@@ -0,0 +1,35 @@
+# pystandards  -  Standards but in Python
+
+> Typed standards, constants, enums and canonical values for Python.
+
+`pystandards` provides strongly-typed constants and standardized values for common domains such as HTTP, MIME types, file extensions, languages, encodings, and more.
+
+Designed for:
+
+- Clean APIs
+- Type safety
+- IDE autocompletion
+- Validation
+- Better developer experience
+
+---
+
+# Features
+
+- Typed enums based on a custom `BaseEnum`
+- Safe conversion from raw values
+- Canonical standards and constants
+- Consistent API across domains
+- Lightweight and dependency-free
+- Fully type-hinted
+
+---
+
+# Installation
+
+```bash
+pip install pystandards
+```
+---
+
+💪 Build fast, believe in yourself and keep going. Never stop!

pystandards-0.0.1/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "pystandards"
+version = "0.0.1"
+description = "Standards but in Python"
+authors = [
+    {name = "danialcala94",email = "danielalcalavalera@gmail.com"}
+]
+readme = "README.md"
+requires-python = ">=3.8,<3.14"
+
+[tool.poetry.dependencies]
+# Mandatory
+yta_validation = { version = ">=0.0.1,<1.0.0", optional = false }
+exrex = { version = ">=0.0.1,<9999.0.0", optional = false }
+# Optional
+
+[tool.poetry]
+packages = [{include = "pystandards", from = "src"}]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.5"
+
+[tool.pytest.ini_options]
+markers = [
+    "mandatory: mandatory tests for release",
+    "additional: exhaustive and demanding tests"
+]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

pystandards-0.0.1/src/pystandards/enum.py

@@ -0,0 +1,100 @@
+from enum import Enum
+from typing import Union
+
+
+class BaseEnum(Enum):
+    """
+    Custom Enum class that is able to autodetect
+    and parse values based on its `name` and/or
+    its `value`.
+    """
+
+    @classmethod
+    def names(
+        cls
+    ) -> list[str]:
+        """
+        A list containing all the names that are registered
+        in this `BaseEnum` class.
+        """
+        return [
+            x.name
+            for x in cls
+        ]
+
+    @classmethod
+    def values(
+        cls
+    ) -> list[any]:
+        """
+        A list containing all the values that are registered
+        in this `BaseEnum` class.
+        """
+        return [
+            x.value
+            for x in cls
+        ]
+    
+    @classmethod
+    def _normalized_map(
+        cls
+    ):
+        """
+        *For internal use only*
+
+        Internal cache to make it faster when the list
+        of items is big.
+        """
+
+        if not hasattr(cls, '__normalized_map'):
+            mapping = {}
+
+            for item in cls:
+                mapping[item.name.lower()] = item
+                mapping[str(item.value).strip().lower()] = item
+            cls.__normalized_map = mapping
+
+        return cls.__normalized_map
+
+    @classmethod
+    def to_enum(
+        cls,
+        value: any
+    ):
+        """
+        Convert a raw value into a valid enum member,
+        raising an exception if there is no item with
+        that `value` or as name or value.
+
+        Comparison is case-insensitive and checks:
+        - enum.value
+        - enum.name
+        """
+        if isinstance(value, cls):
+            return value
+
+        normalized = str(value).strip().lower()
+
+        try:
+            return cls._normalized_map()[normalized]
+
+        except KeyError:
+            raise ValueError(
+                f'{value!r} is not a valid {cls.__name__}'
+            ) from None
+    
+    @classmethod
+    def try_to_enum(
+        cls,
+        value: any,
+        default: Union[any, None] = None
+    ):
+        """
+        Try to parse the `value` provided as the Enum,
+        returning the `default` if not possible because
+        there is no `Enum` item with that value.
+        """
+        try:
+            return BaseEnum.to_enum(value)
+        except:
+            return default

pystandards-0.0.1/src/pystandards/http.py

@@ -0,0 +1,132 @@
+from pystandards.enum import BaseEnum as Enum
+
+
+class HttpContentType(Enum):
+    """
+    The `content_type` field that could come in the
+    response of a http request we make.
+    """
+
+    # JSON
+    APPLICATION_JSON = 'application/json'
+    APPLICATION_LD_JSON = 'application/ld+json'
+    APPLICATION_PROBLEM_JSON = 'application/problem+json'
+
+    # Text
+    TEXT_PLAIN = 'text/plain'
+    TEXT_HTML = 'text/html'
+    TEXT_CSS = 'text/css'
+    TEXT_CSV = 'text/csv'
+    TEXT_XML = 'text/xml'
+    TEXT_EVENT_STREAM = 'text/event-stream'
+    TEXT_JAVASCRIPT = 'text/javascript'
+
+    # XML / Markup
+    APPLICATION_XML = 'application/xml'
+    APPLICATION_XHTML_XML = 'application/xhtml+xml'
+
+    # JavaScript
+    APPLICATION_JAVASCRIPT = 'application/javascript'
+
+    # Binary / Generic files
+    APPLICATION_OCTET_STREAM = 'application/octet-stream'
+    APPLICATION_PDF = 'application/pdf'
+    APPLICATION_ZIP = 'application/zip'
+    APPLICATION_GZIP = 'application/gzip'
+    APPLICATION_X_TAR = 'application/x-tar'
+
+    # Forms
+    MULTIPART_FORM_DATA = 'multipart/form-data'
+    APPLICATION_X_WWW_FORM_URLENCODED = (
+        'application/x-www-form-urlencoded'
+    )
+
+    # Streaming
+    APPLICATION_NDJSON = 'application/x-ndjson'
+
+    # SQL
+    APPLICATION_SQL = 'application/sql'
+
+    # Images
+    IMAGE_JPEG = 'image/jpeg'
+    IMAGE_PNG = 'image/png'
+    IMAGE_WEBP = 'image/webp'
+    IMAGE_GIF = 'image/gif'
+    IMAGE_SVG_XML = 'image/svg+xml'
+    IMAGE_BMP = 'image/bmp'
+    IMAGE_X_ICON = 'image/x-icon'
+
+    # Video
+    VIDEO_MP4 = 'video/mp4'
+    VIDEO_WEBM = 'video/webm'
+    VIDEO_QUICKTIME = 'video/quicktime'
+    VIDEO_X_MSVIDEO = 'video/x-msvideo'
+
+    # Audio
+    AUDIO_WAV = 'audio/wav'
+    AUDIO_MPEG = 'audio/mpeg'
+    AUDIO_OGG = 'audio/ogg'
+    AUDIO_WEBM = 'audio/webm'
+    AUDIO_FLAC = 'audio/flac'
+
+    # Fonts
+    FONT_WOFF = 'font/woff'
+    FONT_WOFF2 = 'font/woff2'
+
+
+class HttpMethod(Enum):
+    """
+    The methods that are supported in the Http
+    requests que make.
+    """
+
+    # Standard methods
+    GET = 'GET'
+    POST = 'POST'
+    PUT = 'PUT'
+    DELETE = 'DELETE'
+    PATCH = 'PATCH'
+    HEAD = 'HEAD'
+    OPTIONS = 'OPTIONS'
+    TRACE = 'TRACE'
+    CONNECT = 'CONNECT'
+
+    # WebDAV methods
+    PROPFIND = 'PROPFIND'
+    PROPPATCH = 'PROPPATCH'
+    MKCOL = 'MKCOL'
+    COPY = 'COPY'
+    MOVE = 'MOVE'
+    LOCK = 'LOCK'
+    UNLOCK = 'UNLOCK'
+
+    # Versioning / Delta encoding
+    VERSION_CONTROL = 'VERSION-CONTROL'
+    REPORT = 'REPORT'
+    CHECKOUT = 'CHECKOUT'
+    CHECKIN = 'CHECKIN'
+    UNCHECKOUT = 'UNCHECKOUT'
+    MKWORKSPACE = 'MKWORKSPACE'
+    UPDATE = 'UPDATE'
+    LABEL = 'LABEL'
+    MERGE = 'MERGE'
+    BASELINE_CONTROL = 'BASELINE-CONTROL'
+    MKACTIVITY = 'MKACTIVITY'
+
+    # UPnP
+    NOTIFY = 'NOTIFY'
+    SUBSCRIBE = 'SUBSCRIBE'
+    UNSUBSCRIBE = 'UNSUBSCRIBE'
+
+    # RFC 5789
+    SEARCH = 'SEARCH'
+
+    # CalDAV
+    MKCALENDAR = 'MKCALENDAR'
+
+    # RFC 2068
+    LINK = 'LINK'
+    UNLINK = 'UNLINK'
+
+    # Icecast / unofficial
+    SOURCE = 'SOURCE'