strata-cli 0.1.2.beta → 0.1.3.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e48bdd7d5b0d81f037b663bb1a1467b040eea4bc5de99c8be04fab7fd04f92a
-  data.tar.gz: 43d4d14d7a45fb456e8a5b3b23133d01aa298762915ff2f145bf124d60b63ae3
+  metadata.gz: 0dc0377469e1bfb8d12c50f839b1f530d2104b1b894e5623d0f009081e60f1e5
+  data.tar.gz: f4595f187e23891e5b1d64ef384ae48b1d3e73bd34a5ab8afefab9886b95f5ad
 SHA512:
-  metadata.gz: 4bfce443a4352e0d0298bdc04aac43a64be83aec1de6698cf94a2df5fecb37f3c85c63da3cc9eb641cede6bfed8505d1546f2e4414e9c78f3a846655fa77944e
-  data.tar.gz: b66964975faf6e3074af3f7fcf6e63417e0ed09aaac756c9f4fdcc6b1b77271ecce3f6f6c18ab9faac2be5ae4b2268f71c87453f77bdf4393e709e3519ca3a2a
+  metadata.gz: b13368ec18b1d53316d3eb01f42f869ff81e8297b2f5451c337073cf0fed8400694a629136c3bbc8bec9b3bfd1affd786a9b1343a4b9b6f3561089d5aba86e9c
+  data.tar.gz: c47cfbdd8e1d54dda6b9b92b3e6385bf14f8d0e03c608721436dafeb70177fe2f51893003721edd1bebb757bbd8f0eefc3164c6c9287707ffc8ee3f86d2175f1

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [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

data/README.md

@@ -10,28 +10,6 @@ Command-line interface for the Strata Semantic Analytics System. Create, manage,
 gem install strata-cli
 ```
 
-### Install Database Adapters
-
-Database adapter gems are optional. Install only the adapters you need:
-
-| Database | Gem | System Libraries |
-|----------|-----|------------------|
-| PostgreSQL | `gem install pg` | [PostgreSQL](https://www.postgresql.org/download/) |
-| MySQL | `gem install mysql2` | [MySQL](https://dev.mysql.com/downloads/) |
-| SQL Server | `gem install tiny_tds` | [FreeTDS](https://www.freetds.org/) |
-| Snowflake | No additional gem needed | None |
-| Athena | `gem install aws-sdk-athena aws-sdk-s3` | None |
-| Trino | `gem install trino-client` | None |
-| DuckDB | `gem install duckdb` | None |
-
-Example for PostgreSQL users:
-
-```bash
-gem install strata-cli pg
-```
-
-If you use an adapter without its gem installed, the CLI will show an error with installation instructions.
-
 ## Requirements
 
 - Ruby >= 3.4.4
@@ -39,13 +17,9 @@ If you use an adapter without its gem installed, the CLI will show an error with
 
 ## Dependencies
 
-### Core Dependency: dwh
-
-The `strata-cli` depends on the [`dwh`](https://github.com/stratasite/dwh) gem (`~> 0.1.0`), which provides the core data warehouse abstraction layer. This gem handles connections, query execution, and introspection across all supported data warehouse adapters. The `dwh` gem requires Ruby >= 3.4.4.
 
 ### Adapter Gems and System Libraries
 
-Adapter gems that use native extensions (`pg`, `mysql2`, `tiny_tds`) require system libraries before `gem install`. Install from the official docs linked in the table above, then run `gem install <adapter-gem>`. If you see **"Failed to build gem native extension"**, the system libraries or build tools for your platform are missing—use the official installation guide for your OS.
 
 ## Commands Overview
 

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

@@ -15,18 +15,6 @@ module Strata
         include DatasourceHelper
         extend Helpers::DescriptionHelper
 
-        # Adapters that require a separate gem. Built-in (snowflake, druid) use dwh's faraday/jwt.
-        ADAPTER_GEMS = {
-          postgres: "pg",
-          redshift: "pg",
-          mysql: "mysql2",
-          sqlserver: "tiny_tds",
-          athena: "aws-sdk-athena, aws-sdk-s3",
-          trino: "trino-client",
-          duckdb: "duckdb",
-          sqlite: "sqlite3"
-        }.freeze
-
         desc "adapters", "Lists supported data warehouse adapters"
         def adapters
           say "\n\tSupported Adapters\n\n", :yellow
@@ -247,10 +235,9 @@ module Strata
         private
 
         def adapter_gem_status
-          ADAPTER_GEMS.to_h do |adapter, gem_spec|
-            gems = gem_spec.split(/,\s*/)
+          DatasourceHelper::ADAPTER_DRIVER_GEMS.to_h do |adapter, gems|
             installed = gems.all? { |g| gem_installed?(g) }
-            [adapter, {gem: gem_spec, installed: installed}]
+            [adapter, {gem: gems.join(", "), installed: installed}]
           end
         end
 

data/lib/strata/cli/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strata-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.2.beta
+  version: 0.1.3.beta
 platform: ruby
 authors:
 - Ajo Abraham
@@ -24,6 +24,90 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: pg
+  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: mysql2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: tiny_tds
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: trino-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-athena
+  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: aws-sdk-s3
+  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: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +122,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: pastel
   requirement: !ruby/object:Gem::Requirement