syncgate 0.8.1__tar.gz

syncgate-0.8.1/.github/workflows/ci.yml

@@ -0,0 +1,97 @@
+name: SyncGate CI/CD
+
+on:
+  push:
+    branches: [main]
+    paths-ignore:
+      - '**.md'
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -v
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: true
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Install linting tools
+        run: |
+          pip install black mypy
+
+      - name: Check code formatting
+        run: black --check syncgate/ tests/
+
+      - name: Type checking
+        run: mypy syncgate/
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+  notify:
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+    if: always()
+
+    steps:
+      - name: Send notification
+        run: |
+          echo "✅ Tests: ${{ needs.test.result }}"
+          echo "✅ Lint: ${{ needs.lint.result }}"

syncgate-0.8.1/.github/workflows/daily-promo.yml

@@ -0,0 +1,44 @@
+name: Daily SyncList Promotion
+
+on:
+  schedule:
+    - cron: '0 8 * * *'  # 每天 8:00 UTC
+  workflow_dispatch:
+
+jobs:
+  promote:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Install dependencies
+        run: |
+          pip install requests
+      
+      - name: Run auto promotion
+        env:
+          TWITTER_TOKEN: ${{ secrets.TWITTER_TOKEN }}
+          REDDIT_CLIENT_ID: ${{ secrets.REDDIT_CLIENT_ID }}
+          REDDIT_CLIENT_SECRET: ${{ secrets.REDDIT_CLIENT_SECRET }}
+        run: |
+          python auto_promo.py
+      
+      - name: Post daily stats
+        run: |
+          echo "## 📊 SyncList 每日推广" >> $GITHUB_STEP_SUMMARY
+          echo "- 时间: $(date)" >> $GITHUB_STEP_SUMMARY
+          echo "- 任务: Twitter + Reddit 推广" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "## 🔗 链接" >> $GITHUB_STEP_SUMMARY
+          echo "- GitHub: https://github.com/cyydark/syncgate" >> $GITHUB_STEP_SUMMARY
+          echo "- 演示: python3 ai_demo.py" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "## 📝 待手动执行" >> $GITHUB_STEP_SUMMARY
+          echo "- [ ] 制作视频: video-script.md" >> $GITHUB_STEP_SUMMARY
+          echo "- [ ] 收集反馈: feedback-form.md" >> $GITHUB_STEP_SUMMARY
+          echo "- [ ] 提交 HN: hn-submission.txt" >> $GITHUB_STEP_SUMMARY

syncgate-0.8.1/.github/workflows/daily-promotion.yml

@@ -0,0 +1,29 @@
+name: Daily Promotion
+
+on:
+  schedule:
+    - cron: '0 8 * * *'  # 每天 8:00 UTC
+  workflow_dispatch:
+
+jobs:
+  promote:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Send reminder
+        run: |
+          echo "🤖 Auto-Company Promotion Reminder"
+          echo ""
+          echo "SyncGate v0.1.0 is live!"
+          echo "GitHub: https://github.com/cyydark/syncgate"
+          echo ""
+          echo "TODO today:"
+          echo "1. [ ] Share on Twitter/X"
+          echo "2. [ ] Submit to Hacker News"
+          echo "3. [ ] Post on Reddit"
+          echo "4. [ ] Share on LinkedIn"
+          echo ""
+          echo "Marketing assets ready:"
+          echo "- twitter-thread.md"
+          echo "- hn-submission.txt"
+          echo "- reddit-post.txt"
+          echo "- devto-blog.md"

syncgate-0.8.1/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [created]
+  push:
+    branches:
+      - main
+    paths:
+      - 'syncgate/**'
+      - 'pyproject.toml'
+
+jobs:
+  pypi-publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        python-version: '3.11'
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+    - name: Build package
+      run: |
+        python -m build
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}

syncgate-0.8.1/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.env
+.venv
+env/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+*.db
+*.log
+.DS_Store

syncgate-0.8.1/CHANGELOG.md

