olaf 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d1640a5221b0ed5a71b4fbb2ca11d113d69ef7436e7b7c2628497c4767a4245
-  data.tar.gz: fd816660fe86290c5f5d8148a11823b2c2580e66096817d343b958fcbb1fc30e
+  metadata.gz: 9d45d092623bf97e4a23624cfcc145afd281dcb91011bee43e9086e35f1af9ff
+  data.tar.gz: 54ae40103a4ed018b04be956f86ad9316a2239ab719e721e33eb9d79a11e1b2c
 SHA512:
-  metadata.gz: b1f71e253ff7cb95a7eef3d97324f6615d43c57aaa39e9128fcdce5f8ef683ed2a742d852aff034adf3cbd8fd04ddfa2d58a1c7372edea79843f0ab12581735a
-  data.tar.gz: db997081fd2f622d354cd7bcb65a73c45ef55eba1bb71d8788b08590cb02e3500cdc428da78697ff838666daac3996d6f8a83cdfd14bbd3750655e308967507c
+  metadata.gz: f874ca55bef0c740c90084a7db2e0487668a55c4af33e6d8879c798677aa4921eb0aa1c1f146d0af54c2de854b61c783c0a70e362b31c2cc5baf8cbee8ab37d4
+  data.tar.gz: 97331d8aa92d9b735b45c7931a08bccc49db2e97caee1ab11c1b0f19c067b63192a29625c356a90d5d85eee8f1f59ed924c4712d71ba5bbfbe581a058a911cc2

data/README.md

@@ -1,7 +1,6 @@
 # Olaf
 
