fix CI: Limit GitHub Actions' Python matrix to 3.10+, since using match syntax

Author: for13to1

.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.10', '3.11', '3.12']
 
     steps:
     - uses: actions/checkout@v4
@@ -26,7 +26,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -e .[test]
+        pip install -e .[dev]
 
     - name: Lint with flake8
       run: |

CHANGELOG.md

@@ -10,13 +10,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2026-01-08
 
 ### Added
+
 - Python code obfuscation with AST-based transformation
   - Variable, function, and class name obfuscation
   - Docstring obfuscation
   - Smart identifier classification (preserves imports and built-ins)
   - **Lossless restoration** via embedded source chunks
   - Embedded metadata support for key-free restoration
-  
+
 - C code obfuscation with regex-based tokenization
   - Identifier renaming (variables, functions, structs)
   - Comment scrambling
@@ -43,6 +44,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for both Python 3.8+ and C code
 
 ### Technical Details
+
 - Lossless restoration uses zlib compression + base64 encoding
 - Source chunks distributed as comments (`#@mistode:chunk:` for Python, `// @mistode:chunk:` for C)
 - Metadata embedded as `#@mistode:metadata:` or `/* @mistode:metadata: */`

CONTRIBUTING.md

@@ -5,17 +5,20 @@ Thank you for your interest in the Mistode project! We welcome contributions of
 ## Development Environment Setup
 
 1. Clone the project:
+
    ```shell
    git clone https://github.com/for13to1/mistode.git
    cd mistode
    ```
 
 2. Install development dependencies:
+
    ```shell
    pip install -e ".[dev]"
    ```
 
 3. Run tests:
+
    ```shell
    pytest tests/ -v
    ```

CONTRIBUTING_ZH.md

@@ -5,17 +5,20 @@
 ## 开发环境设置
 
 1. 克隆项目：
+
    ```shell
    git clone https://github.com/for13to1/mistode.git
    cd mistode
    ```
 
 2. 安装开发依赖：
+
    ```shell
    pip install -e ".[dev]"
    ```
 
 3. 运行测试：
+
    ```shell
    pytest tests/ -v
    ```
@@ -48,4 +51,4 @@
 1. 确保所有测试通过
 2. 添加新功能的测试用例
 3. 更新文档
-4. 遵循现有的代码风格
+4. 遵循现有的代码风格

README.md

@@ -11,24 +11,24 @@ Mistode (Mist Code, pronounced like "Miss Told") is a lightweight code obfuscati
 ## Features
 
 - **Encrypted Token Generator**: Highly customizable encrypted token generation supporting various configurations:
-    - **Random Seed**: Supports setting a random seed to ensure reproducibility.
-    - **Length Control**: Custom token length, range [8, 32] characters.
-    - **Style Configuration**: Supports two obfuscation styles:
-        - **Similar Character Style**: Uses visually similar character groups to enhance obfuscation (e.g., `Oo0`, `iIlL1`, `b6B8`, `Zz2`, `Ss5`).
-        - **Random Character Style**: Uses random alphanumeric combinations.
-    - **Smart Deduplication**: Automatically maintains a set of generated tokens to avoid duplicates.
-    - **Safe First Character**: Ensures the first character is not a digit, complying with naming conventions.
+  - **Random Seed**: Supports setting a random seed to ensure reproducibility.
+  - **Length Control**: Custom token length, range [8, 32] characters.
+  - **Style Configuration**: Supports two obfuscation styles:
+    - **Similar Character Style**: Uses visually similar character groups to enhance obfuscation (e.g., `Oo0`, `iIlL1`, `b6B8`, `Zz2`, `Ss5`).
+    - **Random Character Style**: Uses random alphanumeric combinations.
+  - **Smart Deduplication**: Automatically maintains a set of generated tokens to avoid duplicates.
+  - **Safe First Character**: Ensures the first character is not a digit, complying with naming conventions.
 - **Python Support**:
-    - **AST Parsing**: Accurate obfuscation based on Abstract Syntax Trees, ensuring complete preservation of code format.
-    - **Smart Identifier Classification**: Automatically identifies and preserves imported modules, functions, and built-in methods.
-    - **Docstring Obfuscation**: Replaces docstrings with hash values.
-    - **Fully Reversible**: Supports full restoration using generated key files or embedded metadata.
-    - **Lossless Restoration**: Achieves lossless consistency with the original file (preserving all comments and formatting) via distributed annotated injection of source chunks.
+  - **AST Parsing**: Accurate obfuscation based on Abstract Syntax Trees, ensuring complete preservation of code format.
+  - **Smart Identifier Classification**: Automatically identifies and preserves imported modules, functions, and built-in methods.
+  - **Docstring Obfuscation**: Replaces docstrings with hash values.
+  - **Fully Reversible**: Supports full restoration using generated key files or embedded metadata.
+  - **Lossless Restoration**: Achieves lossless consistency with the original file (preserving all comments and formatting) via distributed annotated injection of source chunks.
 - **C Support**:
