strata-cli 0.1.1.beta → 0.1.3.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9887ae6b4d871118361a7ef0b90c6b07a5095c59f8b7acc812aefc4ef8e5a58
-  data.tar.gz: e2fba95feba89bb6193d563f7b2dba3e594ea57915c56700f9228b29783c942a
+  metadata.gz: 0dc0377469e1bfb8d12c50f839b1f530d2104b1b894e5623d0f009081e60f1e5
+  data.tar.gz: f4595f187e23891e5b1d64ef384ae48b1d3e73bd34a5ab8afefab9886b95f5ad
 SHA512:
-  metadata.gz: d131c145bc2cf2aab4c532266f2d7bd8df1026053ff3b0cce4734867132ec6f2500147b645aecf28fe1e2a3d3d99803d26ce02e7484f6f0d4c9a399fa9ccd8e0
-  data.tar.gz: a7c089088c80acbc89e9de821de1ab482a4d51f685ac3a06089f1e0469945e05720fdebdb09ea9d114c14cf7c7768c0073d5b3a26bcf357a45ba7fbc474723ce
+  metadata.gz: b13368ec18b1d53316d3eb01f42f869ff81e8297b2f5451c337073cf0fed8400694a629136c3bbc8bec9b3bfd1affd786a9b1343a4b9b6f3561089d5aba86e9c
+  data.tar.gz: c47cfbdd8e1d54dda6b9b92b3e6385bf14f8d0e03c608721436dafeb70177fe2f51893003721edd1bebb757bbd8f0eefc3164c6c9287707ffc8ee3f86d2175f1

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 ## [Unreleased]
 
+## [0.1.3.beta] - 2026-01-28
+
+### Added
+
+- **Runtime adapter driver checks**: When a datasource is used, the CLI now verifies that required driver gems (pg, mysql2, tiny_tds, sqlite3, aws-sdk-*, trino-client, duckdb) are installed, and surfaces adapter-specific guidance if they are not.
+
+### Changed
+
+- **Adapter installation behavior**: On first use of any adapter, the CLI will attempt to install any missing driver gem once; if installation still fails, it raises a clear `Strata::CommandError` with likely causes and manual install instructions.
+- **DuckDB handling**: DuckDB now follows the same “try install once, then explain” pattern as other adapters, with extra hints for DuckDB’s native build and header/library requirements. DuckDB is still not a default dependency.
+
+## [0.1.2.beta] - 2025-01-27
+
+### Added
+
+- **Version checker**: Notifies when a newer strata-cli is available on Rubygems. Uses a 24-hour cache; set `STRATA_SKIP_VERSION_CHECK=true` to disable. Skipped for `version` and `help` commands.
+- **Git requirement check**: Exits with a clear error when Git is not installed (required for deploy and other features). Skipped for `version` and `help` commands.
+
+### Changed
+
+- **Ruby requirement**: `required_ruby_version` set to `>= 3.4.4` (aligned with dwh gem).
+- **CI**: Test on Ruby 3.4.4 and 3.4.5.
+- **README**: Document Ruby and dwh requirements (>= 3.4.4), native dependencies (pg, mysql2, tiny_tds) with install hints, and installation troubleshooting.
+
 ## [0.1.1.beta] - 2025-01-22
 
 - Initial release

data/README.md

@@ -4,6 +4,8 @@ Command-line interface for the Strata Semantic Analytics System. Create, manage,
 
 ## Installation
 
+### Basic Installation
+
 ```bash
 gem install strata-cli
 ```
@@ -12,7 +14,12 @@ gem install strata-cli
 
 - Ruby >= 3.4.4
 - Git (for deployment features)
-- Access to a Strata server
+
+## Dependencies
+
+
+### Adapter Gems and System Libraries
+
 
 ## Commands Overview
 
@@ -54,6 +61,9 @@ strata project link 12345
 ### `strata datasource adapters`
 List all supported data warehouse adapters.
 
+### `strata datasource check`
+Check which database adapter gems are installed.
+
 ### `strata datasource list`
 List all configured datasources with their keys and display names.
 
@@ -256,6 +266,9 @@ strata a models           # Validate models only
 ### `strata version`
 Print the CLI version.
 