-Olaf is a small Ruby wrapper for warehouse queries, running them in Snowflake or
-in BigQuery.
+Olaf is a small Ruby wrapper for warehouse queries, running them in BigQuery.
 
 ![Olaf](https://user-images.githubusercontent.com/56375/96335285-8c86f080-106f-11eb-9489-999a884f1246.jpg)
 
@@ -13,7 +12,6 @@ and only when it is used, so add to your `Gemfile` the ones you configure:
 
 | Driver            | Gems                    | Also needs              |
 | ----------------- | ----------------------- | ----------------------- |
-| `Olaf::Snowflake` | `sequel`, `ruby-odbc`   | the ODBC system library |
 | `Olaf::BigQuery`  | `google-cloud-bigquery` |                         |
 | `Olaf::Fake`      | —                       |                         |
 
@@ -34,7 +32,7 @@ control in the code and in tests.
 class FetchUsers
   include Olaf::QueryDefinition
 
-  template './snowflake/users_in_department.sql'
+  template './big_query/users_in_department.sql'
 
   argument :department_id
 
@@ -52,7 +50,6 @@ Olaf.execute(query)
 One driver, which every query runs on:
 
 ```ruby
-Olaf.configure(user: 'olaf')             # Olaf::Snowflake, the default
 Olaf.configure(olaf_driver: Olaf::Fake)  # ideal for testing
 ```
 
@@ -62,10 +59,10 @@ run on the `default:`, the first one given when it is not specified:
 ```ruby
 Olaf.configure(
   drivers: {
-    snowflake: Olaf::Snowflake.new(user: 'olaf'),
-    big_query: Olaf::BigQuery.new(project: 'carwow', labels: { service: 'flatmin' })
+    big_query: Olaf::BigQuery.new(project: 'carwow', labels: { service: 'flatmin' }),
+    fake: Olaf::Fake.new
   },
-  default: :snowflake
+  default: :big_query
 )
 
 class FetchUsers

data/lib/olaf/query_definition/class_methods.rb

@@ -3,7 +3,7 @@ module Olaf
     module ClassMethods
       # Creates a new instance of the Query defined and validates
       # the parameters passed, leaving the instance in a ready-to-execute state.
-      #   @return Snowflake::QueryDefinition instance
+      #   @return Olaf::QueryDefinition instance
       def prepare(**vars)
         new(**vars).prepare
       end
@@ -15,9 +15,9 @@ module Olaf
       end
 
       # Define an argument for the query matching a placeholder in the template.
-      # The Sequel gem, will fill the placeholders in the SQL query escaping the
-      # value passed as an argument. Sometimes, we need to pass an argument as
-      # literal to avoid the single quotes added by Sequel (i.e. sending a table_name)
+      # The driver binds the value passed as a query parameter. Sometimes, we need
+      # to pass an argument as literal to substitute it into the SQL instead
+      # (i.e. sending a table_name)
       #
       # options - Hash config for each argument
       #   :as - Argument Type
@@ -26,7 +26,7 @@ module Olaf
       # Example:
       #
       #     class OneQuery
-      #       include Snowflake::QueryDefinition
+      #       include Olaf::QueryDefinition
       #
       #       template 'reports/one.sql'
       #
@@ -48,7 +48,7 @@ module Olaf
       # Example:
       #
       #     class OneQuery
-      #       include Snowflake::QueryDefinition
+      #       include Olaf::QueryDefinition
       #
       #       template 'reports/one.sql'
       #     end
@@ -93,7 +93,7 @@ module Olaf
       # Example:
       #
       #     class OneQuery
-      #       include Snowflake::QueryDefinition
+      #       include Olaf::QueryDefinition
       #
       #       row_object MyOwnObject
       #     end

data/lib/olaf/query_definition.rb

@@ -20,8 +20,8 @@ module Olaf
     #
     #   @return QueryDefinition instance
     #
-    #   @raises Snowflake::UndefinedArgumentsError
-    #   @raises Snowflake::MissingArgumentsError
+    #   @raises Olaf::UndefinedArgumentsError
+    #   @raises Olaf::MissingArgumentsError
     def prepare
       @sql_template ||= File.read(self.class.template)
 

data/lib/olaf.rb

@@ -5,21 +5,19 @@ module Olaf
   # Autoloaded: each driver pulls in its own client library.
   autoload :BigQuery, File.expand_path('olaf/drivers/big_query', __dir__)
   autoload :Fake, File.expand_path('olaf/drivers/fake', __dir__)
-  autoload :Snowflake, File.expand_path('olaf/drivers/snowflake', __dir__)
 
   DEFAULT_DRIVER = :default
 
   # Configures the drivers used to execute queries, either a single one built
   # from the arguments given:
   #
-  #     Olaf.configure(user: 'olaf')             # Olaf::Snowflake, the default
   #     Olaf.configure(olaf_driver: Olaf::Fake)  # ideal for testing
   #
   # or several instantiated ones, which queries pick by name with `driver`:
   #
   #     Olaf.configure(
-  #       drivers: { snowflake: Olaf::Snowflake.new(user: 'olaf'), big_query: Olaf::BigQuery.new(project: 'carwow') },
-  #       default: :snowflake
+  #       drivers: { big_query: Olaf::BigQuery.new(project: 'carwow'), fake: Olaf::Fake.new },
+  #       default: :big_query
   #     )
   #
   #   @return the default Olaf driver instance
@@ -36,7 +34,9 @@ module Olaf
 
         [drivers.dup, default_driver]
       else
-        [{ DEFAULT_DRIVER => (olaf_driver || Snowflake).new(**args) }, DEFAULT_DRIVER]
+        raise ArgumentError, 'Pass `drivers:` or a single `olaf_driver:` to configure' unless olaf_driver
+
+        [{ DEFAULT_DRIVER => olaf_driver.new(**args) }, DEFAULT_DRIVER]
       end
 
     instance
@@ -64,9 +64,8 @@ module Olaf
   # what keeps `Olaf::Fake` covering every query in tests.
   #
   #   @return Olaf driver instance
-  #     * Olaf::Fake      - Ideal for testing
-  #     * Olaf::Snowflake - Sequel.odbc driver to run queries in Snowflake
-  #     * Olaf::BigQuery  - google-cloud-bigquery driver to run queries in BigQuery
+  #     * Olaf::Fake     - Ideal for testing
+  #     * Olaf::BigQuery - google-cloud-bigquery driver to run queries in BigQuery
   #
   def self.instance(name = nil)
     drivers = @drivers || raise('You need to configure Olaf before using it!')

data/olaf.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = 'olaf'
-  s.version     = '0.3.0'
+  s.version     = '1.0.0'
   s.date        = Time.now.strftime('%Y-%m-%d')
   s.summary     = 'Ruby wrapper for warehouse queries.'
   s.authors     = ['Emiliano Mancuso']
@@ -18,9 +18,7 @@ Gem::Specification.new do |s|
 
   # Drivers load their own client libraries, so consumers only install the ones
   # they configure:
-  #   Olaf::Snowflake - sequel and ruby-odbc
-  #   Olaf::BigQuery  - google-cloud-bigquery
+  #   Olaf::BigQuery - google-cloud-bigquery
   s.add_development_dependency 'google-cloud-bigquery', '~> 1.64'
-  s.add_development_dependency 'sequel', '~> 5.37'
   s.add_development_dependency 'test-unit', '~> 3.3'
 end

data/test/olaf_configure_test.rb

@@ -20,10 +20,10 @@ class OlafConfigureTest < Test::Unit::TestCase
     assert_equal Olaf.instance.config, { other: 'configs', like: 'user and passwd' }
   end
 
-  def test_configure_defaults_to_snowflake
-    Olaf.configure(random: 'stuff')
-
-    assert Olaf.instance.is_a?(Olaf::Snowflake)
+  def test_configure_requires_a_driver
+    assert_raise ArgumentError do
+      Olaf.configure(random: 'stuff')
+    end
   end
 
   def test_configure_returns_the_default_driver
@@ -31,33 +31,33 @@ class OlafConfigureTest < Test::Unit::TestCase
   end
 
   def test_configure_registers_several_drivers
-    snowflake = MockDriver.new
+    postgres = MockDriver.new
     big_query = MockDriver.new
 
-    Olaf.configure(drivers: { snowflake: snowflake, big_query: big_query }, default: :snowflake)
+    Olaf.configure(drivers: { postgres: postgres, big_query: big_query }, default: :postgres)
 
-    assert_equal Olaf.instance, snowflake
-    assert_equal Olaf.instance(:snowflake), snowflake
+    assert_equal Olaf.instance, postgres
+    assert_equal Olaf.instance(:postgres), postgres
     assert_equal Olaf.instance(:big_query), big_query
   end
 
   def test_configure_defaults_to_the_first_driver_registered
-    snowflake = MockDriver.new
+    postgres = MockDriver.new
 
-    Olaf.configure(drivers: { snowflake: snowflake, big_query: MockDriver.new })
+    Olaf.configure(drivers: { postgres: postgres, big_query: MockDriver.new })
 
-    assert_equal Olaf.instance, snowflake
+    assert_equal Olaf.instance, postgres
   end
 
   def test_configure_rejects_a_default_that_was_not_registered
     assert_raise_message(/Unknown default driver :redshift/) do
-      Olaf.configure(drivers: { snowflake: MockDriver.new }, default: :redshift)
+      Olaf.configure(drivers: { postgres: MockDriver.new }, default: :redshift)
     end
   end
 
   def test_configure_rejects_both_forms_at_once
     assert_raise ArgumentError do
-      Olaf.configure(olaf_driver: MockDriver, drivers: { snowflake: MockDriver.new })
+      Olaf.configure(olaf_driver: MockDriver, drivers: { postgres: MockDriver.new })
     end
   end
 
@@ -74,7 +74,7 @@ class OlafConfigureTest < Test::Unit::TestCase
   end
 
   def test_instance_raises_for_a_driver_that_was_not_registered
-    Olaf.configure(drivers: { snowflake: MockDriver.new, big_query: MockDriver.new })
+    Olaf.configure(drivers: { postgres: MockDriver.new, big_query: MockDriver.new })
 
     assert_raise Olaf::UnknownDriverError do
       Olaf.instance(:redshift)

data/test/olaf_execute_test.rb

@@ -81,7 +81,7 @@ class OlafExecuteTest < Test::Unit::TestCase
     default_driver = RecordingDriver.new
     other_driver = RecordingDriver.new
 
-    Olaf.configure(drivers: { big_query: other_driver, snowflake: default_driver }, default: :snowflake)
+    Olaf.configure(drivers: { big_query: other_driver, postgres: default_driver }, default: :postgres)
 
     Olaf.execute(@query_instance)
 
@@ -98,7 +98,7 @@ class OlafExecuteTest < Test::Unit::TestCase
   end
 
   def test_execute_raises_when_the_driver_declared_is_not_configured
-    Olaf.configure(drivers: { default: RecordingDriver.new, snowflake: RecordingDriver.new })
+    Olaf.configure(drivers: { default: RecordingDriver.new, postgres: RecordingDriver.new })
 
     @query.driver :big_query
 

data/test/olaf_lazy_loading_test.rb

@@ -12,15 +12,13 @@ class OlafLazyLoadingTest < Test::Unit::TestCase
     assert_equal loaded_after('require "olaf"; Olaf.configure(olaf_driver: Olaf::Fake)'), []
   end
 
-  def test_configuring_the_snowflake_driver_loads_sequel_only
-    assert_equal loaded_after('require "olaf"; Olaf.configure(user: "olaf")'), ['sequel']
+  def test_configuring_the_big_query_driver_loads_its_client_only
+    assert_equal loaded_after('require "olaf"; Olaf.configure(olaf_driver: Olaf::BigQuery)'), ['google-cloud-bigquery']
   end
 
   private
 
   DEPENDENCIES = {
-    'sequel' => 'Sequel',
-    'odbc_utf8' => 'ODBC',
     'google-cloud-bigquery' => 'Google::Cloud::Bigquery'
   }.freeze
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: olaf
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Emiliano Mancuso
 bindir: bin
 cert_chain: []
-date: 2026-09-03 00:00:00.000000000 Z
+date: 2026-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-bigquery
@@ -23,20 +23,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.64'
-- !ruby/object:Gem::Dependency
-  name: sequel
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.37'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.37'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -62,7 +48,6 @@ files:
 - lib/olaf.rb
 - lib/olaf/drivers/big_query.rb
 - lib/olaf/drivers/fake.rb
-- lib/olaf/drivers/snowflake.rb
 - lib/olaf/errors.rb
 - lib/olaf/query_definition.rb
 - lib/olaf/query_definition/class_methods.rb

data/lib/olaf/drivers/snowflake.rb

@@ -1,28 +0,0 @@
-require 'sequel'
-
-module Olaf
-  class Snowflake
-    WRAPPED_ERRORS = [Sequel::DatabaseError].freeze
-
-    def initialize(**config)
-      @config = config
-    end
-
-    def fetch(olaf_query)
-      conn.fetch(olaf_query.sql_template, **olaf_query.variables).all
-    rescue *WRAPPED_ERRORS => error
-      raise QueryExecutionError.new(error.message, olaf_query)
-    end
-
-    private
-
-    def conn
-      # Only opening a connection needs the ODBC system library.
-      @conn ||= begin
-        require 'odbc_utf8'
-
-        Sequel.odbc('snowflake', **@config)
-      end
-    end
-  end
-end