linthis 0.0.11__tar.gz → 0.0.12__tar.gz

{linthis-0.0.11 → linthis-0.0.12}/Cargo.lock

@@ -1208,7 +1208,7 @@ dependencies = [
 
 [[package]]
 name = "linthis"
-version = "0.0.11"
+version = "0.0.12"
 dependencies = [
  "anyhow",
  "async-trait",

{linthis-0.0.11 → linthis-0.0.12}/Cargo.toml

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

{linthis-0.0.11 → linthis-0.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linthis
-Version: 0.0.11
+Version: 0.0.12
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -582,6 +582,120 @@ All modifications preserve TOML file format and comments.
 | Lua        | luacheck             | stylua             |
 | Dart       | dart analyze         | dart format        |
 
+## Editor Plugins
+
+linthis provides official plugins for popular editors, offering seamless integration with format-on-save, manual lint/format commands, and configurable settings.
+
+### VSCode
+
+Install from [VS Marketplace](https://marketplace.visualstudio.com/items?itemName=zhlinh.linthis) or search "linthis" in VSCode Extensions.
+
+**Features:**
+- Format on Save (configurable)
+- Manual Lint/Format commands via Command Palette
+- Configurable executable path and additional arguments
+- Status bar integration
+
+**Installation via Command Palette:**
+```
+ext install zhlinh.linthis
+```
+
+**Configuration (settings.json):**
+```json
+{
+  "linthis.formatOnSave": true,
+  "linthis.executable.path": "",
+  "linthis.executable.additionalArguments": ""
+}
+```
+
+📁 Source: [vscode-linthis](./vscode-linthis/)
+
+### JetBrains (IntelliJ IDEA, WebStorm, PyCharm, etc.)
+
+Install from [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/XXXXX-linthis) or search "linthis" in IDE Settings → Plugins.
+
+**Features:**
+- Format on Save (configurable)
+- Manual Lint/Format via Tools menu
+- Configurable executable path and additional arguments
+- Settings UI in Preferences → Tools → Linthis
+
+**Installation:**
+1. Open Settings/Preferences → Plugins
+2. Search for "linthis"
+3. Click Install and restart IDE
+
+**Configuration:**
+- Settings → Tools → Linthis
+- Enable/disable Format on Save
+- Set custom executable path
+- Add additional command-line arguments
+
+📁 Source: [jetbrains-linthis](./jetbrains-linthis/)
+
+### Neovim
+
+Install using your favorite plugin manager. Distributed via GitHub.
+
+#### lazy.nvim (Recommended)
+
+```lua
+-- For monorepo (plugin in subdirectory)
+{
+  "zhlinh/linthis",
+  subdir = "nvim-linthis",
+  config = function()
+    require("linthis").setup()
+  end,
+}
+
+-- For standalone repository
+{
+  "zhlinh/nvim-linthis",
+  config = function()
+    require("linthis").setup()
+  end,
+}
+```
+
+#### packer.nvim
+
+```lua
+-- For monorepo
+use {
+  "zhlinh/linthis",
+  rtp = "nvim-linthis",
+  config = function()
+    require("linthis").setup()
+  end,
+}
+```
+
+#### vim-plug
+
+```vim
+" For monorepo
+Plug 'zhlinh/linthis', { 'rtp': 'nvim-linthis' }
+```
+
+**Features:**
+- Format on Save (configurable)
+- Commands: `:LinthisLint`, `:LinthisFormat`, `:LinthisLintFormat`
+- Configurable via `setup()` options
+
+**Configuration:**
+```lua
+require("linthis").setup({
+  format_on_save = true,
+  executable = "linthis",
+  additional_args = {},
+})
+```
+
+📁 Source: [nvim-linthis](./nvim-linthis/)
+
 ## Usage Scenarios
 
 ### Pre-commit Hook

{linthis-0.0.11 → linthis-0.0.12}/README.md

@@ -560,6 +560,120 @@ All modifications preserve TOML file format and comments.
 | Lua        | luacheck             | stylua             |
 | Dart       | dart analyze         | dart format        |
 
+## Editor Plugins
+
+linthis provides official plugins for popular editors, offering seamless integration with format-on-save, manual lint/format commands, and configurable settings.
+
+### VSCode
+
+Install from [VS Marketplace](https://marketplace.visualstudio.com/items?itemName=zhlinh.linthis) or search "linthis" in VSCode Extensions.
+
+**Features:**
+- Format on Save (configurable)
+- Manual Lint/Format commands via Command Palette
+- Configurable executable path and additional arguments
+- Status bar integration
+
+**Installation via Command Palette:**
+```
+ext install zhlinh.linthis
+```
+
+**Configuration (settings.json):**
+```json
+{
+  "linthis.formatOnSave": true,
+  "linthis.executable.path": "",
+  "linthis.executable.additionalArguments": ""
+}
+```
+
+📁 Source: [vscode-linthis](./vscode-linthis/)
+
+### JetBrains (IntelliJ IDEA, WebStorm, PyCharm, etc.)
+
+Install from [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/XXXXX-linthis) or search "linthis" in IDE Settings → Plugins.
+
+**Features:**
+- Format on Save (configurable)
+- Manual Lint/Format via Tools menu
+- Configurable executable path and additional arguments
+- Settings UI in Preferences → Tools → Linthis
+
+**Installation:**
+1. Open Settings/Preferences → Plugins
+2. Search for "linthis"
+3. Click Install and restart IDE
+
+**Configuration:**
+- Settings → Tools → Linthis
+- Enable/disable Format on Save
+- Set custom executable path
+- Add additional command-line arguments
+
+📁 Source: [jetbrains-linthis](./jetbrains-linthis/)
+
+### Neovim
+
+Install using your favorite plugin manager. Distributed via GitHub.
+
+#### lazy.nvim (Recommended)
+
+```lua
+-- For monorepo (plugin in subdirectory)
+{
+  "zhlinh/linthis",
+  subdir = "nvim-linthis",
+  config = function()
+    require("linthis").setup()
+  end,
+}
+
+-- For standalone repository
+{
+  "zhlinh/nvim-linthis",
+  config = function()
+    require("linthis").setup()
+  end,
+}
+```
+
+#### packer.nvim
+
+```lua
+-- For monorepo
+use {
+  "zhlinh/linthis",
+  rtp = "nvim-linthis",
+  config = function()
+    require("linthis").setup()
+  end,
+}
+```
+
+#### vim-plug
+
+```vim
+" For monorepo
+Plug 'zhlinh/linthis', { 'rtp': 'nvim-linthis' }
+```
+
+**Features:**
+- Format on Save (configurable)
+- Commands: `:LinthisLint`, `:LinthisFormat`, `:LinthisLintFormat`
+- Configurable via `setup()` options
+
+**Configuration:**
+```lua
+require("linthis").setup({
+  format_on_save = true,
+  executable = "linthis",
+  additional_args = {},
+})
+```
+
+📁 Source: [nvim-linthis](./nvim-linthis/)
+
 ## Usage Scenarios
 
 ### Pre-commit Hook

linthis-0.0.12/docs/assets/README.md

@@ -0,0 +1,102 @@
+# Linthis Brand Assets
+
+## Logo & Icon Design
+
+This directory contains the brand assets for linthis documentation.
+
+### Files
+
+- **logo.svg** - Main logo for documentation pages (200x200px)
+- **favicon.svg** - Browser tab icon (64x64px)
+
+### Design Concept
+
+The linthis logo represents the core functionality of the tool:
+
+#### Visual Elements
+
+1. **Check Mark (✓)**
+   - Represents code **linting** and validation
+   - Central element showing correctness and quality
+   - Bold stroke for visibility
+
+2. **Code Lines**
+   - Top left: Unformatted code lines (varying lengths)
+   - Bottom right: Formatted code lines (aligned)
+   - Represents the **formatter** functionality
+
+3. **Multi-layer Design**
+   - Multiple elements symbolize **multi-language support**
+   - Different opacities create depth
+
+#### Color Scheme
+
+- **Primary Color**: Blue (#2196f3)
+  - Represents clarity, trust, and professionalism
+  - Associated with code quality and development tools
+  - High contrast for visibility
+
+- **Accent Color**: Light Blue (#64b5f6)
+  - Used for secondary elements
+  - Creates visual hierarchy
+
+#### Typography
+
+- Font: Arial, sans-serif (bold)
+- Text: "LTS" at bottom (Lint This)
+- Color: Blue with 80% opacity
+- Size: Proportional to logo size
+
+### Design Inspiration
+
+Inspired by the ccgo logo style:
+- Clean, modern aesthetic
+- Circular/rounded design for logo
+- Square with rounded corners for favicon
+- Professional developer tool appearance
+
+### Usage
+
+#### In MkDocs
+
+The logo and favicon are configured in `mkdocs.yml`:
+
+```yaml
+theme:
+  name: material
+  logo: assets/logo.svg
+  favicon: assets/favicon.svg
+  palette:
+    - scheme: default
+      primary: blue
+      accent: light blue
+```
+
+#### Standalone Usage
+
+Both SVG files can be used independently:
+- As favicons for web applications
+- In documentation
+- In README files
+- On project websites
+
+### Color Palette
+
+```
+Primary Blue:     #2196f3
+Light Blue:       #64b5f6
+Background:       #2196f3 (10% opacity)
+Border:           #2196f3
+Text:             #2196f3 (80% opacity)
+```
+
+### Accessibility
+
+- High contrast between logo and background
+- Clear, recognizable shapes
+- Scalable vector format (SVG)
+- Works in both light and dark modes
+
+### License
+
+Same as linthis project - MIT License

linthis-0.0.12/docs/assets/favicon.svg

@@ -0,0 +1,26 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <!-- Background -->
+  <rect width="64" height="64" fill="#2196f3" rx="8"/>
+
+  <!-- Code lines (top left) -->
+  <g stroke="white" stroke-width="2" stroke-linecap="round" opacity="0.7">
+    <line x1="8" y1="12" x2="28" y2="12"/>
+    <line x1="8" y1="18" x2="35" y2="18"/>
+    <line x1="8" y1="24" x2="25" y2="24"/>
+  </g>
+
+  <!-- Check mark (✓) - centered -->
+  <path d="M 18 38 L 28 48 L 48 26"
+        fill="none" stroke="white" stroke-width="6"
+        stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- Format lines (bottom right) -->
+  <g stroke="white" stroke-width="2" stroke-linecap="round" opacity="0.7">
+    <line x1="36" y1="42" x2="56" y2="42"/>
+    <line x1="36" y1="36" x2="56" y2="36"/>
+  </g>
+
+  <!-- "LTS" text at bottom -->
+  <text x="32" y="62" font-family="Arial, sans-serif" font-size="10"
+        font-weight="bold" text-anchor="middle" fill="white" opacity="0.9">LTS</text>
+</svg>

linthis-0.0.12/docs/assets/logo.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200">
+  <!-- Background circle -->
+  <circle cx="100" cy="100" r="95" fill="#2196f3" opacity="0.1"/>
+
+  <!-- Main circle -->
+  <circle cx="100" cy="100" r="85" fill="none" stroke="#2196f3" stroke-width="3"/>
+
+  <!-- Code lines representing multi-language support -->
+  <g stroke="#2196f3" stroke-width="2.5" stroke-linecap="round" opacity="0.6">
+    <line x1="55" y1="50" x2="90" y2="50"/>
+    <line x1="55" y1="62" x2="100" y2="62"/>
+    <line x1="55" y1="74" x2="85" y2="74"/>
+  </g>
+
+  <!-- Check mark (✓) representing linting -->
+  <path d="M 65 115 L 85 135 L 135 75"
+        fill="none" stroke="#2196f3" stroke-width="12"
+        stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- Format indicator - aligned lines on right -->
+  <g stroke="#64b5f6" stroke-width="2.5" stroke-linecap="round" opacity="0.6">
+    <line x1="110" y1="126" x2="145" y2="126"/>
+    <line x1="110" y1="138" x2="145" y2="138"/>
+    <line x1="110" y1="150" x2="145" y2="150"/>
+  </g>
+
+  <!-- "LTS" text at bottom -->
+  <text x="100" y="170" font-family="Arial, sans-serif" font-size="24"
+        font-weight="bold" text-anchor="middle" fill="#2196f3" opacity="0.8">LTS</text>
+</svg>

linthis-0.0.12/docs/assets/preview.html

@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Linthis Logo Preview</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Arial, sans-serif;
+            padding: 40px;
+            background: #f5f5f5;
+        }
+
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+        }
+
+        h1 {
+            color: #333;
+            margin-bottom: 40px;
+            text-align: center;
+        }
+
+        .section {
+            background: white;
+            border-radius: 8px;
+            padding: 30px;
+            margin-bottom: 30px;
+            box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+        }
+
+        h2 {
+            color: #2196f3;
+            margin-bottom: 20px;
+            border-bottom: 2px solid #2196f3;
+            padding-bottom: 10px;
+        }
+
+        .logo-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+            gap: 30px;
+            margin-top: 20px;
+        }
+
+        .logo-item {
+            text-align: center;
+            padding: 20px;
+            border: 1px solid #e0e0e0;
+            border-radius: 8px;
+        }
+
+        .logo-item h3 {
+            margin: 15px 0 10px;
+            color: #555;
+            font-size: 16px;
+        }
+
+        .logo-item p {
+            color: #888;
+            font-size: 14px;
+        }
+
+        .light-bg {
+            background: #ffffff;
+        }
+
+        .dark-bg {
+            background: #263238;
+        }
+
+        .color-swatch {
+            display: inline-block;
+            width: 80px;
+            height: 80px;
+            border-radius: 8px;
+            margin: 10px;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.2);
+        }
+
+        .color-info {
+            display: inline-block;
+            vertical-align: top;
+            margin-left: 10px;
+        }
+
+        .color-section {
+            margin: 20px 0;
+        }
+
+        .favicon-preview {
+            display: inline-block;
+            width: 64px;
+            height: 64px;
+            margin: 0 10px;
+        }
+
+        .usage-example {
+            background: #f9f9f9;
+            padding: 15px;
+            border-radius: 4px;
+            margin: 15px 0;
+            font-family: 'Courier New', monospace;
+            font-size: 14px;
+            overflow-x: auto;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>🎨 Linthis Brand Assets</h1>
+
+        <!-- Logo Preview Section -->
+        <div class="section">
+            <h2>Main Logo (logo.svg)</h2>
+            <div class="logo-grid">
+                <div class="logo-item light-bg">
+                    <img src="logo.svg" width="200" height="200" alt="Linthis Logo">
+                    <h3>Light Background</h3>
+                    <p>Primary usage</p>
+                </div>
+                <div class="logo-item dark-bg">
+                    <img src="logo.svg" width="200" height="200" alt="Linthis Logo">
+                    <h3>Dark Background</h3>
+                    <p>Dark mode</p>
+                </div>
+                <div class="logo-item light-bg">
+                    <img src="logo.svg" width="100" height="100" alt="Linthis Logo">
+                    <h3>Small Size</h3>
+                    <p>100×100px</p>
+                </div>
+                <div class="logo-item light-bg">
+                    <img src="logo.svg" width="50" height="50" alt="Linthis Logo">
+                    <h3>Icon Size</h3>
+                    <p>50×50px</p>
+                </div>
+            </div>
+        </div>
+
+        <!-- Favicon Preview Section -->
+        <div class="section">
+            <h2>Favicon (favicon.svg)</h2>
+            <div style="text-align: center; padding: 20px;">
+                <div style="display: inline-block; margin: 0 20px;">
+                    <h3 style="margin-bottom: 15px;">64×64px (Standard)</h3>
+                    <img src="favicon.svg" class="favicon-preview" alt="Favicon">
+                </div>
+                <div style="display: inline-block; margin: 0 20px;">
+                    <h3 style="margin-bottom: 15px;">32×32px (Small)</h3>
+                    <img src="favicon.svg" width="32" height="32" alt="Favicon Small">
+                </div>
+                <div style="display: inline-block; margin: 0 20px;">
+                    <h3 style="margin-bottom: 15px;">16×16px (Tiny)</h3>
+                    <img src="favicon.svg" width="16" height="16" alt="Favicon Tiny">
+                </div>
+            </div>
+        </div>
+
+        <!-- Design Elements Section -->
+        <div class="section">
+            <h2>Design Elements</h2>
+            <div style="padding: 20px;">
+                <h3 style="margin: 20px 0 10px;">✓ Check Mark</h3>
+                <p>Represents code linting and validation</p>
+
+                <h3 style="margin: 20px 0 10px;">― Code Lines</h3>
+                <p>Top: Unformatted code | Bottom: Formatted code</p>
+
+                <h3 style="margin: 20px 0 10px;">○ Circle Frame</h3>
+                <p>Professional, complete, unified design</p>
+            </div>
+        </div>
+
+        <!-- Color Palette Section -->
+        <div class="section">
+            <h2>Color Palette</h2>
+            <div class="color-section">
+                <div style="margin: 20px 0;">
+                    <div class="color-swatch" style="background: #2196f3;"></div>
+                    <div class="color-info">
+                        <h3>Primary Blue</h3>
+                        <p><strong>#2196f3</strong></p>
+                        <p>Main logo color, borders, text</p>
+                    </div>
+                </div>
+                <div style="margin: 20px 0;">
+                    <div class="color-swatch" style="background: #64b5f6;"></div>
+                    <div class="color-info">
+                        <h3>Light Blue</h3>
+                        <p><strong>#64b5f6</strong></p>
+                        <p>Secondary elements, accents</p>
+                    </div>
+                </div>
+                <div style="margin: 20px 0;">
+                    <div class="color-swatch" style="background: rgba(33, 150, 243, 0.1); border: 1px solid #ddd;"></div>
+                    <div class="color-info">
+                        <h3>Background Tint</h3>
+                        <p><strong>#2196f3 @ 10% opacity</strong></p>
+                        <p>Subtle background circle</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Usage Examples Section -->
+        <div class="section">
+            <h2>Usage in MkDocs</h2>
+            <div class="usage-example">
+theme:<br>
+&nbsp;&nbsp;name: material<br>
+&nbsp;&nbsp;logo: assets/logo.svg<br>
+&nbsp;&nbsp;favicon: assets/favicon.svg<br>
+&nbsp;&nbsp;palette:<br>
+&nbsp;&nbsp;&nbsp;&nbsp;- scheme: default<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;primary: blue<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;accent: light blue
+            </div>
+        </div>
+
+        <!-- Browser Tab Preview -->
+        <div class="section">
+            <h2>Browser Tab Preview</h2>
+            <div style="padding: 20px; text-align: center;">
+                <div style="display: inline-block; border: 1px solid #ddd; border-radius: 8px 8px 0 0; padding: 10px 20px; background: #f5f5f5;">
+                    <img src="favicon.svg" width="16" height="16" style="vertical-align: middle; margin-right: 8px;" alt="Tab Icon">
+                    <span style="font-size: 14px; color: #333;">linthis - Fast multi-language linter</span>
+                </div>
+            </div>
+        </div>
+    </div>
+</body>
+</html>