+### `strata check`
+Check which database adapter gems are installed (no project required).
+
 ### `strata adapters`
 List all supported data warehouse adapters.
 

data/lib/strata/cli/guard.rb

@@ -8,7 +8,8 @@ module Strata
         adapters
         version
         deploy
-      ]
+      ].freeze
+
       def invoke_command(command, *args)
         Utils.exit_error_if_not_strata! unless ALLOWED_COMMANDS.include?(command.name)
         super

data/lib/strata/cli/helpers/datasource_helper.rb

@@ -3,6 +3,17 @@
 module Strata
   module CLI
     module DatasourceHelper
+      ADAPTER_DRIVER_GEMS = {
+        postgres: %w[pg],
+        redshift: %w[pg],
+        mysql: %w[mysql2],
+        sqlserver: %w[tiny_tds],
+        athena: %w[aws-sdk-athena aws-sdk-s3],
+        trino: %w[trino-client],
+        sqlite: %w[sqlite3],
+        duckdb: %w[duckdb]
+      }.freeze
+
       def resolve_datasource(ds_key_arg = nil, prompt: TTY::Prompt.new)
         # 1. Use argument if provided
         return validate_datasource(ds_key_arg) if ds_key_arg
@@ -29,7 +40,44 @@ module Strata
 
       def create_adapter(ds_key)
         config = ds_config(ds_key).merge(Credentials.fetch(ds_key))
-        DWH.create(config["adapter"].to_sym, config)
+        adapter_sym = config["adapter"].to_sym
+        ensure_adapter_driver_gems!(adapter_sym)
+        DWH.create(adapter_sym, config)
+      end
+
+      def ensure_adapter_driver_gems!(adapter_sym)
+        required = ADAPTER_DRIVER_GEMS.fetch(adapter_sym, [])
+        return if required.empty?
+
+        missing = required.reject { gem_installed?(it) }
+        return if missing.empty?
+
+        if respond_to?(:say)
+          say "Required gem(s) for '#{adapter_sym}' not found (#{missing.join(", ")}). Attempting to install...",
+            :yellow
+        end
+
+        missing.each do |gem_name|
+          system("gem", "install", gem_name, "-q", "--no-document")
+        end
+
+        still_missing = missing.reject { gem_installed?(it) }
+        return if still_missing.empty?
+
+        details = adapter_driver_gem_help(adapter_sym, still_missing)
+
+        msg = <<~MSG
+          Missing required gem(s) for adapter '#{adapter_sym}': #{still_missing.join(", ")}
+
+          This adapter can't be used until the driver gem(s) are installed.
+
+          Install manually:
+
+            gem install #{still_missing.join(" ")}
+
+          #{details}
+        MSG
+        raise Strata::CommandError, msg
       end
 
       def ds_config(ds_key)
@@ -57,6 +105,34 @@ module Strata
           {}
         end
       end
+
+      def gem_installed?(name)
+        Gem::Specification.find_by_name(name)
+        true
+      rescue Gem::MissingSpecError
+        false
+      end
+
+      def adapter_driver_gem_help(adapter_sym, missing)
+        case adapter_sym
+        when :postgres, :redshift
+          "Notes:\n- 'pg' requires PostgreSQL client libraries (libpq) installed on your system. See https://www.postgresql.org/download/"
+        when :mysql
+          "Notes:\n- 'mysql2' requires MySQL client libraries installed on your system. See https://dev.mysql.com/downloads/"
+        when :sqlserver
+          "Notes:\n- 'tiny_tds' requires FreeTDS and (often) OpenSSL installed on your system. See https://www.freetds.org/"
+        when :sqlite
+          "Notes:\n- 'sqlite3' requires SQLite development libraries installed on your system."
+        when :athena
+          "Notes:\n- AWS SDK gems are pure Ruby; no system libraries required."
+        when :trino
+          "Notes:\n- 'trino-client' is pure Ruby; no system libraries required."
+        when :duckdb
+          "Notes:\n- See https://github.com/suketa/ruby-duckdb"
+        else
+          "Notes:\n- Install missing gems: #{missing.join(", ")}"
+        end
+      end
     end
   end
 end

