erb_lint_daemon 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0d496463d30131bb2ad398b705fedb62d3f94e3b2ff0919013d783d3cd6a5107
+  data.tar.gz: ca1bff36a62dba95bfe16e63843b2da448441a3d1c9c159876c8fc657e18edc8
+SHA512:
+  metadata.gz: 437c395f96ad32260a35c7cf68ea75db4671275135585cc6fce76214222f641f0252ff59fbc403bb4c4b70efad390d843a3ce024fd7d492615497d51fe003c4a
+  data.tar.gz: 0ebd647e7f9ced9d4def4696cf3c0be128ba9184dfc1d5feed6c86568471b7abc7e7efb42748a38c9722d1ab0d42bc70c91d0d8c4bd41b225999af5fabd78f74

data/.erb_lint.yml

@@ -0,0 +1,4 @@
+---
+linters:
+  SpaceAroundErbTag:
+    enabled: true

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+pkg/
+bin/erb_lint_client_bin
+erb_lint_client
+ext/Makefile
+ext/mkmf.log
+ext/*.o

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,133 @@
+PATH
+  remote: .
+  specs:
+    erb_lint_daemon (0.1.0)
+      erb_lint
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionview (8.1.1)
+      activesupport (= 8.1.1)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activesupport (8.1.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ast (2.4.3)
+    base64 (0.3.0)
+    better_html (2.2.0)
+      actionview (>= 7.0)
+      activesupport (>= 7.0)
+      ast (~> 2.0)
+      erubi (~> 1.4)
+      parser (>= 2.4)
+      smart_properties
+    bigdecimal (3.3.1)
+    builder (3.3.0)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.5)
+    crass (1.0.6)
+    drb (2.2.3)
+    erb_lint (0.9.0)
+      activesupport
+      better_html (>= 2.0.1)
+      parser (>= 2.7.1.4)
+      rainbow
+      rubocop (>= 1)
+      smart_properties
+    erubi (1.13.1)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.16.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    loofah (2.24.1)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    minitest (5.26.2)
+    nokogiri (1.18.10-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.10-aarch64-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.18.10-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.10-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.18.10-x86_64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.18.10-x86_64-linux-musl)
+      racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.6.0)
+    racc (1.8.1)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rubocop (1.81.7)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.48.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    smart_properties (1.17.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    uri (1.1.1)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  erb_lint_daemon!
+  rake
+
+BUNDLED WITH
+   2.7.2

data/README.md

@@ -0,0 +1,57 @@
+# ErbLintDaemon
+
+A fast daemon wrapper for `erb_lint` to amortize startup costs. It uses a persistent Ruby server and a lightweight Go client to achieve near-instant linting feedback (~20ms).
+
+## Installation
+
+**Prerequisites:**
+- Go (golang) installed on your system.
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'erb_lint_daemon'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install erb_lint_daemon
+
+The gem will automatically compile the Go client during installation.
+
+## Usage
+
+Start the daemon (in a separate terminal or background):
+
+```bash
+# Starts the server
+ruby -r erb_lint_daemon/server -e 'ErbLintDaemon::Server.new.start'
+```
+
+Run the linter using the client:
+
+```bash
+# Lints the specified file
+erb_lint_daemon app/views/users/index.html.erb
+```
+
+### Options
+
+The client accepts the same arguments as `erb_lint`.
+
+## Development
+
+To modify the Go client:
+1.  Edit `ext/client.go`.
+2.  Run `rake build` to recompile locally.
+
+## Publishing
+
+To publish a new version:
+1.  Update the version number in `version.rb`.
+2.  Commit changes.
+3.  Run `bundle exec rake release`.

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rake'
+require 'bundler/gem_tasks'
+
+desc "Build the Go client"
+task :build do
+  puts "Building Go client..."
+  system("go build -o bin/erb_lint_client_bin ext/client.go")
+  if $?.success?
+    puts "Successfully built bin/erb_lint_client_bin"
+  else
+    abort "Failed to build Go client. Make sure Go is installed."
+  end
+end
+
+desc "Clean build artifacts"
+task :clean do
+  rm_f "bin/erb_lint_client_bin"
+  rm_f "erb_lint_client"
+end
+
+task :default => :build

data/bin/erb_lint_daemon

@@ -0,0 +1,3 @@
+#!/bin/sh
+# Wrapper to execute the compiled Go client
+exec "$(dirname "$0")/erb_lint_client_bin" "$@"

data/erb_lint_daemon.gemspec

@@ -0,0 +1,30 @@
+require_relative 'lib/erb_lint_daemon/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "erb_lint_daemon"
+  spec.version       = ErbLintDaemon::VERSION
+  spec.authors       = ["Owais Khan"]
+  spec.email         = ["owais@example.com"]
+
+  spec.summary       = "A daemon wrapper for erb_lint to improve performance."
+  spec.description   = "Amortizes the startup cost of erb_lint by keeping a process alive."
+  spec.homepage      = "https://github.com/example/erb_lint_daemon"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/example/erb_lint_daemon"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "bin"
+  spec.executables   = ["erb_lint_daemon"]
+  spec.require_paths = ["lib"]
+  spec.extensions    = ["ext/extconf.rb"]
+
+  spec.add_dependency "erb_lint"
+  spec.add_development_dependency "rake"
+end

data/ext/client.go

@@ -0,0 +1,74 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"io"
+	"net"
+	"os"
+)
+
+const socketPath = "/tmp/erb_lint_daemon.sock"
+
+type Request struct {
+	Args []string `json:"args"`
+	Cwd  string   `json:"cwd"`
+}
+
+type Response struct {
+	Output string `json:"output"`
+	Status int    `json:"status"`
+}
+
+func main() {
+	cwd, err := os.Getwd()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error getting CWD: %v\n", err)
+		os.Exit(1)
+	}
+
+	req := Request{
+		Args: os.Args[1:],
+		Cwd:  cwd,
+	}
+
+	conn, err := net.Dial("unix", socketPath)
+	if err != nil {
+		// If daemon is not running, we could fallback or error.
+		// For now, let's error.
+		fmt.Fprintf(os.Stderr, "Error connecting to daemon: %v\n", err)
+		os.Exit(1)
+	}
+	defer conn.Close()
+
+	reqData, err := json.Marshal(req)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error marshaling request: %v\n", err)
+		os.Exit(1)
+	}
+
+	if _, err := conn.Write(reqData); err != nil {
+		fmt.Fprintf(os.Stderr, "Error writing to socket: %v\n", err)
+		os.Exit(1)
+	}
+
+	// Close write end to signal EOF to server
+	if c, ok := conn.(*net.UnixConn); ok {
+		c.CloseWrite()
+	}
+
+	respData, err := io.ReadAll(conn)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error reading response: %v\n", err)
+		os.Exit(1)
+	}
+
+	var resp Response
+	if err := json.Unmarshal(respData, &resp); err != nil {
+		fmt.Fprintf(os.Stderr, "Error unmarshaling response: %v\n", err)
+		os.Exit(1)
+	}
+
+	fmt.Print(resp.Output)
+	os.Exit(resp.Status)
+}

data/ext/extconf.rb

@@ -0,0 +1,18 @@
+require 'mkmf'
+
+# Find the go compiler
+find_executable('go')
+
+# Create a dummy Makefile to satisfy Gem::Installer
+create_makefile('erb_lint_daemon/erb_lint_daemon')
+
+# We append a rule to the Makefile to build the Go binary
+File.open('Makefile', 'a') do |f|
+  f.write <<~MAKE
+
+    all:
+    \tgo build -o ../../bin/erb_lint_client_bin client.go
+
+    install: all
+  MAKE
+end

data/go.mod

@@ -0,0 +1,3 @@
+module erb_lint_daemon
+
+go 1.16

data/lib/erb_lint_daemon/server.rb

@@ -0,0 +1,83 @@
+require 'socket'
+require 'erb_lint'
+require 'erb_lint/cli'
+require 'json'
+
+module ErbLintDaemon
+  class Server
+    SOCKET_PATH = '/tmp/erb_lint_daemon.sock'
+
+    def start
+      File.unlink(SOCKET_PATH) if File.exist?(SOCKET_PATH)
+      server = UNIXServer.new(SOCKET_PATH)
+      puts "ERB Lint Daemon started on #{SOCKET_PATH}"
+
+      # Preload ERB Lint to warm up
+      # We might want to load the config here too if it's static, 
+      # but for now let's just ensure the library is loaded.
+      
+      loop do
+        client = server.accept
+        handle_client(client)
+      end
+    end
+
+    private
+
+    def handle_client(client)
+      begin
+        # Read all data from client until EOF
+        request_data = client.read
+        payload = JSON.parse(request_data)
+        args = payload['args']
+        cwd = payload['cwd']
+        
+        # Capture stdout/stderr
+        original_stdout = $stdout
+        original_stderr = $stderr
+        output = StringIO.new
+        $stdout = output
+        $stderr = output
+
+        # Run ERB Lint
+        # We need to instantiate a new CLI for each run to avoid state pollution
+        # but the classes are already loaded.
+        @cli ||= ERBLint::CLI.new
+        @default_options ||= @cli.instance_variable_get(:@options).dup
+        
+        @cli.instance_variable_set(:@stats, ERBLint::Stats.new)
+        @cli.instance_variable_set(:@options, @default_options.dup)
+        @cli.instance_variable_set(:@files, nil)
+        @cli.instance_variable_set(:@lint_files, nil)
+
+        cli = @cli
+        
+        success = false
+        Dir.chdir(cwd) do
+          success = cli.run(args)
+        end
+        
+        result = {
+          output: output.string,
+          status: success ? 0 : 1
+        }
+        
+        client.write(JSON.generate(result))
+      rescue => e
+        error_result = {
+          output: "Daemon Error: #{e.message}\n#{e.backtrace.join("\n")}",
+          status: 1
+        }
+        client.write(JSON.generate(error_result))
+      ensure
+        $stdout = original_stdout
+        $stderr = original_stderr
+        client.close
+      end
+    end
+  end
+end
+
+if __FILE__ == $0
+  ErbLintDaemon::Server.new.start
+end

data/lib/erb_lint_daemon/version.rb

@@ -0,0 +1,3 @@
+module ErbLintDaemon
+  VERSION = "0.1.0"
+end

data/lib/erb_lint_daemon.rb

@@ -0,0 +1,6 @@
+require "erb_lint_daemon/version"
+require "erb_lint_daemon/server"
+
+module ErbLintDaemon
+  # Your code goes here...
+end

data/subdir/.erb_lint.yml

@@ -0,0 +1,4 @@
+---
+linters:
+  SpaceAroundErbTag:
+    enabled: false

data/subdir/bad_spacing.html.erb

@@ -0,0 +1 @@
+<%foo%>

data/subdir/no_newline.html.erb

@@ -0,0 +1 @@
+<div>No newline</div>

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: erb_lint_daemon
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Owais Khan
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-12-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: erb_lint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Amortizes the startup cost of erb_lint by keeping a process alive.
+email:
+- owais@example.com
+executables:
+- erb_lint_daemon
+extensions:
+- ext/extconf.rb
+extra_rdoc_files: []
+files:
+- ".erb_lint.yml"
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/erb_lint_daemon
+- erb_lint_daemon.gemspec
+- ext/client.go
+- ext/extconf.rb
+- go.mod
+- lib/erb_lint_daemon.rb
+- lib/erb_lint_daemon/server.rb
+- lib/erb_lint_daemon/version.rb
+- subdir/.erb_lint.yml
+- subdir/bad_spacing.html.erb
+- subdir/no_newline.html.erb
+homepage: https://github.com/example/erb_lint_daemon
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/example/erb_lint_daemon
+  source_code_uri: https://github.com/example/erb_lint_daemon
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.9
+signing_key:
+specification_version: 4
+summary: A daemon wrapper for erb_lint to improve performance.
+test_files: []