@@ -0,0 +1,336 @@
+# CHANGELOG
+
+## [0.8.1] - 2025-01-20
+
+### Added
+
+- **文档完善** - Cycle #38
+  - `USAGE.md` - 完整使用指南
+  - `QUICK_START.md` - 5 分钟快速开始
+
+### Documentation
+
+| 文档 | 说明 |
+|------|------|
+| README.md | 项目介绍 |
+| QUICK_START.md | **5 分钟快速开始** |
+| USAGE.md | **完整使用指南** |
+| PROJECT.md | 架构设计 |
+
+---
+
+## [0.8.0] - 2025-01-20
+
+### Added
+
+- **功能补齐** - Cycle #37
+  - `syncgate/batch.py` - 批量操作
+  - `syncgate/monitor.py` - 监控和统计
+  - `syncgate/error_handler.py` - 错误处理和重试
+  - `tests/test_batch.py` - 7 个测试
+  - `tests/test_monitor.py` - 12 个测试
+
+### 新功能
+
+| 模块 | 功能 |
+|------|------|
+| Batch | 批量创建/删除/验证链接 |
+| Batch | 导入/导出配置 |
+| Monitor | 统计收集和健康评分 |
+| Monitor | 性能监控 |
+| Error | 重试机制 |
+| Error | 熔断器 |
+| Error | 错误日志 |
+
+---
+
+## [0.7.0] - 2025-01-20
+
+### Added
+
+- **Webhook 通知** - 支持外部通知
+  - `syncgate/webhook.py` - Webhook 管理器
+  - `tests/test_webhook.py` - 10 个测试
+
+### Webhook 功能
+
+| 功能 | 说明 |
+|------|------|
+| 事件通知 | link.created, link.deleted, validate |
+| 多 webhook | 支持多个通知端点 |
+| 事件过滤 | 只订阅需要的事件 |
+
+---
+
+## [0.6.1] - 2025-01-20
+
+### Added
+
+- **推广执行** - Cycle #35
+  - `promote.sh.py` - 一键推广脚本
+  - `HN_SUBMISSION_V2.md` - HN 提交内容
+
+### Changed
+
+- 执行推广计划
+
+---
+
+## [0.6.0] - 2025-01-20
+
+### Added
+
+- **REST API Server** - 支持程序化访问
+  - `syncgate/api.py` - REST API 服务器
+  - `tests/test_api.py` - 6 个 API 测试
+  - 支持 CRUD 操作 (创建/读取/更新/删除链接)
+
+### API 端点
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | /api/stats | 获取统计 |
+| GET | /api/links/<path> | 获取链接信息 |
+| POST | /api/links | 创建链接 |
+| DELETE | /api/links/<path> | 删除链接 |
+
+### 运行 API
+
+```bash
+python -m syncgate.api --port 8080
+```
+
+---
+
+## [0.5.0] - 2025-01-20
+
+### Added
+
+- **CLI Enhancement** - 增强命令行工具
+  - `syncgate/utils.py` - 配置管理和日志工具
+  - Config 类 - 配置文件管理
+  - ProgressBar 类 - 进度条
+  - Logger 类 - 彩色日志输出
+  - config 命令 - 管理配置
+
+### Changed
+
+- CLI 支持新的 config 子命令
+
+---
+
+## [0.4.0] - 2025-01-20
+
+### Added
+
+- **FTP Backend** - 支持 FTP 服务器
+  - `syncgate/backend/ftp.py` - FTP 后端实现
+  - `tests/test_ftp.py` - 5 个测试
+
+- **SFTP Backend** - 支持 SFTP 服务器
+  - `syncgate/backend/sftp.py` - SFTP 后端实现
+  - 依赖: paramiko>=3.0.0
+
+### Changed
+
+- **Total Tests: 33** (新增 5 个 FTP 测试)
+
+---
+
+## [0.3.0] - 2025-01-20
+
+### Added
+
+- **WebDAV Backend** - 支持 NAS/云存储
+  - `syncgate/backend/webdav.py` - WebDAV 后端实现
+  - `tests/test_webdav.py` - 6 个测试
+  - 支持 PROPFIND/PUT/HEAD/MKCOL 等 WebDAV 方法
+
+### Changed
+
+- **Total Tests: 28** (新增 6 个 WebDAV 测试)
+- 修复 pyproject.toml 重复配置
+
+---
+
+## [0.2.4] - 2025-01-20
+
+### Changed
+
+- **推广执行** - Cycle #30
+  - Twitter 推广准备就绪
+  - Hacker News 提交准备就绪
+  - Reddit 发布准备就绪
+
+### 推广状态
+
+| 渠道 | 状态 |
+|------|------|
+| Twitter | ✅ 推文已准备 |
+| Hacker News | ✅ 提交内容已准备 |
+| Reddit | ✅ 帖子已准备 |
+
+---
+
+## [0.2.3] - 2025-01-20
+
+### Changed
+
+- **CI/CD 优化**
+  - 添加 coverage 配置 (pyproject.toml)
+  - 优化工作流 (notify job)
+  - 支持多 Python 版本 (3.10, 3.11, 3.12)
+  - 添加 codecov 集成
+
+### CI/CD Features
+
+| 功能 | 状态 |
+|------|------|
+| 多版本测试 | ✅ 3.10, 3.11, 3.12 |
+| Lint (black/mypy) | ✅ |
+| Coverage | ✅ |
+| Auto PyPI Publish | ✅ |
+| Notifications | ✅ |
+
+---
+
+## [0.2.2] - 2025-01-20
+
+### Added
+
+- **AI Module Tests** - 9 new tests for AI functionality
+  - test_simple_embedding
+  - test_embedding_vector
+  - test_ai_module_init
+  - test_extract_metadata
+  - test_index_content
+  - test_search
+  - test_cosine_similarity
+  - test_get_metadata
+  - test_list_indexed
+
+### Changed
+
+- **Total Tests: 22 passing** (9 new + 13 existing)
+
+---
+
+## [0.2.1] - 2025-01-20
+
+### Changed
+
+- **代码重构** - 提取 BaseBackend 基类
+- **代码减少 25%** - 437 行 → 327 行
+- **减少重复代码** - 数据库操作集中到 BaseBackend
+
+### Optimization
+
+| 文件 | 优化前 | 优化后 | 减少 |
+|------|--------|--------|------|
+| local.py | 135 行 | 70 行 | 48% |
+| http.py | 125 行 | 67 行 | 46% |
+| s3.py | 177 行 | 119 行 | 33% |
+| base.py | - | 71 行 | - |
+| **总计** | **437 行** | **327 行** | **25%** |
+
+---
+
+## [0.2.0] - 2025-01-20
+
+### Added
+
+- **AI Module** - 元数据管理和语义搜索
+  - `syncgate/ai/__init__.py` - AI 模块核心
+  - `ai_demo.py` - 演示脚本
+  - 元数据提取 (大小、字数、编码)
+  - 简单向量嵌入 (词袋模型)
+  - 语义搜索 (余弦相似度)
+
+### Changed
+
+- 代码提交统计: 6 次提交 (Cycle #22-26)
+
+---
+
+## [0.1.4] - 2025-01-20
+
+### Added
+
+- **PROMO.md** - 推广文案 (Twitter/HN/Reddit)
+- **DEMO_OUTPUT.md** - 演示输出截图
+- **README.md v2** - 优化后的项目介绍
+
+### Changed
+
+- README: SyncList → SyncGate
+- README: 添加支持存储类型表格
+- README: 添加使用示例
+
+---
+
+## [0.1.2] - 2025-01-20
+
+### Added
+
+- **demo_complete.py** - Complete demo with all backends
+- **S3Backend 测试** - Verified S3 URL parsing works
+- **多后端演示** - Local + HTTP + S3
+
+### Verified
+
+- ✅ LocalBackend - 本地存储
+- ✅ HTTPBackend - HTTP/HTTPS
+- ✅ S3Backend - AWS S3
+
+---
+
+## [0.1.1] - 2025-01-20
+
+### Added
+
+- **demo_v2.py** - New complete demo script
+- **演示验证** - Core functionality verified working
+
+### Fixed
+
+- Demo script parameter order
+- LocalBackend initialization
+
+---
+
+## [0.1.0] - 2025-01-20
+
+### Added
+
+- Initial release
+- VirtualFS core with memory index
+- Local backend (local filesystem)
+- HTTP backend (HTTP/HTTPS read-only)
+- S3 backend (AWS S3)
+- Gateway with CLI commands:
+  - `ls` - List directory contents
+  - `tree` - Display tree structure
+  - `link` - Create a link
+  - `unlink` - Remove a link
+  - `validate` - Validate links
+  - `status` - Show link status
+
+### Features
+
+- Memory index for O(1) directory listing
+- Link validation with status tracking
+- SQLite-based status storage
+- Support for multiple storage backends
+
+### Documentation
+
+- README with quick start guide
+- PROJECT.md with architecture design
+- CLI help documentation
+
+### Tests
+
+- 13 passing tests
+- VirtualFS tests
+- Backend tests
+- Gateway tests

syncgate-0.8.1/CONTRIBUTING.md

@@ -0,0 +1,92 @@
+# Contributing to SyncGate
+
+Thank you for your interest in contributing to SyncGate! This document outlines the process for contributing.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.10+
+- pip or poetry
+
+### Setting Up Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/syncgate.git
+cd syncgate
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/
+```
+
+### Code Style
+
+We use:
+- **Black** for code formatting
+- **mypy** for type checking
+- **pytest** for testing
+
+```bash
+# Format code
+black syncgate/ tests/
+
+# Type check
+mypy syncgate/
+
+# Run tests with coverage
+pytest --cov=syncgate tests/
+```
+
+## Submitting Changes
+
+### 1. Fork the Repository
+
+Fork the repository on GitHub and clone your fork.
+
+### 2. Create a Feature Branch
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+### 3. Make Changes
+
+- Write clean, documented code
+- Add tests for new functionality
+- Run the full test suite
+
+### 4. Submit a Pull Request
+
+- Describe your changes
+- Link any related issues
+- Ensure CI passes
+
+## Issue Reporting
+
+### Bug Reports
+
+When reporting bugs, include:
+- Steps to reproduce
+- Expected behavior
+- Actual behavior
+- Python version
+- Operating system
+
+### Feature Requests
+
+When requesting features, include:
+- Use case description
+- Proposed solution
+- Any relevant examples
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant](https://www.contributor-covenant.org/).
+
+## Questions?
+
+Open an issue for discussion.