console-default-encoding 0.0.1__py3-none-any.whl

console_default_encoding/__init__.py

@@ -0,0 +1,5 @@
+from .con_de import get_console_default_encoding
+
+__all__ = [
+    "get_console_default_encoding"
+]

console_default_encoding/con_de.py

@@ -0,0 +1,94 @@
+import locale
+import sys
+import platform
+from typing import Optional
+import os
+
+try:
+    from .get_cp0 import get_cp0_value
+except:
+    from get_cp0 import get_cp0_value
+
+def get_console_default_encoding_raw() -> Optional[str]:
+    encoding = None
+    system = platform.system().lower()
+
+    try:
+        # ========== 1. Windows 系统（优先获取控制台代码页） ==========
+        if system == "windows":
+            try:
+                # 导入 Windows 专属模块，获取控制台代码页
+                import ctypes
+                from ctypes import wintypes
+
+                # 获取标准输出的代码页
+                kernel32 = ctypes.WinDLL("kernel32", use_last_error=True)
+                handle = kernel32.GetStdHandle(-11)  # STD_OUTPUT_HANDLE
+                codepage = wintypes.UINT()
+                success = kernel32.GetConsoleOutputCP(ctypes.byref(codepage))
+                if success:
+                    # 代码页映射：936=gbk，65001=utf-8，437=IBM437 等
+                    codepage_map = {
+                        936: "gbk",
+                        65001: "utf-8",
+                        437: "ibm437",
+                        1252: "cp1252",
+                        950: "big5"
+                    }
+                    encoding = codepage_map.get(codepage.value, f"cp{codepage.value}")
+            except (ImportError, OSError, AttributeError):
+                # 兜底：使用 locale 模块获取 Windows 默认编码
+                encoding = locale.getdefaultlocale()[1]
+
+        # ========== 2. Linux/macOS 系统 ==========
+        else:
+            # 方式1：通过 locale 获取终端编码
+            try:
+                encoding = locale.getpreferredencoding()
+            except (locale.Error, ValueError):
+                # 方式2：读取环境变量（LC_CTYPE/LANG）
+                env_vars = ["LC_CTYPE", "LANG"]
+                for var in env_vars:
+                    if var in os.environ:
+                        # 从环境变量中提取编码（如 LANG=zh_CN.UTF-8 → utf-8）
+                        lang_str = os.environ[var]
+                        if "." in lang_str:
+                            encoding = lang_str.split(".")[-1].lower()
+                            break
+
+        # ========== 3. 最终兜底：使用 Python 标准流编码 ==========
+        if not encoding:
+            # 优先用 stdout 编码，失败则用 stdin
+            encoding = sys.stdout.encoding or sys.stdin.encoding
+
+        # 统一转为小写，标准化名称（如 GBK → gbk，UTF-8 → utf-8）
+        if encoding:
+            encoding = encoding.lower().replace("-", "")
+            # 兼容别名：cp936 → gbk
+            if encoding == "cp936":
+                encoding = "gbk"
+            elif encoding == "cp65001":
+                encoding = "utf8"
+
+        return encoding
+
+    except Exception as e:
+        print(f"检测命令行编码时出错：{e}")
+        return None
+
+def get_console_default_encoding() -> Optional[str]:
+    """
+    获取当前系统命令行（控制台/终端）的默认编码格式（如 gbk、utf-8）
+    
+    Returns:
+        Optional[str]: 成功返回编码名称（小写），失败返回 None
+    """
+
+    cpx = get_console_default_encoding_raw()
+    if cpx == "cp0" or (cpx is None):
+        return get_cp0_value()["encoding_name"]
+    else:
+        return cpx
+
+if __name__ == "__main__":
+    print(get_console_default_encoding())

console_default_encoding/get_cp0.py

@@ -0,0 +1,51 @@
+import ctypes
+import locale
+import sys
+
+def get_cp0_value():
+    """
+    获取 CP0 对应的实际系统默认 ANSI 代码页编号
+    CP0 在 Windows 下等价于 CP_ACP (ANSI Code Page)
+    兼容 Python 3.15+，移除 getdefaultlocale() 弃用警告
+    """
+
+    # 核心：调用 Windows API 获取 CP0 对应的实际代码页编号
+    kernel32 = ctypes.WinDLL('kernel32', use_last_error=True)
+    cp0_number = kernel32.GetACP()
+    
+    # 替代弃用的 getdefaultlocale()：分版本获取编码名称
+    if sys.version_info >= (3, 11):
+        # Python 3.11+ 推荐使用 getencoding()
+        try:
+            encoding_name = locale.getencoding()
+        except Exception:
+            encoding_name = f'cp{cp0_number}'
+    else:
+        # 兼容低版本 Python
+        try:
+            encoding_name = locale.getdefaultlocale()[1]
+        except (ValueError, IndexError):
+            encoding_name = f'cp{cp0_number}'
+    
+    # 统一修正编码名称（如 gb2312 -> gbk，保持和 CP936 对应）
+    encoding_map = {
+        'gb2312': 'gbk',
+        'cp936': 'gbk',
+        'cp1252': 'cp1252',
+        'cp950': 'big5'
+    }
+    encoding_name = encoding_map.get(encoding_name.lower(), encoding_name)
+    
+    return {
+        'cp0_number': cp0_number,
+        'encoding_name': encoding_name,
+        'full_name': f'CP{cp0_number} ({encoding_name})'
+    }
+
+# 测试调用
+if __name__ == "__main__":
+    cp0_info = get_cp0_value()
+    print("CP0 对应的实际编码信息：")
+    print(f"- 代码页编号: {cp0_info['cp0_number']}")
+    print(f"- 编码名称: {cp0_info['encoding_name']}")
+    print(f"- 完整标识: {cp0_info['full_name']}")

console_default_encoding-0.0.1.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: console-default-encoding
+Version: 0.0.1
+Summary: get default encoding in current console in python.
+License: MIT
+License-File: LICENSE
+Author: GGN_2015
+Author-email: neko@jlulug.org
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Description-Content-Type: text/markdown
+
+# console-default-encoding
+get default encoding in current console in python.
+
+## Install
+
+```bash
+pip install console-default-encoding
+```
+
+## Usage
+
+```python
+import console_default_encoding
+
+# utf-8, gbk ...
+print(console_default_encoding.get_console_default_encoding())
+```
+

console_default_encoding-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+console_default_encoding/__init__.py,sha256=zZzJnfxOb-rMA-Khly_y6s1-oO6SGUxW2PKjHTljDyw,104
+console_default_encoding/con_de.py,sha256=6cChXDWP3O8QL8aT1Yqk20nvWsc0mVx-7tA9c_ElXx4,3562
+console_default_encoding/get_cp0.py,sha256=H0bWr9bB4ouyu-ZTRq_6gCGyhta6dDszuY12r_qoU7s,1718
+console_default_encoding-0.0.1.dist-info/licenses/LICENSE,sha256=gmkEFqkF3KJjRnhXGoLSfX4xXtfPHT1ghq3YgCF7B3w,1086
+console_default_encoding-0.0.1.dist-info/METADATA,sha256=JW8xAcYg-GfhWMO8wgBAToT5DyPuSlndmFSJ3pAfhvQ,908
+console_default_encoding-0.0.1.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+console_default_encoding-0.0.1.dist-info/RECORD,,

console_default_encoding-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.1
+Root-Is-Purelib: true
+Tag: py3-none-any

console_default_encoding-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GGN_2015
+
+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.