SWAMPy

✎ CARVE FLESH

EDITING: compat.py

# -*- coding: utf-8 -*-
# config.py
# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
#
# This module is part of GitPython and is released under
# the BSD License: http://www.opensource.org/licenses/bsd-license.php
"""utilities to help provide compatibility with python 3"""
# flake8: noqa

import locale
import os
import sys

from gitdb.utils.encoding import (
    force_bytes,  # @UnusedImport
    force_text,  # @UnusedImport
)

# typing --------------------------------------------------------------------

from typing import (
    Any,
    AnyStr,
    Dict,
    IO,
    Optional,
    Tuple,
    Type,
    Union,
    overload,
)

# ---------------------------------------------------------------------------

is_win: bool = os.name == "nt"
is_posix = os.name == "posix"
is_darwin = os.name == "darwin"
defenc = sys.getfilesystemencoding()

@overload
def safe_decode(s: None) -> None:
    ...

@overload
def safe_decode(s: AnyStr) -> str:
    ...

def safe_decode(s: Union[AnyStr, None]) -> Optional[str]:
    """Safely decodes a binary string to unicode"""
    if isinstance(s, str):
        return s
    elif isinstance(s, bytes):
        return s.decode(defenc, "surrogateescape")
    elif s is None:
        return None
    else:
        raise TypeError("Expected bytes or text, but got %r" % (s,))

@overload
def safe_encode(s: None) -> None:
    ...

@overload
def safe_encode(s: AnyStr) -> bytes:
    ...

def safe_encode(s: Optional[AnyStr]) -> Optional[bytes]:
    """Safely encodes a binary string to unicode"""
    if isinstance(s, str):
        return s.encode(defenc)
    elif isinstance(s, bytes):
        return s
    elif s is None:
        return None
    else:
        raise TypeError("Expected bytes or text, but got %r" % (s,))

@overload
def win_encode(s: None) -> None:
    ...

@overload
def win_encode(s: AnyStr) -> bytes:
    ...

def win_encode(s: Optional[AnyStr]) -> Optional[bytes]:
    """Encode unicodes for process arguments on Windows."""
    if isinstance(s, str):
        return s.encode(locale.getpreferredencoding(False))
    elif isinstance(s, bytes):
        return s
    elif s is not None:
        raise TypeError("Expected bytes or text, but got %r" % (s,))
    return None

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 __pycache__/	DIR	—	2026-09-08 20:30
📁 index/	DIR	—	2026-09-08 20:30
📁 objects/	DIR	—	2026-09-08 20:30
📁 refs/	DIR	—	2026-09-08 20:30
📁 repo/	DIR	—	2026-09-08 20:30
📄 __init__.py	PY	2.3 KB	2026-08-21 11:54	EDIT
📄 cmd.py	PY	52.5 KB	2026-08-21 11:54	EDIT
📄 compat.py	PY	2.2 KB	2026-08-21 11:54	EDIT
📄 config.py	PY	33.8 KB	2026-08-21 11:54	EDIT
📄 db.py	PY	2.2 KB	2026-08-21 11:54	EDIT
📄 diff.py	PY	22.9 KB	2026-08-21 11:54	EDIT
📄 exc.py	PY	6.3 KB	2026-08-21 11:54	EDIT
📄 py.typed	TYPED	0 B	2026-08-21 11:54	EDIT
📄 remote.py	PY	44 KB	2026-08-21 11:54	EDIT
📄 types.py	PY	2.9 KB	2026-08-21 11:54	EDIT
📄 util.py	PY	38.9 KB	2026-08-21 11:54	EDIT