From 778bc44053bd105beb141801128374949cc22bd8 Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Mon, 3 Nov 2025 01:09:33 +0000 Subject: [PATCH] Add README.md --- README.en.md | 59 ++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 122 insertions(+) create mode 100644 README.en.md create mode 100644 README.md diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000..da51e4c --- /dev/null +++ b/README.en.md @@ -0,0 +1,59 @@ +# jslogweb + +jslogweb is a Cangjie language project designed for logging and management, catering to modern software development logging requirements. It offers flexible configuration and efficient log processing capabilities, making it suitable for a wide range of scenarios. + +## Project Structure + +This project comprises multiple modules and subprojects, structured as follows: + +- **pkg/SeedHTTP**: An HTTP framework built in Cangjie language, providing foundational web service functionality. +- **pkg/cangjie-mysql-driver**: A MySQL database driver implementation for connecting to and operating MySQL databases. +- **pkg/hyperion**: Provides high-performance network communication capabilities, supporting TCP, buffer management, and log adaptation features. +- **pkg/jlog**: The logging module, offering log recording functionality with support for debugging and log output. +- **pkg/jorm**: An Object-Relational Mapping (ORM) module that simplifies database operations. +- **pkg/redis-sdk**: A Redis client implementation supporting multiple Redis deployment modes, including single instance, sentinel, and cluster. +- **pkg/tea**: A lightweight web framework providing routing, middleware, and configuration management features. +- **pkg/yaml**: A YAML file parsing and generation module for handling configuration files. + +## Quick Start + +### Environment Preparation + +1. Install the Cangjie language development environment. +2. Ensure necessary dependencies (such as MySQL and Redis) are installed on your system. + +### Build and Run + +1. Clone the project locally: + ```bash + git clone https://gitee.com/jslog/jslogweb.git + ``` + +2. Navigate to the project directory and build: + ```bash + cd jslogweb + cjpm build + ``` + +3. Run the project: + ```bash + cjpm run + ``` + +## Documentation and Support + +- [Redis Cangjie Language Client User Guide](pkg/redis-sdk/docs/Redis_SDK_User_Guide.md): Details the usage and features of the Redis client. +- [SeedHTTP Design Document](pkg/SeedHTTP/doc/design.md): Describes the design and implementation of the SeedHTTP module. +- [Hyperion Documentation](pkg/hyperion/docs/images): Provides architecture diagrams and design explanations for the Hyperion framework. + +## Contribution Guidelines + +Contributions of code and documentation are welcome. Please follow these steps: + +1. Fork this project. +2. Create a new branch and commit your changes. +3. Submit a Pull Request. + +## License + +This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..1f884db --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ +根据代码库中的信息,以下为生成的 README.md 文件内容: + +``` +# jslogweb + +jslogweb 是一个用于日志记录与管理的仓颉语言项目,适用于现代软件开发中的日志需求。它提供了灵活的配置和高效的日志处理能力,可广泛应用于不同场景。 + +## 项目结构 + +本项目包含多个模块和子项目,具体结构如下: + +- **pkg/SeedHTTP**:一个基于仓颉语言的 HTTP 框架,提供 Web 服务的基础功能。 +- **pkg/cangjie-mysql-driver**:MySQL 数据库驱动实现,用于连接和操作 MySQL 数据库。 +- **pkg/hyperion**:提供高性能网络通信能力,支持 TCP、缓冲区管理、日志适配等功能。 +- **pkg/jlog**:日志模块,提供日志记录功能,支持调试和日志输出。 +- **pkg/jorm**:对象关系映射(ORM)模块,简化数据库操作。 +- **pkg/redis-sdk**:Redis 客户端实现,支持单实例、哨兵模式、集群模式等多种 Redis 部署方式。 +- **pkg/tea**:轻量级 Web 框架,提供路由、中间件、配置管理等功能。 +- **pkg/yaml**:YAML 文件解析与生成模块,支持配置文件处理。 + +## 快速开始 + +### 环境准备 + +1. 安装仓颉语言开发环境。 +2. 确保系统中已安装必要的依赖库(如 MySQL、Redis 等)。 + +### 构建与运行 + +1. 克隆项目到本地: + ```bash + git clone https://gitee.com/jslog/jslogweb.git + ``` + +2. 进入项目目录并构建: + ```bash + cd jslogweb + cjpm build + ``` + +3. 运行项目: + ```bash + cjpm run + ``` + +## 文档与支持 + +- [Redis仓颉语言客户端用户手册](pkg/redis-sdk/docs/Redis_SDK_User_Guide.md):详细介绍了 Redis 客户端的使用方法和特性。 +- [SeedHTTP 设计文档](pkg/SeedHTTP/doc/design.md):介绍 SeedHTTP 模块的设计与实现。 +- [Hyperion 文档](pkg/hyperion/docs/images):提供 Hyperion 框架的架构图和设计说明。 + +## 贡献指南 + +欢迎贡献代码和文档。请遵循以下步骤: + +1. Fork 本项目。 +2. 创建新分支并提交更改。 +3. 提交 Pull Request。 + +## 许可证 + +本项目采用 MIT 许可证。详情请参见 [LICENSE](LICENSE) 文件。 +``` \ No newline at end of file -- Gitee