Metadata-Version: 2.4
Name: syncgate
Version: 0.8.1
Summary: Lightweight multi-storage routing and sync abstraction layer
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: boto3>=1.34.0
Requires-Dist: paramiko>=3.0.0
Requires-Dist: psycopg2-binary>=2.9.9
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# SyncGate 🎯

> 统一管理散落在各处的文件

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

## 🎯 产品定位

**SyncGate** 是轻量级多存储路由与同步抽象层，统一管理本地文件、HTTP 链接和 S3 对象存储。

### 核心功能

1. **🔗 统一路径** - 本地/HTTP/S3 一个命令访问
2. **🌳 虚拟文件系统** - 不移动源文件，只管理链接
3. **✅ 链接验证** - 自动验证链接有效性
4. **⚡ 无延迟** - 实时透传，不做缓存

### 支持的存储

| 存储类型 | 状态 | 说明 |
|----------|------|------|
| 本地文件 | ✅ | local:/path/to/file |
| HTTP/HTTPS | ✅ | https://example.com/file |
| AWS S3 | ✅ | s3://bucket/key |
| WebDAV | 🚧 | 计划中 |
| FTP/SFTP | 🚧 | 计划中 |

## 🚀 快速开始

### 安装

```bash
pip install syncgate
```

### 演示

```bash
python3 demo_complete.py
```

输出：
```
🎯 SyncGate Complete Demo
============================================================

📝 Step 1: 创建链接
  ✅ Local:  /docs/notes.txt
  ✅ HTTP:   /online/api.json
  ✅ S3:     /cloud/data.csv

📂 Step 2: 虚拟文件系统结构
virtual/
├── 📁 docs/  → local:/path/to/files
├── 📁 online/ → https://api.example.com
└── 📁 cloud/  → s3://my-bucket/data

🔍 Step 3: 链接验证
  ✅ /docs/notes.txt
  ✅ /online/api.json

✅ 演示完成!
```

### 使用

```bash
# 创建链接
syncgate link /docs/a.txt local:/path/to/file.txt local
syncgate link /online/api.json https://api.example.com/data.json http
syncgate link /cloud/data.csv s3://my-bucket/data/2024.csv s3

# 列出目录
syncgate ls /docs

# 树形结构
syncgate tree /

# 验证链接
syncgate validate /docs/a.txt

# 查看状态
syncgate status /docs/a.txt
```

## 📖 文档

- [Architecture](PROJECT.md) - 架构设计
- [API Reference](docs/api.md) - API 文档
- [Demo Output](DEMO_OUTPUT.md) - 演示输出

## 🛠️ 开发

```bash
# 克隆项目
git clone https://github.com/cyydark/syncgate.git
cd syncgate

# 运行演示
python3 demo_complete.py

# 运行测试
pytest tests/
```

## 📈 路线图

### v0.1.x (当前)

- [x] 核心框架
- [x] Local/HTTP/S3 后端
- [x] CLI 命令
- [x] 链接验证
- [ ] 推广素材 ⏳
- [ ] 首日发布 ⏳

### v0.2.x

- [ ] WebDAV 后端
- [ ] AI 元数据提取
- [ ] 向量搜索

### v1.0

- [ ] 完整测试覆盖
- [ ] 文档完善
- [ ] 首个正式版

## 🤝 贡献

欢迎提交 Issue 和 PR！

## 📄 许可

MIT License - see [LICENSE](LICENSE)

---

**SyncGate** - 统一管理散落在各处的文件 📁🌐☁️