-    - **Fast Tokenization**: Uses robust regular expression tokenizers.
-    - **Comment Obfuscation**: Obfuscates `//` and `/* */` comment content.
-    - **Compilation Safety**: Preserves keywords, preprocessor directives, and string literals (ensuring safety).
-    - **Lossless Restoration**: Achieves lossless consistency with the original file via distributed annotated injection of source chunks.
+  - **Fast Tokenization**: Uses robust regular expression tokenizers.
+  - **Comment Obfuscation**: Obfuscates `//` and `/* */` comment content.
+  - **Compilation Safety**: Preserves keywords, preprocessor directives, and string literals (ensuring safety).
+  - **Lossless Restoration**: Achieves lossless consistency with the original file via distributed annotated injection of source chunks.
 
 ## Installation
 
@@ -73,6 +73,7 @@ Mistode intelligently identifies and avoids obfuscating the following types of i
 ### Example
 
 **Original Code**:
+
 ```python
 import re
 from openpyxl.utils import get_column_letter, column_index_from_string
@@ -85,6 +86,7 @@ def shift_column_letter(base_column, offset):
 ```
 
 **Obfuscated Code**:
+
 ```python
 import re
 from openpyxl.utils import get_column_letter, column_index_from_string
@@ -103,8 +105,8 @@ def Oo0iIlL1b6B8Zz2Ss5(Oo0iIlL1b6B8Zz2Ss6, Oo0iIlL1b6B8Zz2Ss7):
 
 Mistode uses a two-layer restoration mechanism:
 
-1.  **Distributed Source Chunks (`#@mistode:chunk:` or `// @mistode:chunk:`)**: The original source code is compressed, encoded, and injected as chunks before each line of the obfuscated code. Restoration prioritizes these chunks to reconstruct the original code, achieving **lossless restoration** (including all comments, empty lines, and formatting).
-2.  **Embedded Metadata (`#@mistode:metadata:`)**: Contains the identifier mapping table as a backup restoration method.
+1. **Distributed Source Chunks (`#@mistode:chunk:` or `// @mistode:chunk:`)**: The original source code is compressed, encoded, and injected as chunks before each line of the obfuscated code. Restoration prioritizes these chunks to reconstruct the original code, achieving **lossless restoration** (including all comments, empty lines, and formatting).
+2. **Embedded Metadata (`#@mistode:metadata:`)**: Contains the identifier mapping table as a backup restoration method.
 
 This means you can perfectly restore the original code even without keeping the key file.
 
@@ -119,7 +121,7 @@ If no key file is provided, the restore command automatically detects and uses t
 
 ## Project Structure
 
-```
+```shell
 mistode/
 ├── src/
 │   └── mistode/

README_ZH.md

@@ -11,24 +11,24 @@ Mistode (Mist Code, pronounced like "Miss Told") 是一个轻量级的代码混
 ## 特性
 
 - **加密token生成器**: 高度可定制的加密token生成，支持多种配置：
-    - **随机种子**：支持设置随机种子，确保生成结果的可重现性
-    - **长度控制**：自定义token长度，范围[8,32]字符
-    - **风格配置**：支持两种混淆风格
-        - **近似字符风格**：使用易混淆字符组增强混淆效果（如：`Oo0`, `iIlL1`, `b6B8`, `Zz2`, `Ss5`）
-        - **随机字符风格**：使用随机字母数字组合
-    - **智能去重机制**：自动维护已生成token集合，避免重复
-    - **首字符安全**：确保首字符不是数字，符合编程规范
+  - **随机种子**：支持设置随机种子，确保生成结果的可重现性
+  - **长度控制**：自定义token长度，范围[8,32]字符
+  - **风格配置**：支持两种混淆风格
+    - **近似字符风格**：使用易混淆字符组增强混淆效果（如：`Oo0`, `iIlL1`, `b6B8`, `Zz2`, `Ss5`）
+    - **随机字符风格**：使用随机字母数字组合
+  - **智能去重机制**：自动维护已生成token集合，避免重复
+  - **首字符安全**：确保首字符不是数字，符合编程规范
 - **Python 支持**:
-    - **AST 解析**: 基于抽象语法树的精确混淆，确保代码格式完全保留
-    - **智能标识符分类**: 自动识别并保留导入的模块、函数和内置方法
-    - **文档字符串混淆**: 将文档字符串替换为哈希值
-    - **完全可逆**: 支持使用生成的密钥文件或嵌入的元数据完全恢复
-    - **无损还原 (Lossless Restoration)**: 通过分布式注释注入原始源代码，实现与原文件一致的无损还原（保留所有注释和格式）
+  - **AST 解析**: 基于抽象语法树的精确混淆，确保代码格式完全保留
+  - **智能标识符分类**: 自动识别并保留导入的模块、函数和内置方法
+  - **文档字符串混淆**: 将文档字符串替换为哈希值
+  - **完全可逆**: 支持使用生成的密钥文件或嵌入的元数据完全恢复
+  - **无损还原 (Lossless Restoration)**: 通过分布式注释注入原始源代码，实现与原文件一致的无损还原（保留所有注释和格式）
 - **C 支持**:
