Metadata-Version: 2.4
Name: ailingues-messaging
Version: 0.1.0
Summary: A collection of reusable python core library from AI Lingues.
Author-email: AI Lingues <support@ailingues.com>
License: MIT
Keywords: AILingues,components,core,library
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: annotated-types~=0.7.0
Requires-Dist: pydantic~=2.12.5
Requires-Dist: pydantic_core~=2.41.5
Requires-Dist: redis~=7.1.0
Requires-Dist: typing-inspection~=0.4.2
Requires-Dist: typing_extensions~=4.15.0

# ailingues-messaging

[![Python Version](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-0.1.0-orange.svg)](https://github.com/ailingues/ailingues-messaging)

**ailingues-messaging** 是由 AI Lingues 开发的 Python 消息队列工具库，提供了一套完整、可靠、跨平台的消息队列基础组件，旨在帮助开发者快速构建稳定的 Python 应用程序。

---

## ✨ 核心特性

- 📨 **消息队列** - 基于 Redis 的异步消息框架，支持优先级、重试、确认机制

---

## 📦 安装

### 使用 pip 安装（推荐）

```bash
pip install ailingues-messaging
```

### 从源码安装

不支持

### 依赖要求

- Python >= 3.11
- Redis 服务（仅消息队列模块需要）

---

## 📚 模块说明

### 📨 Message（消息）

| 模块             | 功能                   | 文档                                  |
| ---------------- | ---------------------- | ------------------------------------- |
| `redis_queue`    | Redis 消息队列管理     | [message.md](docs/message/message.md) |
| `redis_sender`   | 消息发送器             | [message.md](docs/message/message.md) |
| `redis_receiver` | 消息接收器（异步处理） | [message.md](docs/message/message.md) |

---

## 📖 完整文档

详细的 API 文档请查看 [docs](docs/) 目录：

- [消息模块 API](docs/message/message.md)

---

## 🏗️ 项目结构

```
ailingues-messaging/
├── ailingues_messaging/           # 源代码
│   ├── network/          # 网络模块
│   ├── system/           # 系统信息模块
│   ├── message/          # 消息队列模块
│   ├── security/         # 安全加密模块
│   └── utils/            # 工具模块
├── docs/                 # API 文档
├── test/                 # 单元测试
├── pyproject.toml        # 项目配置
├── requirements.txt      # 依赖列表
└── README.md             # 本文件
```

---

## 📝 许可证与使用条款

### 软件包使用许可

**ailingues-messaging** 软件包（通过 pip 安装的二进制包）采用 **MIT License** 开源协议：

- ✅ **自由使用** - 可在个人项目、企业项目中自由使用
- ✅ **商业用途** - 允许用于商业产品和服务
- ✅ **自由分发** - 可自由分发和再分发软件包
- ✅ **无使用限制** - 无需支付任何费用或获得额外授权

### 源代码保护条款

**重要声明**：本项目的 **源代码为私有财产**，受知识产权法保护：

- ❌ **不公开源代码** - 源代码不对外公开
- ❌ **禁止逆向工程** - 严禁对软件包进行反编译、逆向工程或反汇编
- ❌ **禁止源码分发** - 不得以任何形式获取、复制或分发源代码
- ❌ **禁止修改重发布** - 不得修改软件包后重新发布

**简而言之**：您可以自由使用我们的软件包（包括商业用途），但请尊重我们的源代码知识产权。

---

## 📧 联系我们

- **官网**: [https://www.ailingues.com](https://www.ailingues.com)
- **邮箱**: support@ailingues.com
- **技术支持**: 如有问题或建议，请通过邮箱联系我们

---

**Made with ❤️ by AI Lingues Team**
