English:

Requests-GUI - Unofficial GUI Client for Requests

Unofficial community-maintained GUI client for the popular Python HTTP library Requests. Convert complex command-line HTTP requests into an intuitive visual interface, supporting common methods like GET/POST/PUT/DELETE, with built-in bilingual (Chinese/English) interface support.

🌟 Key Features

• Multi-Method Support: Switch between GET/POST/PUT/DELETE via a dropdown menu.
• Flexible Input:
  • Query Parameters: Accepts both key-value pairs (key=value&key=value) and JSON format.
  • Request Body: Supports raw text or JSON input.
• Smart Headers: Edit headers in a table (Key-Value pairs), auto-converted to Requests' CaseInsensitiveDict.
• Response Visualization: Displays status codes, formatted headers, and beautified response content (JSON/HTML auto-formatting via jsbeautifier).
• Async Requests: Uses PySide6's QThread to prevent UI freezing during network calls.
• Bilingual Interface: Switch between Simplified Chinese and English directly in the UI (no separate folders required).

🚀 Quick Start

Option 1: Download Prebuilt EXE (Recommended)

No Python or dependencies required:

1. Go to the Releases page.
2. Download Requests-GUI-EXE.zip and extract it.
3. You’ll find two executables: Requests-GUI-EN.exe (English) and Requests-GUI-CN.exe (Chinese). Double-click your preferred version to run.

Option 2: Run from Source Code

For developers or custom needs:

Prerequisites

• Python 3.8+
• Required packages:

  pip install pyside6 requests jsbeautifier  

Steps

1. Download the source code:

   • Click Code → Download ZIP on the GitHub repo (no Git needed).
   • Extract the ZIP file to your preferred location.

2. Run the program:

   cd Requests-GUI  # Navigate to the project root  
   python main.py   # Launch the application (default language set in config)  

   • To switch languages: Use the language selector in the UI (top-right corner).

📦 Package into EXE (Custom Build)

Use pyinstaller to create a standalone EXE (install via pip install pyinstaller first).

Example Command (Windows):

# Navigate to the project root  
cd Requests-GUI  

# Package for English version  
pyinstaller -w -F -i assets/gui-en.ico --add-data "assets/gui-en.ico;assets" main.py  

# Package for Chinese version  
pyinstaller -w -F -i assets/gui-cn.ico --add-data "assets/gui-cn.ico;assets" main.py  

# Parameters:  
# -w: Hide console window (for GUI apps).  
# -F: Generate a single EXE file.  
# -i: Set window icon (specify English/Chinese icon).  
# --add-data: Include language-specific assets.  

Note for macOS/Linux: Replace ; with : in --add-data (e.g., --add-data "assets/gui-en.ico:assets").

🖥 Interface Overview

(Switch between English and Chinese via the language selector in the top-right corner. All features are identical across languages.)

📘 Usage Examples

Example 1: Sending a GET Request with Query Parameters

Goal: Send a GET request to https://httpbin.org/get with parameters name=John&age=30.

Steps:

1. Select GET from the method dropdown.
2. Enter https://httpbin.org/get in the URL field.
3. Go to the Query Parameters tab and enter name=John&age=30 (or JSON {"name": "John", "age": 30}).
4. (Optional) Add a header: User-Agent: Requests-GUI in the Headers table.
5. Click Send Request.

Expected Response:

• Status code: 200 OK.
• Response content will show args with the parameters:

  {  
    "age": "30",  
    "name": "John"  
  }  

Example 2: Sending a POST Request with Form Data

Goal: Submit form data username=admin&password=secret to https://httpbin.org/post.

Steps:

1. Select POST from the method dropdown.
2. Enter https://httpbin.org/post in the URL field.
3. Go to the Request Body tab and enter username=admin&password=secret.
4. Add a header: Content-Type: application/x-www-form-urlencoded.
5. Click Send Request.

Expected Response:

• Status code: 200 OK.
• Response content will show form with the submitted data:

  {  
    "password": "secret",  
    "username": "admin"  
  }  

Example 3: Sending a POST Request with JSON Data

Goal: Send JSON {"email": "user@example.com", "active": true} to https://httpbin.org/post.

Steps:

1. Select POST from the method dropdown.
2. Enter https://httpbin.org/post in the URL field.
3. Go to the Request Body tab and enter:

   {"email": "user@example.com", "active": true}  

4. Add a header: Content-Type: application/json.
5. Click Send Request.

Expected Response:

• Status code: 200 OK.
• Response content will show json with the submitted data (auto-beautified).

Example 4: Handling Request Errors

Goal: Test error handling with an invalid URL.

Steps:

1. Select any method (e.g., GET).
2. Enter https://invalid-domain.com in the URL field.
3. Click Send Request.

Expected Response:

• Status code will show an error (e.g., ConnectionError).
• Response content will display the detailed error message (e.g., "Could not resolve host").

📜 License

This project is licensed under the Apache License 2.0.

🙋 Contributing & Feedback

• Bug Reports/Feature Requests: Submit an Issue.
• Code Contributions: Fork the repo, make changes, and submit a PR.
• Localization: Add new languages by contributing translation files (stored in locales/).

---

中文：

Requests-GUI - Requests 的非官方图形化客户端