data/lib/strata/cli/sub_commands/datasource.rb

@@ -23,6 +23,17 @@ module Strata
           end
         end
 
+        desc "check", "Check which database adapter gems are installed"
+        def check
+          rows = adapter_gem_status.map do |adapter, info|
+            status = info[:installed] ? "✔" : "✗"
+            [adapter.to_s, info[:gem], status]
+          end
+          say "\n  Adapter gem status:\n\n", :yellow
+          print_table(rows, headers: %w[Adapter Gem Installed], color: :magenta)
+          say "\n  Install missing gems with: gem install <gem_name>", :cyan
+        end
+
         desc "list", "List current configured datasources by key and name"
         def list
           ds = begin
@@ -223,6 +234,20 @@ module Strata
 
         private
 
+        def adapter_gem_status
+          DatasourceHelper::ADAPTER_DRIVER_GEMS.to_h do |adapter, gems|
+            installed = gems.all? { |g| gem_installed?(g) }
+            [adapter, {gem: gems.join(", "), installed: installed}]
+          end
+        end
+
+        def gem_installed?(name)
+          Gem::Specification.find_by_name(name)
+          true
+        rescue Gem::MissingSpecError
+          false
+        end
+
         def validate_file_path(file_path, project_path = Dir.pwd)
           expanded = File.expand_path(file_path, project_path)
           project_root = File.expand_path(project_path)

data/lib/strata/cli/utils/git.rb

@@ -113,6 +113,24 @@ module Strata
           File.directory?(".git")
         end
 
+        def git_available?
+          _, _, status = Open3.capture3("git", "--version")
+          status.success?
+        rescue
+          false
+        end
+
+        def check_requirement_and_exit_if_unavailable(args)
+          # Allow help and version commands to work without Git
+          command = args.first
+          return if args.empty? || %w[version help].include?(command)
+
+          return if git_available?
+
+          Thor::Shell::Color.new.say_error "ERROR: Git is required but not found. Please install Git to use strata-cli.", :red
+          exit 1
+        end
+
         def git_remote_url(remote_name = "origin")
           return nil unless git_repo?
 

data/lib/strata/cli/utils/version_checker.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "fileutils"
+require "timeout"
+require "thor"
+
+module Strata
+  module CLI
+    module Utils
+      module VersionChecker
+        module_function
+
+        GEM_NAME = "strata-cli"
+        RUBYGEMS_API_URL = "https://rubygems.org/api/v1/gems/#{GEM_NAME}.json"
+        CACHE_FILE = File.join(ENV.fetch("TMPDIR", "/tmp"), "strata-cli-version-check-cache")
+        CACHE_DURATION = 86_400 # 24 hours in seconds
+
+        def check_and_notify(current_version)
+          return if skip_check?
+
+          latest_version = fetch_latest_version
+          return unless latest_version
+
+          if newer_version_available?(current_version, latest_version)
+            display_update_message(latest_version)
+          end
+
+          update_cache
+        rescue
+          # Silently fail - version checking should never break the CLI
+          # In development, you might want to log this: warn "Version check failed: #{e.message}"
+          nil
+        end
+
+        def newer_version_available?(current, latest)
+          return false unless current && latest
+
+          # Simple version comparison (assumes semantic versioning)
+          # Convert non-numeric parts (like "beta") to 0 for comparison
+          current_parts = current.split(".").map { |p| p.to_i }
+          latest_parts = latest.split(".").map { |p| p.to_i }
+
+          # Pad with zeros if needed
+          max_length = [current_parts.length, latest_parts.length].max
+          current_parts += [0] * (max_length - current_parts.length)
+          latest_parts += [0] * (max_length - latest_parts.length)
+
+          # Compare arrays element by element
+          latest_parts.zip(current_parts).each do |latest_part, current_part|
+            return true if latest_part > current_part
+            return false if latest_part < current_part
+          end
+
+          false # Versions are equal
+        end
+
+        def fetch_latest_version
+          uri = URI(RUBYGEMS_API_URL)
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.use_ssl = true
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+          http.open_timeout = 2 # 2 second timeout
+          http.read_timeout = 2
+
+          response = http.get(uri.path)
+          parse_version_response(response)
+        rescue
+          # Silently fail - version checking should never break the CLI
+          # This includes SSL errors, network errors, timeouts, etc.
+          nil
+        end
+
+        def parse_version_response(response)
+          return nil unless response.is_a?(Net::HTTPSuccess)
+
+          data = JSON.parse(response.body)
+          data["version"]
+        rescue JSON::ParserError
+          nil
+        end
+
+        def display_update_message(version)
+          require_relative "../helpers/color_helper"
+          colors = ColorHelper
+
+          message = "💡 Tip: A new version of #{GEM_NAME} (#{version}) is available. " \
+                    "Update with: #{colors.info("gem update strata-cli")}"
+
+          # Use Thor's say method for consistent output
+          shell = Thor::Shell::Color.new
+          shell.say "\n#{colors.warning(message)}\n"
+        end
+
+        def skip_check?
+          return true if ENV["STRATA_SKIP_VERSION_CHECK"] == "true"
+          return false unless cache_valid?
+
+          # Check was done recently, skip
+          true
+        end
+
+        def cache_valid?
+          return false unless File.exist?(CACHE_FILE)
+
+          cache_time = File.mtime(CACHE_FILE)
+          (Time.now - cache_time) < CACHE_DURATION
+        end
+
+        def update_cache
+          FileUtils.touch(CACHE_FILE)
+        end
+
+        def check_and_notify_if_needed(current_version, args)
+          # Skip version check for version and help commands
+          command = args.first
+          return if args.empty? || %w[version help].include?(command)
+
+          # Early return if we should skip (avoids any work when cache is valid)
+          return if skip_check?
+
+          begin
+            # Run synchronously with timeout to ensure it completes before process exits
+            Timeout.timeout(3) do
+              check_and_notify(current_version)
+            end
+          rescue Timeout::Error
+            # If it takes too long, silently fail
+            nil
+          rescue
+            # Silently fail - version checking should never break the CLI
+            nil
+          end
+        end
+      end
+    end
+  end
+end

