strata-cli 0.1.1.beta → 0.1.2.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9887ae6b4d871118361a7ef0b90c6b07a5095c59f8b7acc812aefc4ef8e5a58
-  data.tar.gz: e2fba95feba89bb6193d563f7b2dba3e594ea57915c56700f9228b29783c942a
+  metadata.gz: 0e48bdd7d5b0d81f037b663bb1a1467b040eea4bc5de99c8be04fab7fd04f92a
+  data.tar.gz: 43d4d14d7a45fb456e8a5b3b23133d01aa298762915ff2f145bf124d60b63ae3
 SHA512:
-  metadata.gz: d131c145bc2cf2aab4c532266f2d7bd8df1026053ff3b0cce4734867132ec6f2500147b645aecf28fe1e2a3d3d99803d26ce02e7484f6f0d4c9a399fa9ccd8e0
-  data.tar.gz: a7c089088c80acbc89e9de821de1ab482a4d51f685ac3a06089f1e0469945e05720fdebdb09ea9d114c14cf7c7768c0073d5b3a26bcf357a45ba7fbc474723ce
+  metadata.gz: 4bfce443a4352e0d0298bdc04aac43a64be83aec1de6698cf94a2df5fecb37f3c85c63da3cc9eb641cede6bfed8505d1546f2e4414e9c78f3a846655fa77944e
+  data.tar.gz: b66964975faf6e3074af3f7fcf6e63417e0ed09aaac756c9f4fdcc6b1b77271ecce3f6f6c18ab9faac2be5ae4b2268f71c87453f77bdf4393e709e3519ca3a2a

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [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,15 +4,48 @@ Command-line interface for the Strata Semantic Analytics System. Create, manage,
 
 ## Installation
 
+### Basic Installation
+
 ```bash
 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
 - Git (for deployment features)
-- Access to a Strata server
+
+## 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
 
@@ -54,6 +87,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 +292,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/sub_commands/datasource.rb

@@ -15,6 +15,18 @@ 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
@@ -23,6 +35,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 +246,21 @@ module Strata
 
         private
 
+        def adapter_gem_status
+          ADAPTER_GEMS.to_h do |adapter, gem_spec|
+            gems = gem_spec.split(/,\s*/)
+            installed = gems.all? { |g| gem_installed?(g) }
+            [adapter, {gem: gem_spec, 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.2.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.2.beta
 platform: ruby
 authors:
 - Ajo Abraham
@@ -10,20 +10,6 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !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: dwh
   requirement: !ruby/object:Gem::Requirement
@@ -52,20 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.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: pastel
   requirement: !ruby/object:Gem::Requirement
@@ -80,20 +52,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.8'
-- !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: ruby_llm
   requirement: !ruby/object:Gem::Requirement
@@ -122,34 +80,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.3.2
-- !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: tty-prompt
   requirement: !ruby/object:Gem::Requirement
@@ -279,6 +209,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