strata-cli 0.1.0.beta → 0.1.2.beta

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d417b55f20b06dadf03dd915ec77c78ac145a95ee820d3728ef31ba399aadf57
-  data.tar.gz: 929ee748ca1082a29ac9de3a348768e93aaa4ec494a9d6033fba2de3f4d12966
+  metadata.gz: 0e48bdd7d5b0d81f037b663bb1a1467b040eea4bc5de99c8be04fab7fd04f92a
+  data.tar.gz: 43d4d14d7a45fb456e8a5b3b23133d01aa298762915ff2f145bf124d60b63ae3
 SHA512:
-  metadata.gz: d821fe082a53140b3ae66bd7d612198dbba107d5c7bfccb3bee530fb30e831f3be8c86066062463a1ee79347910d6d3e006dc8f8bf4988c5860de9272e0016dc
-  data.tar.gz: 298ec8199c214af514816a2f8dc00068a9f5f073c3cf395cf3904b213875d55719eb558c24a79f22f3fc2c4e8fe790ea98c811ac8155c061262f5a60645dcea0
+  metadata.gz: 4bfce443a4352e0d0298bdc04aac43a64be83aec1de6698cf94a2df5fecb37f3c85c63da3cc9eb641cede6bfed8505d1546f2e4414e9c78f3a846655fa77944e
+  data.tar.gz: b66964975faf6e3074af3f7fcf6e63417e0ed09aaac756c9f4fdcc6b1b77271ecce3f6f6c18ab9faac2be5ae4b2268f71c87453f77bdf4393e709e3519ca3a2a

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-01-22
+## [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,37 +4,48 @@ Command-line interface for the Strata Semantic Analytics System. Create, manage,
 
 ## Installation
 
+### Basic Installation
+
 ```bash
 gem install strata-cli
 ```
 
-Or add to your Gemfile:
+### 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
-bundle add strata-cli
+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
 
-## Quick Start
+## Dependencies
 
-```bash
-# Initialize a new project
-strata init my-project
+### Core Dependency: dwh
 
-# Add a datasource
-strata datasource add
+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.
 
-# Create a semantic table model
-strata create table customers
+### Adapter Gems and System Libraries
 
-# Deploy to server
-strata deploy
-```
+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
 
@@ -76,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.
 
@@ -278,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.
 
@@ -306,9 +323,9 @@ project_id: 123  # Auto-populated after first deployment
 server: http://localhost:3000
 
 # Environment-specific configs
-dev:
-  server: http://localhost:3000
-  api_key: dev-key
+staging:
+  server: https://staging.strata.com
+  api_key: staging-key
 
 production:
   server: https://app.strata.com
@@ -436,7 +453,7 @@ strata deploy
 After checking out the repo:
 
 ```bash
-bin/setup
+bundle install
 ```
 
 Run tests:
@@ -445,16 +462,12 @@ Run tests:
 rake test
 ```
 
-Install locally:
-
-```bash
-bundle exec rake install
-```
-
 Release a new version:
 
 1. Update version in `lib/strata/cli/version.rb`
-2. Run `bundle exec rake release`
+2. Update `CHANGELOG.md` with the new version and changes
+3. Commit the changes: `git add lib/strata/cli/version.rb CHANGELOG.md && git commit -m "Bump version to X.Y.Z"`
+4. Run `bundle exec rake release` (builds gem, creates git tag, and pushes to rubygems.org)
 
 ## Contributing
 

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/deployment_monitor.rb

@@ -418,12 +418,10 @@ module Strata
             return nil if latest_test_run.nil? && @has_tests == true
 
             display_test_results_if_available(deployment)
-            return deployment
           else
             display_final_status(deployment)
-            return deployment
           end
-          nil
+          deployment
         end
 
         def display_test_results_if_available(deployment)

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/test_reporter.rb

@@ -110,7 +110,7 @@ module Strata
             say "   Generated: #{truncate(test["generated_sql"], 200)}", :error
           end
 
-          if test["failing_values"] && test["failing_values"].is_a?(Array) && test["failing_values"].any?
+          if test["failing_values"]&.is_a?(Array) && test["failing_values"].any?
             sample_values = test["failing_values"].first(5)
             say "   Sample failing values: #{sample_values.inspect}", :error
           end

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.0.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,28 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: strata-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.0.beta
+  version: 0.1.2.beta
 platform: ruby
 authors:
 - Ajo Abraham
+- Allen Jiji
 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
@@ -51,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
@@ -79,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
@@ -121,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
@@ -191,10 +122,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.3'
-description: CLI tool to interact with your Strata servers. Create new projects and
-  deploy them.
+description: |
+  Comprehensive CLI tool for managing Strata Semantic Analytics projects. Create and initialize
+  projects, manage datasource connections, build semantic table models with AI assistance, run
+  audits and validations, and deploy projects to Strata servers. Supports multiple data warehouse
+  adapters including PostgreSQL, MySQL, SQL Server, Snowflake, Athena, Trino, and more.
 email:
 - ajo@strata.site
+- allen@strata.site
 executables:
 - strata
 extensions: []
@@ -274,18 +209,15 @@ 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
-homepage: https://strata.size
+homepage: https://strata.site
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://strata.size
-  source_code_uri: https://github.com/stratasite/strata-cli.git
-  changelog_uri: https://github.com/stratasite/strata-cli/blob/master/CHANGELOG.md
-  bug_tracker_uri: https://github.com/stratasite/strata-cli/issues
-  documentation_uri: https://github.com/stratasite/strata-cli#readme
+  homepage_uri: https://strata.site
 rdoc_options: []
 require_paths:
 - lib
@@ -302,5 +234,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: CLI for the Strata Semantic Analytics System.
+summary: Command-line interface for the Strata Semantic Analytics System
 test_files: []