非官方社区维护的 Python HTTP 库 Requests 图形化客户端。将复杂的命令行 HTTP 请求转换为直观的可视化界面，支持 GET/POST/PUT/DELETE 等常用方法，并内置中英文双语界面。

🌟 核心功能

• 多方法支持：通过下拉菜单切换 GET/POST/PUT/DELETE。
• 灵活输入：
  • 查询参数：支持键值对（key=value&key=value）或 JSON 格式。
  • 请求体：支持纯文本或 JSON 输入。
• 智能请求头：通过表格编辑请求头（键值对），自动转换为 Requests 的 CaseInsensitiveDict（键不区分大小写）。
• 响应可视化：显示状态码、格式化响应头，并通过 jsbeautifier 自动美化 JSON/HTML 响应内容。
• 异步请求：使用 PySide6 的 QThread 实现异步发送，避免界面卡顿。
• 双语界面：直接在界面中切换简体中文与英文（无需分开文件夹）。

🚀 快速开始

方式 1：下载预打包 EXE（推荐）

无需安装 Python 或依赖：

1. 前往 Releases 页面。
2. 下载 Requests-GUI-EXE.zip 并解压。
3. 解压后将看到两个可执行文件：Requests-GUI-EN.exe（英文）和 Requests-GUI-CN.exe（中文）。选择版本双击运行。

方式 2：从源代码运行

适合开发者或需要自定义的用户：

环境要求

• Python 3.8 及以上
• 安装依赖：

  pip install pyside6 requests jsbeautifier  

步骤

1. 下载源代码：

   • 在 GitHub 仓库 点击 Code → 下载 ZIP（无需 Git）。
   • 解压 ZIP 文件至目标位置。

2. 运行程序：

   cd Requests-GUI  # 进入项目根目录  
   python main.py   # 启动程序（默认语言为配置语言）  

   • 切换语言：通过界面右上角的语言选择器切换（简体中文/英文）。

📦 打包为 EXE（自定义发布）

使用 pyinstaller 生成独立 EXE（先通过 pip install pyinstaller 安装）。

打包命令示例（Windows）：

# 进入项目根目录  
cd Requests-GUI  

# 打包英文版本  
pyinstaller -w -F -i assets/gui-en.ico --add-data "assets/gui-en.ico;assets" main.py  

# 打包中文版本  
pyinstaller -w -F -i assets/gui-cn.ico --add-data "assets/gui-cn.ico;assets" main.py  

# 参数说明：  
# -w：隐藏控制台窗口（图形界面程序推荐）。  
# -F：生成单个 EXE 文件（而非目录）。  
# -i：指定窗口图标（区分中英文图标）。  
# --add-data：包含语言相关资源文件。  

macOS/Linux 注意：--add-data 中路径分隔符改为冒号 :（如 --add-data "assets/gui-en.ico:assets"）。

🖥 界面概览

(通过右上角语言选择器切换中英文，所有功能完全一致。)

📘 使用示例

示例 1：发送带查询参数的 GET 请求

目标：向 https://httpbin.org/get 发送参数 name=张三&age=20。

步骤：

1. 下拉菜单选择 GET。
2. 在 URL 输入框填写 https://httpbin.org/get。
3. 切换到「查询参数」选项卡，输入 name=张三&age=20（或 JSON {"name": "张三", "age": 20}）。
4. （可选）在请求头表格添加 User-Agent: Requests-GUI。
5. 点击「发送请求」。

预期响应：

• 状态码：200 OK。
• 响应内容中 args 字段显示参数：

  {  
    "age": "20",  
    "name": "张三"  
  }  

示例 2：发送表单数据的 POST 请求

目标：向 https://httpbin.org/post 提交表单 username=test&password=123456。

步骤：

1. 选择 POST。
2. URL 填写 https://httpbin.org/post。
3. 切换到「请求体」选项卡，输入 username=test&password=123456。
4. 添加请求头 Content-Type: application/x-www-form-urlencoded。
5. 点击「发送请求」。

预期响应：

• 状态码：200 OK。
• 响应内容中 form 字段显示提交的数据：

  {  
    "password": "123456",  
    "username": "test"  
  }  

示例 3：发送 JSON 数据的 POST 请求

目标：向 https://httpbin.org/post 发送 JSON {"email": "test@example.com", "is_vip": true}。

步骤：

1. 选择 POST。
2. URL 填写 https://httpbin.org/post。
3. 切换到「请求体」选项卡，输入：

   {"email": "test@example.com", "is_vip": true}  

4. 添加请求头 Content-Type: application/json。
5. 点击「发送请求」。

预期响应：

• 状态码：200 OK。
• 响应内容中 json 字段显示提交的 JSON（自动格式化）。

示例 4：处理错误请求（如无效 URL）

目标：测试工具对错误 URL 的处理。

步骤：

1. 选择任意方法（如 GET）。
2. 输入错误 URL https://invalid-url.example.com。
3. 点击「发送请求」。

预期响应：

• 状态码显示错误信息（如 连接错误）。
• 响应内容显示详细错误（如 DNS 解析失败）。

📜 许可证

本项目采用 Apache 2.0 许可证。

🙋 贡献与反馈

• 问题反馈/功能建议：提交 Issue。
• 代码贡献：Fork 仓库，修改后提交 PR。
• 多语言支持：通过贡献翻译文件（存储于 locales/ 目录）添加新语言。