-    - **快速分词**: 使用健壮的正则表达式分词器
-    - **注释混淆**: 混淆 `//` 和 `/* */` 注释内容
-    - **编译安全**: 保留关键字、预处理指令和字符串字面量（确保安全）
-    - **无损还原 (Lossless Restoration)**: 通过分布式注释注入原始源代码，实现与原文件一致的无损还原
+  - **快速分词**: 使用健壮的正则表达式分词器
+  - **注释混淆**: 混淆 `//` 和 `/* */` 注释内容
+  - **编译安全**: 保留关键字、预处理指令和字符串字面量（确保安全）
+  - **无损还原 (Lossless Restoration)**: 通过分布式注释注入原始源代码，实现与原文件一致的无损还原
 
 ## 安装
 
@@ -66,13 +66,14 @@ mistode restore output.py --out restored.py --key mapping.json
 Mistode 能够智能识别以下类型的标识符并避免混淆：
 
 - **内置模块**: `re`, `os`, `sys`, `json`, `math` 等
-- **内置函数**: `print`, `len`, `range`, `str`, `int` 等  
+- **内置函数**: `print`, `len`, `range`, `str`, `int` 等
 - **导入的函数**: 从 `import` 和 `from ... import` 语句中导入的函数
 - **内置方法**: `re.sub`, `str.strip`, `list.append` 等
 
 ### 示例
 
 **原始代码**:
+
 ```python
 import re
 from openpyxl.utils import get_column_letter, column_index_from_string
@@ -85,6 +86,7 @@ def shift_column_letter(base_column, offset):
 ```
 
 **混淆后的代码**:
+
 ```python
 import re
 from openpyxl.utils import get_column_letter, column_index_from_string
@@ -103,10 +105,11 @@ def Oo0iIlL1b6B8Zz2Ss5(Oo0iIlL1b6B8Zz2Ss6, Oo0iIlL1b6B8Zz2Ss7):
 
 Mistode 采用两层恢复机制：
 
-1.  **分布式源码块 (`#@mistode:chunk:` 或 `// @mistode:chunk:`)**: 将原始源代码压缩、编码并分块注入到混淆代码的每一行之前。恢复时优先使用这些块重组原始代码，实现**无损还原**（包括所有注释、空行和格式）。
-2.  **嵌入式元数据 (`#@mistode:metadata:`)**: 包含标识符映射表，作为备用恢复手段。
+1. **分布式源码块 (`#@mistode:chunk:` 或 `// @mistode:chunk:`)**: 将原始源代码压缩、编码并分块注入到混淆代码的每一行之前。恢复时优先使用这些块重组原始代码，实现**无损还原**（包括所有注释、空行和格式）。
+2. **嵌入式元数据 (`#@mistode:metadata:`)**: 包含标识符映射表，作为备用恢复手段。
 
 这意味着即使不保留密钥文件，您也可以完美恢复原始代码。
+
 ```python
 # ... 混淆后的代码 ...
 #@mistode:chunk:eJzjSk... (分布式源码块)
@@ -118,7 +121,7 @@ Mistode 采用两层恢复机制：
 
 ## 项目结构
 
-```
+```shell
 mistode/
 ├── src/
 │   └── mistode/

SECURITY.md

@@ -5,7 +5,7 @@
 If you discover a security vulnerability, please report it via the following methods:
 
 - **Do NOT** report security issues in public Issues.
-- Please contact the maintainer via email: for13to1@outlook.com
+- Please contact the maintainer via email: <for13to1@outlook.com>
 
 ## Response Time
 

SECURITY_ZH.md

@@ -5,7 +5,7 @@
 如果您发现安全漏洞，请通过以下方式报告：
 
 - **不要**在公开的 Issues 中报告安全问题
-- 请通过电子邮件联系维护者：for13to1@outlook.com
+- 请通过电子邮件联系维护者：<for13to1@outlook.com>
 
 ## 响应时间
 
@@ -35,4 +35,4 @@
 1. **生产环境使用**：在部署到生产环境前充分测试混淆后的代码
 2. **备份原始代码**：始终保留原始代码的备份
 3. **版本控制**：将混淆后的代码和映射文件纳入版本控制
-4. **安全审计**：定期审计混淆后的代码以确保安全性
+4. **安全审计**：定期审计混淆后的代码以确保安全性

src/mistode/c.py

@@ -440,9 +440,8 @@ def obfuscate(self, source_code: str) -> str:
             "encryption_key": self.mm.encryption_key,
             "string_quote_types": self.mm.string_quote_types,
         }
-        encoded = base64.b64encode(
-            json.dumps(mapping_info).encode("utf-8")
-        ).decode("utf-8")
+        json_bytes = json.dumps(mapping_info).encode("utf-8")
+        encoded = base64.b64encode(json_bytes).decode("utf-8")
 
         # 4. Inject Original Source (Lossless restoration)
         obfuscated_text = "".join(output)