linthis 0.0.3__tar.gz → 0.0.6__tar.gz

linthis-0.0.6/.github/workflows/release.yml

@@ -0,0 +1,250 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+env:
+  PACKAGE_NAME: linthis
+
+jobs:
+  # Build wheels for Linux
+  linux:
+    name: Build Linux ${{ matrix.target }}
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest
+            target: x86_64
+          - runner: ubuntu-24.04-arm
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --locked --out dist
+          manylinux: '2_17'
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-${{ matrix.target }}
+          path: dist
+      - name: Archive binary
+        run: |
+          ARCH=${{ matrix.target }}
+          if [ "$ARCH" = "x86_64" ]; then
+            TARGET=x86_64-unknown-linux-gnu
+          else
+            TARGET=aarch64-unknown-linux-gnu
+          fi
+          ARCHIVE_NAME=${{ env.PACKAGE_NAME }}-$TARGET
+          ARCHIVE_FILE=$ARCHIVE_NAME.tar.gz
+
+          mkdir -p $ARCHIVE_NAME
+          cp target/$TARGET/release/${{ env.PACKAGE_NAME }} $ARCHIVE_NAME/
+          tar czvf $ARCHIVE_FILE $ARCHIVE_NAME
+          shasum -a 256 $ARCHIVE_FILE > $ARCHIVE_FILE.sha256
+      - name: Upload binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: binaries-linux-${{ matrix.target }}
+          path: |
+            *.tar.gz
+            *.sha256
+
+  # Build wheels for Windows
+  windows:
+    name: Build Windows x86_64
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: x86_64
+          args: --release --locked --out dist
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-x86_64
+          path: dist
+      - name: Archive binary
+        shell: bash
+        run: |
+          TARGET=x86_64-pc-windows-msvc
+          ARCHIVE_NAME=${{ env.PACKAGE_NAME }}-$TARGET
+          ARCHIVE_FILE=$ARCHIVE_NAME.zip
+
+          mkdir -p $ARCHIVE_NAME
+          cp target/$TARGET/release/${{ env.PACKAGE_NAME }}.exe $ARCHIVE_NAME/
+          7z a $ARCHIVE_FILE $ARCHIVE_NAME
+          sha256sum $ARCHIVE_FILE > $ARCHIVE_FILE.sha256
+      - name: Upload binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: binaries-windows-x86_64
+          path: |
+            *.zip
+            *.sha256
+
+  # Build wheels for macOS
+  macos:
+    name: Build macOS ${{ matrix.target }}
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-14
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --locked --out dist
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+      - name: Archive binary
+        run: |
+          ARCH=${{ matrix.target }}
+          if [ "$ARCH" = "x86_64" ]; then
+            TARGET=x86_64-apple-darwin
+          else
+            TARGET=aarch64-apple-darwin
+          fi
+          ARCHIVE_NAME=${{ env.PACKAGE_NAME }}-$TARGET
+          ARCHIVE_FILE=$ARCHIVE_NAME.tar.gz
+
+          mkdir -p $ARCHIVE_NAME
+          cp target/$TARGET/release/${{ env.PACKAGE_NAME }} $ARCHIVE_NAME/
+          tar czvf $ARCHIVE_FILE $ARCHIVE_NAME
+          shasum -a 256 $ARCHIVE_FILE > $ARCHIVE_FILE.sha256
+      - name: Upload binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: binaries-macos-${{ matrix.target }}
+          path: |
+            *.tar.gz
+            *.sha256
+
+  # Build source distribution
+  sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  # Create GitHub Release
+  github-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [linux, windows, macos, sdist]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Download all binaries
+        uses: actions/download-artifact@v4
+        with:
+          pattern: binaries-*
+          path: binaries
+          merge-multiple: true
+      - name: Prepare release body
+        id: release_body
+        run: |
+          VERSION=${GITHUB_REF_NAME#v}
+          cat << EOF > release_body.md
+          ## Installation
+
+          \`\`\`bash
+          pip install linthis==$VERSION
+          # or
+          pip install --upgrade linthis
+          \`\`\`
+
+          ## Quick Start
+
+          \`\`\`bash
+          # Run linthis
+          linthis [-i <path>]
+          \`\`\`
+
+          See [CHANGELOG.md](CHANGELOG.md) for details.
+          EOF
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: binaries/*
+          generate_release_notes: true
+          body_path: release_body.md
+          draft: false
+          prerelease: ${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # Publish to PyPI
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [linux, windows, macos, sdist]
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # Publish to crates.io
+  publish-crates:
+    name: Publish to crates.io
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Run tests
+        run: cargo test --locked
+      - name: Publish to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish --locked

{linthis-0.0.3 → linthis-0.0.6}/.gitignore

@@ -41,3 +41,7 @@ Thumbs.db
 *.so
 *.dylib
 *.dll
+
+# Project
+.linthis/
+

{linthis-0.0.3 → linthis-0.0.6}/Cargo.lock

@@ -497,7 +497,7 @@ dependencies = [
 
 [[package]]
 name = "linthis"
-version = "0.0.3"
+version = "0.0.6"
 dependencies = [
  "anyhow",
  "chrono",

{linthis-0.0.3 → linthis-0.0.6}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "linthis"
-version = "0.0.3"
+version = "0.0.6"
 edition = "2021"
 authors = ["zhlinh"]
 description = "A fast, cross-platform multi-language linter and formatter"

{linthis-0.0.3 → linthis-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linthis
-Version: 0.0.3
+Version: 0.0.6
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -688,6 +688,11 @@ The ref can specify:
 
 This allows you to lock plugin versions or use development versions.
 
+## Documentation
+
+- [Plugin Auto-Sync](docs/AUTO_SYNC.md) - Automatic plugin synchronization (inspired by oh-my-zsh)
+- [Self Auto-Update](docs/SELF_UPDATE.md) - Automatic self-update functionality
+
 ## Development
 
 ### Build

{linthis-0.0.3 → linthis-0.0.6}/README.md

@@ -666,6 +666,11 @@ The ref can specify:
 
 This allows you to lock plugin versions or use development versions.
 
+## Documentation
+
+- [Plugin Auto-Sync](docs/AUTO_SYNC.md) - Automatic plugin synchronization (inspired by oh-my-zsh)
+- [Self Auto-Update](docs/SELF_UPDATE.md) - Automatic self-update functionality
+
 ## Development
 
 ### Build

{linthis-0.0.3 → linthis-0.0.6}/defaults/config.toml

@@ -75,6 +75,10 @@ cpplint_fix = true
 # Auto-detection searches up to 6 levels: cmake*/, build*/, out*/, *_build/, *-build/
 # and platform dirs: android/, ios/, arm*/, x86*/, debug/, release/, static/, shared/
 # compile_commands_dir = "cmake_build/debug/Android/static/arm64-v8a"
+# Cpplint line length (default: 80, common values: 100, 120)
+linelength = 120
+# Cpplint filter rules (comma-separated, -category to disable, +category to enable)
+# cpplint_filter = "-build/c++11,-build/c++14"
 
 # Cpplint fixer settings
 [cpp.cpplint_fix]
@@ -86,3 +90,18 @@ header_guard_mode = "fix_name"
 # copyright_template = "// Copyright {year} Your Company. All rights reserved."
 # Header guard prefix (optional)
 # header_guard_prefix = "MYPROJECT_"
+
+# Objective-C settings (different from C++)
+[oc]
+# Cpplint line length for OC
+linelength = 120
+# Cpplint filter rules - disable checks not applicable to Objective-C
+cpplint_filter = "-build/c++11,-build/c++14,-build/header_guard,-build/include,-legal/copyright,-readability/casting,-runtime/references,-runtime/int,-whitespace/braces,-whitespace/blank_line,-readability/braces,-whitespace/empty_if_body"
+
+# Plugin settings
+[plugin]
+# Auto-sync settings (inspired by oh-my-zsh auto-update)
+[plugin.auto_sync]
+enabled = true           # Enable automatic plugin synchronization
+mode = "prompt"          # Sync mode: "auto" (automatic), "prompt" (ask before sync), "disabled"
+interval_days = 7        # Check for updates every N days

linthis-0.0.6/docs/AUTO_SYNC.md

@@ -0,0 +1,261 @@
+# Linthis Plugin Auto-Sync 功能说明
+
+## 概述
+
+linthis 现在支持自动同步插件功能，灵感来自 oh-my-zsh 的自动更新机制。该功能可以在运行 linthis 时自动检查并同步插件更新，确保您始终使用最新的插件配置。
+
+## 特性
+
+- ✅ **可配置的同步间隔**：自定义检查更新的频率（默认 7 天）
+- ✅ **多种同步模式**：
+  - `auto`：自动同步，无需确认
+  - `prompt`：同步前询问用户（默认）
+  - `disabled`：禁用自动同步
+- ✅ **智能时间追踪**：使用 Unix 时间戳避免时区问题
+- ✅ **优雅的用户交互**：清晰的进度提示和错误处理
+- ✅ **智能更新检测**：只在有实际更新时提示用户
+
+## 配置方式
+
+### 1. 在配置文件中设置
+
+在 `.linthis/config.toml` 或 `~/.linthis/config.toml` 中添加：
+
+```toml
+# Plugin settings
+[plugin]
+sources = [
+    { name = "myplugin", url = "https://github.com/your-org/myplugin.git", ref = "main" }
+]
+
+# Plugin auto-sync settings
+[plugin_auto_sync]
+enabled = true           # 启用自动同步
+mode = "prompt"          # 同步模式: "auto", "prompt", "disabled"
+interval_days = 7        # 同步间隔（天）
+```
+
+### 2. 配置选项说明
+
+#### `enabled`
+- **类型**：布尔值
+- **默认值**：`true`
+- **说明**：是否启用自动同步功能
+
+#### `mode`
+- **类型**：字符串
+- **默认值**：`"prompt"`
+- **可选值**：
+  - `"auto"`：自动同步，不需要用户确认
+  - `"prompt"`：同步前询问用户是否继续
+  - `"disabled"`：禁用自动同步
+- **说明**：同步模式
+
+#### `interval_days`
+- **类型**：整数
+- **默认值**：`7`
+- **说明**：检查更新的间隔天数
+
+## 工作原理
+
+### 时间追踪
+
+自动同步功能使用 `~/.linthis/.plugin_sync_last_check` 文件记录上次同步的时间戳（Unix epoch 秒数）。
+
+### 触发时机
+
+每次运行 linthis 主命令时，系统会：
+1. 加载配置文件中的 `plugin_auto_sync` 设置
+2. 检查 `~/.linthis/.plugin_sync_last_check` 文件
+3. 计算距离上次同步的时间
+4. 如果超过配置的间隔，触发同步流程
+
+### 同步流程
+
+根据配置的 `mode`：
+
+- **auto 模式**：
+  1. 检查所有插件是否有更新
+  2. 如果有更新，自动开始同步
+  3. 显示同步进度
+  4. 更新时间戳
+
+- **prompt 模式**：
+  1. 检查所有插件是否有更新
+  2. 如果有更新，提示用户：`Updates available for plugins. Update now? [Y/n]:`
+  3. 等待用户输入
+  4. 如果用户确认，执行同步
+  5. 如果用户拒绝或没有更新，跳过并更新时间戳（避免重复提示）
+
+- **disabled 模式**：
+  - 跳过所有检查
+
+## 使用示例
+
+### 示例 1：默认配置（提示模式）
+
+```toml
+[plugin_auto_sync]
+enabled = true
+mode = "prompt"
+interval_days = 7
+```
+
+当距离上次同步超过 7 天且有更新时：
+```bash
+$ linthis
+Updates available for plugins. Update now? [Y/n]: y
+↓ Syncing project plugins...
+  ↓ myplugin... ✓ @ a1b2c3d
+✓ Synced 1 plugin(s), 1 updated
+```
+
+当没有更新时，不会显示任何提示，只是静默更新时间戳。
+
+### 示例 2：自动模式（无需确认）
+
+```toml
+[plugin_auto_sync]
+enabled = true
+mode = "auto"
+interval_days = 3
+```
+
+每 3 天自动同步，无需用户确认：
+```bash
+$ linthis
+↓ Syncing project plugins...
+  ↓ myplugin... ✓ @ a1b2c3d
+↓ Syncing global plugins...
+  ↓ official... ✓ @ e4f5g6h (up to date)
+✓ Synced 2 plugin(s), 1 updated
+```
+
+### 示例 3：禁用自动同步
+
+```toml
+[plugin_auto_sync]
+enabled = false
+```
+
+或者：
+
+```toml
+[plugin_auto_sync]
+mode = "disabled"
+```
+
+### 示例 4：手动同步
+
+即使配置了自动同步，您仍然可以随时手动同步：
+
+```bash
+# 同步项目插件
+linthis plugin sync
+
+# 同步全局插件
+linthis plugin sync -g
+```
+
+## 与 oh-my-zsh 的对比
+
+| 特性 | oh-my-zsh | linthis |
+|-----|-----------|---------|
+| 默认同步间隔 | 13 天 | 7 天 |
+| 同步模式 | auto, prompt, disabled | auto, prompt, disabled |
+| 时间追踪 | `~/.zsh-update` | `~/.linthis/.plugin_sync_last_check` |
+| 提示信息 | shell 提示 | CLI 交互 |
+| 手动同步 | `omz update` | `linthis plugin sync` |
+| 智能更新检测 | 否 | 是（只在有更新时提示） |
+
+## 配置优先级
+
+配置加载遵循以下优先级（从高到低）：
+1. 项目配置（`.linthis/config.toml`）
+2. 全局配置（`~/.linthis/config.toml`）
+3. 内置默认值
+
+## 故障排查
+
+### 问题：自动同步不工作
+
+**检查清单**：
+1. 确认 `plugin_auto_sync.enabled = true`
+2. 确认 `plugin_auto_sync.mode` 不是 `"disabled"`
+3. 检查 `~/.linthis/.plugin_sync_last_check` 文件的权限
+4. 查看是否有错误信息输出
+
+### 问题：提示太频繁
+
+**解决方案**：增加 `interval_days` 的值：
+```toml
+[plugin_auto_sync]
+interval_days = 14  # 改为 14 天
+```
+
+### 问题：想要完全禁用
+
+**解决方案**：
+```toml
+[plugin_auto_sync]
+enabled = false
+```
+
+或者删除整个 `[plugin_auto_sync]` 配置段（将使用默认值）。
+
+## 技术细节
+
+### 实现位置
+- **模块**：`linthis/src/plugin/auto_sync.rs`
+- **配置**：`linthis/src/config/mod.rs`
+- **集成**：`linthis/src/main.rs`
+
+### 核心组件
+- `AutoSyncConfig`：配置结构体
+- `AutoSyncManager`：同步管理器，处理时间追踪和用户交互
+- `perform_auto_sync()`：主执行函数
+- `check_plugins_for_updates()`：检查插件更新
+- `sync_plugins()`：插件同步辅助函数
+
+### 测试覆盖
+- ✅ 配置验证
+- ✅ 时间戳读写
+- ✅ 同步间隔计算
+- ✅ 模式检查
+- ✅ 默认值测试
+
+运行测试：
+```bash
+cargo test plugin::auto_sync
+```
+
+## 与自动更新的关系
+
+linthis 同时支持：
+1. **Plugin Auto-Sync**（本功能）：自动同步插件
+2. **Self Auto-Update**：更新 linthis 自身
+
+两者独立配置，独立运行：
+```toml
+# 同步插件
+[plugin_auto_sync]
+enabled = true
+mode = "prompt"
+interval_days = 7
+
+# 更新 linthis 自身
+[self_auto_update]
+enabled = true
+mode = "prompt"
+interval_days = 7
+```
+
+执行顺序：
+1. 先检查 linthis 自身更新
+2. 再检查插件同步
+
+
+## 参考
+
+- [oh-my-zsh 自动更新机制](https://maxchadwick.xyz/blog/a-look-at-auto-updating-in-oh-my-zsh)
+- [oh-my-zsh 设置文档](https://github.com/ohmyzsh/ohmyzsh/wiki/Settings)