kolla 0.0.3 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9f49f3b572118301b672c4352947ca6cda45b9c174e8b846ec6e3707d5d5320
-  data.tar.gz: 70332827226bda106ebc84029a6fc5bf8ad076a9786f281f238ba6506ed8b25d
+  metadata.gz: aa7af9c82815bce009d2214337606318aaf9af44fa9874fbbd70793926ab9aca
+  data.tar.gz: 58d03e71d4ebb50a0ff1bdef9d33dfebb0cd9f3199d2a7f2e5212f90d3df4742
 SHA512:
-  metadata.gz: 975308aca1e8ebfb2442296ef663c2e4cf4ad9a2c4ba6e8abc37e1bfb8d12ac75c63aa94ca99c66e9d1a5ca0d40e255e4451280628594543083a00388c1b702b
-  data.tar.gz: ba2c479eb4e04f3347e3e8e919a9c330e1dd36d1586047ca2a819974960ac9559c46430ce1d6939ac21adc0deb8911ef6bd04af366eb2cfc27bad6dd2c88a749
+  metadata.gz: eaf1ca3aaf552e86d5812f2a4f11be50a9766c5cc2e1fa862a77c74f3930381aa01e932cbf660d51bac053fe96b12d819da6c07f5ef0c03af599c547f2206745
+  data.tar.gz: 46903fc9c6446b1f51c8896ae88140e88ad9483e62336aa2dc1e9e3a95f3d994e61de5bfa09f15e8bce88a42d0faec91506cc20499f953733871c26edbd78ee5

data/README.md

@@ -0,0 +1,64 @@
+# Kolla
+
+Zero-dependency CLI that parses `db/schema.rb` and answers "what's in this table?" in under a second — without booting Rails.
+
+## Installation
+
+```
+gem install kolla
+```
+
+## Usage
+
+List all tables:
+
+```
+$ kolla
+users
+posts
+comments
+```
+
+Inspect a table:
+
+```
+$ kolla users
+name (string, null: false)
+email (string)
+life_in_seconds (bigint, default: 0)
+admin (boolean, default: false)
+created_at (datetime, null: false)
+index: [email] (unique)
+index: [name]
+```
+
+Use a custom schema path:
+
+```
+$ kolla -f path/to/schema.rb users
+```
+
+### Options
+
+```
+-h, --help       Show help
+-v, --version    Show version
+-f, --file PATH  Path to schema.rb (default: db/schema.rb)
+```
+
+## What gets filtered
+
+Rails internal tables (`action_*`, `active_*`) are excluded from the table list.
+
+## Development
+
+```
+git clone https://github.com/antonysastre/kolla.git
+cd kolla
+bundle install
+rake test
+```
+
+## License
+
+MIT

data/bin/kolla

@@ -1,4 +1,34 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require 'kolla'
-ARGV.empty? ? Kolla.run : Kolla.run(ARGV)
+require "kolla"
+
+file_path = Kolla::Parser::DEFAULT_FILE
+
+args = ARGV.dup
+while args.first&.start_with?("-")
+  case args.shift
+  when "--help", "-h"
+    puts <<~USAGE
+      Usage: kolla [options] [TABLE_NAME]
+
+      Options:
+        -h, --help       Show this help
+        -v, --version    Show version
+        -f, --file PATH  Path to schema.rb (default: db/schema.rb)
+
+      Examples:
+        kolla              List all tables
+        kolla users        Show fields for 'users' table
+        kolla -f path/schema.rb users
+    USAGE
+    exit 0
+  when "--version", "-v"
+    puts "kolla #{Kolla::VERSION}"
+    exit 0
+  when "--file", "-f"
+    file_path = args.shift
+  end
+end
+
+Kolla.run(args, file_path: file_path)

data/lib/kolla/errors.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Kolla
+  class Error < StandardError; end
+  class SchemaNotFound < Error; end
+  class TableNotFound < Error; end
+end

data/lib/kolla/parser.rb

@@ -2,40 +2,56 @@
 
 module Kolla
   class Parser
-    DEFAULT_FILE = File.join('db', 'schema.rb').freeze
+    DEFAULT_FILE = File.join("db", "schema.rb").freeze
+    IGNORED_PREFIXES = %w[action_ active_].freeze
 
-    def initialize(file_path: DEFAULT_FILE, options: {})
+    def initialize(file_path: DEFAULT_FILE)
       @file_path = File.expand_path(file_path)