data/lib/strata/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Strata
   module CLI
-    VERSION = "0.1.1.beta"
+    VERSION = "0.1.3.beta"
   end
 end

data/lib/strata/cli.rb

@@ -4,6 +4,8 @@ require_relative "cli/version"
 require_relative "cli/configuration"
 require_relative "cli/main"
 require_relative "cli/utils"
+require_relative "cli/utils/git"
+require_relative "cli/utils/version_checker"
 
 module Strata
   class StrataError < StandardError; end
@@ -27,10 +29,16 @@ module Strata
     end
 
     def self.start(args)
-      Main.start(args)
-    rescue TTY::Reader::InputInterrupt
-      warn "\nCancelled."
-      exit(1)
+      Utils::Git.check_requirement_and_exit_if_unavailable(args)
+
+      begin
+        Main.start(args)
+      rescue TTY::Reader::InputInterrupt
+        warn "\nCancelled."
+        exit(1)
+      end
+
+      Utils::VersionChecker.check_and_notify_if_needed(VERSION, args)
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strata-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.1.beta
+  version: 0.1.3.beta
 platform: ruby
 authors:
 - Ajo Abraham
@@ -11,77 +11,77 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: aws-sdk-athena
+  name: dwh
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 0.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
-  name: dwh
+  name: pg
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: mysql2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
-  name: mysql2
+  name: tiny_tds
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: pastel
+  name: trino-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: pg
+  name: aws-sdk-athena
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -95,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: ruby_llm
+  name: aws-sdk-s3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -109,47 +109,75 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: thor
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.2
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.2
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: tiny_tds
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: trino-client
+  name: pastel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.2
 - !ruby/object:Gem::Dependency
   name: tty-prompt
   requirement: !ruby/object:Gem::Requirement
@@ -279,6 +307,7 @@ files:
 - lib/strata/cli/utils/git.rb
 - lib/strata/cli/utils/import_manager.rb
 - lib/strata/cli/utils/test_reporter.rb
+- lib/strata/cli/utils/version_checker.rb
 - lib/strata/cli/utils/yaml_import_resolver.rb
 - lib/strata/cli/version.rb
 - sig/strata/cli.rbs