-      @options = options
+      @content = File.read(@file_path)
+    rescue Errno::ENOENT
+      raise SchemaNotFound, "Schema file not found at #{@file_path}"
     end
 
-    def run!
-      content = File.read(file_path)
-      if options[:model_name]
-        extract_fields(content, options[:model_name])
-      else
-        extract_tables(content)
-      end
-    rescue Errno::ENOENT
-      Kolla.logger.warn "Schema file_path not found at #{file_path}"
+    def tables
+      matches = @content.scan(/create_table\s+"(\w+)"/)
+      matches.map(&:first).reject { |table| IGNORED_PREFIXES.any? { |prefix| table.start_with?(prefix) } }
     end
 
-    private
+    def fields_for(name)
+      escaped = Regexp.escape(name)
+      table_regex = /create_table "#{escaped}".*?do \|t\|(.*?)end/m
+      match = @content.match(table_regex)
+      raise TableNotFound, "Table '#{name}' not found in schema" unless match
 
-    def extract_tables(schema)
-      matches = schema.scan(/create_table\s+"(\w+)"/)
-      matches.map(&:first).reject { |table| table.start_with?('action_', 'active_') }
+      block = match[1]
+      fields = parse_fields(block)
+      indexes = parse_indexes(block)
+      fields + indexes
     end
 
-    def extract_fields(schema, table_name)
-      table_regex = /create_table "#{table_name}".*?do \|t\|(.*?)end/m
-      match = schema.match(table_regex)
-      return [] unless match
+    private
 
-      field_regex = /t\.(\w+)\s+"(\w+)"/
-      match[1].scan(field_regex).map { |type, name| "#{name} (#{type})" }
+    def parse_fields(block)
+      field_regex = /t\.(\w+)\s+"(\w+)"(.*)/
+      block.scan(field_regex).map do |type, name, rest|
+        next if type == "index"
+
+        parts = [type]
+        parts << "null: false" if rest.include?("null: false")
+        if (default_match = rest.match(/default:\s*("(?:[^"\\]|\\.)*"|[\w.]+)/))
+          parts << "default: #{default_match[1]}"
+        end
+        "#{name} (#{parts.join(', ')})"
+      end.compact
     end
 
-    attr_reader :file_path, :options
+    def parse_indexes(block)
+      index_regex = /t\.index\s+\[([^\]]+)\](.*)$/
+      block.scan(index_regex).map do |columns, rest|
+        cols = columns.scan(/"(\w+)"/).flatten
+        unique = rest.include?("unique: true") ? " (unique)" : ""
+        "index: [#{cols.join(', ')}]#{unique}"
+      end
+    end
   end
 end

data/lib/kolla/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Kolla
+  VERSION = "0.1.0"
+end

data/lib/kolla.rb

@@ -1,23 +1,20 @@
 # frozen_string_literal: true
 
-require 'logger'
+require_relative "kolla/version"
+require_relative "kolla/errors"
+require_relative "kolla/parser"
 
-# Kolla parses a file and reports matching results.
 module Kolla
-  class << self
-    attr_accessor :logger
-  end
-
-  self.logger = Logger.new($stdout)
+  def self.run(args = [], file_path: Parser::DEFAULT_FILE)
+    parser = Parser.new(file_path: file_path)
 
-  def self.run(args = [])
-    if !args[0].nil?
-      model_name = args[0]
-      puts Parser.new(options:{model_name:}).run!
+    if args.empty?
+      puts parser.tables
     else
-      puts Parser.new.run!
+      puts parser.fields_for(args[0])
     end
+  rescue Kolla::Error => e
+    warn e.message
+    exit 1
   end
 end
-
-require 'kolla/parser'

metadata

@@ -1,27 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: kolla
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.0
 platform: ruby
 authors:
 - Antony Sastre
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-02-15 00:00:00.000000000 Z
+date: 2026-03-20 00:00:00.000000000 Z
 dependencies: []
+description: Zero-dependency CLI that parses db/schema.rb and answers 'what's in this
+  table?' in under a second — without booting Rails.
 email: antony.sastre@gmail.com
 executables:
 - kolla
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
 - bin/kolla
 - lib/kolla.rb
+- lib/kolla/errors.rb
 - lib/kolla/parser.rb
+- lib/kolla/version.rb
 homepage: https://rubygems.org/gems/kolla
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/antonysastre/kolla
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -36,7 +44,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
-summary: Simple CLI utility tool to parse domain specific files and return reports.
+summary: Simple CLI tool to parse Rails schema file and list its details.
 test_files: []