rad_core_rails 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19eb34cf021bf71626e4dffbf85549af5d4f1a66c6e04690e7652a6b716d185b
-  data.tar.gz: 2c5a597b5884b9a8d6cd8ac11eba03e31eeab05f67e04d300542a3fca6f51872
+  metadata.gz: 9c80461bc2b08411eb1989bbda0e49d9cb47e73fbcd3b959c569742dd75f3342
+  data.tar.gz: 7df243406dd934723cf34c117475b3384a0bd237486d390236ea0e9215671234
 SHA512:
-  metadata.gz: 39a39f01993527ae34221b035cd864a4dd35bb6240b54c6e71dded4793f7a098aee0c47a744e72d7a361214a05fc64ee79d2664e8303cf4262c8f36f7dae701c
-  data.tar.gz: ef0ec46b1c1bf8563cdef0747cac98cc95e0c12bc114f0e3d2d76271927f18d6621f53f77a55ecded26351fb59ecf05547cc82261ef16b0d44921948dcd09f48
+  metadata.gz: 5e2f659480bbf9fe6b5eedbeb4a8c007c7877ee572709334a63441bbaeefd6f28488712010532eb7edb086028ad62714568b222a95f293ad387416917b05b098
+  data.tar.gz: 9e3071cd56281bb7f2dcbd22a1c5ff0d106803233f6e537ea5c5f600ae0432bf18edfd99ea136a80aea6290114b6eefb76afbd7e7ba031c03ed104b041575ad0

data/.gitignore

@@ -1,15 +1,17 @@
-/.idea/
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-Gemfile.lock
-bin
-*.gem
-.rspec_status
-.ruby-gemset
-.ruby-version
+/.idea/
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock
+/bin/
+*.gem
+.rspec_status
+.ruby-gemset
+.ruby-version
+/.byebug_history
+.robocop.yml

data/.rubocop.yml

@@ -0,0 +1,4 @@
+AllCops:
+  SuggestExtensions: false
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/Gemfile

@@ -1,6 +1,13 @@
-source "https://rubygems.org"
-
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in new_gem.gemspec
-gemspec
+source "https://rubygems.org"
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in new_gem.gemspec
+gemspec
+
+group :test do
+  gem 'byebug'
+  gem 'pg'
+  gem 'database_cleaner-active_record'
+  gem "factory_bot_rails"
+end

data/README.md

@@ -1,44 +1,104 @@
-# RadCoreRails
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rad_core_rails`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'rad_core_rails'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
-
-    $ gem install rad_core_rails
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rad_core_rails. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/rad_core_rails/blob/master/CODE_OF_CONDUCT.md).
-
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the RadCoreRails project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/rad_core_rails/blob/master/CODE_OF_CONDUCT.md).
+# RadCoreRails
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rad_core_rails`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'rad_core_rails'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install rad_core_rails
+
+## Usage
+
+For basic functionality just include `RadCoreRails` to your `ActiveRecord` model.
+
+```ruby
+class Job < ActiveRecord::Base
+  include RadCoreRails
+  ...
+end
+```
+
+For using Zip Codes by Radius filter follow the steps below:
+
+Step 1 - generate migration: 
+
+```shell script
+rails generate rad_core_rails:zip_codes_migration
+```
+
+Step 2 - migrate DB:
+
+```shell script
+rails db:migrate
+```
+
+Step 3 - import all US zip-codes to your DB:
+> this gem has built in JSON file with all US zip-codes
+
+```shell script
+rails rad_core_rails:import_zip_codes
+```
+
+Step 4 - add new filter to `filter_manifest` method like on example:
+
+> OLD Syntax
+```ruby
+class Job < ActiveRecord::Base
+  include RadCoreRails
+
+  def self.filter_manifest
+    { 
+      zip_codes: ->(filter) { generate_zip_codes_clauses('addresses.zip', filter) } 
+    }.with_indifferent_access
+  end
+end
+```  
+
+> NEW Syntax starting from v0.7.0
+
+```ruby
+class Job < ActiveRecord::Base
+  include RadCoreRails
+
+  filterable zip_codes: [:zip_codes, 'addresses.zip']
+end
+```
+
+Step 5 - filter params example
+
+```ruby
+{ key: 'zip_codes', option: '15', values: ['85001'] }
+```
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rad_core_rails. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/rad_core_rails/blob/master/CODE_OF_CONDUCT.md).
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the RadCoreRails project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/rad_core_rails/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,6 +1,11 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-task :default => :spec
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require './support/active_record_rake_tasks'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+# Stub the :environment task for tasks like db:migrate & db:seed. Since this is a Gem we've explicitly required all
+# dependent files in the needed places and we don't have to load the entire environment.
+task :environment

data/lib/generators/rad_core_rails/templates/migration.rb.tt

@@ -0,0 +1,17 @@
+class <%= migration_class_name %> < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :zip_codes do |t|
+      t.string :city
+      t.string :state
+      t.string :zip
+      t.decimal :latitude, precision: 10, scale: 6
+      t.decimal :longitude, precision: 10, scale: 6
+
+      t.timestamps
+    end
+
+    add_index :zip_codes, :zip, unique: true
+    add_index :zip_codes, :latitude, unique: true
+    add_index :zip_codes, :longitude, unique: true
+  end
+end

data/lib/generators/rad_core_rails/zip_codes_migration_generator.rb

@@ -0,0 +1,18 @@
+require "rails/generators/active_record"
+
+module RadCoreRails
+  module Generators
+    class ZipCodesMigrationGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      source_root File.join(__dir__, "templates")
+
+      def copy_migration
+        migration_template "migration.rb", "db/migrate/create_zip_codes.rb", migration_version: migration_version
+      end
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/rad_core_rails.rb

@@ -1,14 +1,18 @@
-require "rad_core_rails/version"
-require "active_support/concern"
-require "active_record"
-require 'rad_core_rails/query_generator'
-require 'rad_core_rails/search_terms'
-require 'rad_core_rails/sortable'
-
-module RadCoreRails
-  def self.included(receiver)
-    receiver.send :include, Sortable, SearchTerms, QueryGenerator
-  end
-
-  class Error < StandardError; end
-end
+# Need some refactoring: https://ankane.org/gem-patterns
+require "active_record"
+
+require "rad_core_rails/railtie" if defined?(Rails)
+require "rad_core_rails/version"
+require "rad_core_rails/query_generator"
+require "rad_core_rails/search_terms"
+require "rad_core_rails/sortable"
+
+module RadCoreRails
+  autoload :ZipCode, 'rad_core_rails/zip_code'
+
+  def self.included(receiver)
+    receiver.send :include, Sortable, SearchTerms, QueryGenerator
+  end
+
+  class Error < StandardError; end
+end

data/lib/rad_core_rails/query_generator.rb

@@ -1,167 +1,277 @@
-# frozen_string_literal: true
-
-module RadCoreRails
-  module QueryGenerator
-    extend ActiveSupport::Concern
-
-    class_methods do
-      attr_reader :searchable_columns
-
-      def searchable(columns = [])
-        @searchable_columns = handle_columns(columns)
-      end
-
-      def joins_clause
-        <<-SQL
-        SQL
-      end
-
-      def filter_manifest
-        {}.with_indifferent_access
-      end
-
-      def create_filters(search, filters)
-        query = []
-        args = []
-        clause, arguments = generate_search_clause(search)
-        query << clause
-        arguments.each do |arg|
-          args << arg
-        end
-        filters.map do |filter|
-          clause, arguments = filter_manifest[filter[:key]].call(filter)
-          query << clause
-          arguments.each do |arg|
-            args << arg
-          end
-        end
-        [query.reject(&:blank?).join(' AND '), args]
-      end
-
-      def generate_search_clause(search)
-        args = []
-        if search.present? && searchable_columns.is_a?(Array)
-          clause = []
-          search.split(' ').each do |term|
-            columns = []
-            searchable_columns.each do |col|
-              columns.push("(LOWER(#{col}) ILIKE ?)")
-              args.push '%' + term.downcase.strip + '%'
-            end
-            clause.push '(' + columns.join(' OR ') + ')'
-          end
-          ['(' + clause.join(' AND ') + ')', args]
-        else
-          ['', []]
-        end
-      end
-
-      # Generate Boolean clause
-      def generate_boolean_clause(column_name, filter)
-        str = "#{column_name} = ?"
-        args = []
-        args << filter[:values][0]
-
-        [str, args]
-      end
-
-      def generate_model_clause(column_name, filter)
-        str = "(#{column_name} = ANY(ARRAY[?]))"
-        args = [filter[:values]]
-
-        [str, args]
-      end
-
-      def generate_array_clause(column_name, filter)
-        str = "(#{column_name} && ARRAY[?])"
-        args = [filter[:values]]
-
-        [str, args]
-      end
-
-      def generate_reference_link_clause(link_out_type, filter)
-        str = "(reference_links.link_out_type = '#{link_out_type}' AND reference_links.link_out_id = ANY(?))"
-        args = [filter[:values]]
-
-        [str, args]
-      end
-
-      def generate_jsonb_array_clause(unique_filter_key, column_name, filter)
-        str = "(#{column_name}  ?| ARRAY[:#{unique_filter_key}])"
-        args = [{ "#{unique_filter_key}": filter[:values] }]
-
-        [str, args]
-      end
-
-      def generate_number_clause(column_name, filter)
-        option = filter[:option]
-        values = filter[:values]
-        str = ''
-        args = []
-
-        case option
-        when '='
-          str = "#{column_name} = ?"
-          args << values[0]
-        when '>'
-          str = "#{column_name} > ?"
-          args << values[0]
-        when '<'
-          str = "#{column_name} < ?"
-          args << values[0]
-        when '..'
-          str = "(#{column_name} BETWEEN ? AND ?)"
-          args << values[0]
-          args << values[1]
-        end
-        [str, args]
-      end
-
-      def generate_date_clause(column_name, filter)
-        option = filter[:option]
-        values = filter[:values]
-        str = ''
-        args = []
-
-        case option
-        when '='
-          str = "#{column_name}::date = ?::date"
-          args << values[0]
-        when '>'
-          str = "#{column_name}::date > ?::date"
-          args << values[0]
-        when '<'
-          str = "#{column_name}::date < ?::date"
-          args << values[0]
-        when '..'
-          str = "(#{column_name}::date BETWEEN ?::date AND ?::date)"
-          args << values[0]
-          args << values[1]
-        end
-        [str, args]
-      end
-
-      def sort_direction(direction)
-        direction == 'asc' ? 'ASC' : 'DESC'
-      end
-
-      private
-
-      def handle_columns(columns)
-        if columns.empty?
-          return self.columns.select { |c| c.type == :string }.map { |c| "#{table_name}.#{c.name}" }
-        end
-
-        columns.map do |c|
-          splitted_c = c.split('.')
-
-          if splitted_c.size == 1 && splitted_c.first != table_name
-            "#{table_name}.#{c}"
-          else
-            c
-          end
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module RadCoreRails
+  module QueryGenerator
+    extend ActiveSupport::Concern
+
+    class_methods do
+      attr_reader :searchable_columns
+
+      def searchable(columns = [])
+        @searchable_columns = handle_columns(columns)
+      end
+
+      def filterable(filters_data = [])
+        @filter_manifest = handle_filterable(filters_data)
+      end
+
+      def joins_clause
+        <<-SQL
+        SQL
+      end
+
+      def filter_manifest
+        @filter_manifest || {}.with_indifferent_access
+      end
+
+      def create_filters(search, filters)
+        query = []
+        args = []
+        clause, arguments = generate_search_clause(search)
+        query << clause
+        arguments.each do |arg|
+          args << arg
+        end
+        filters.map do |filter|
+          begin
+            clause, arguments = filter_manifest[filter[:key]].call(filter)
+            query << clause
+            arguments.each do |arg|
+              args << arg
+            end
+          rescue NoMethodError
+            raise NoMethodError.new("Filter with the name `#{filter[:key]}` doesn't exist.")
+          end
+        end
+        [query.reject(&:blank?).join(' AND '), args]
+      end
+
+      # def generate_search_clause(search)
+      #   and_args = []
+      #   or_args = []
+      #   if search.present? && searchable_columns.is_a?(Array)
+      #     # search_term_size = search.split(' ').length
+      #     and_terms = search.split(' ').select { |term| !term.include?('+') }
+      #     or_terms = search.split(' ').select { |term| term.include?('+') }
+      #     and_columns = []
+      #     or_columns = []
+      #     # just_ors = search_term_size == or_term_size
+      #     # operand = just_ors ? 'OR' : 'AND'
+      #     # search_terms = just_ors == true ? search.split(' ') : search.split(' ').select { |term| !term.include?('+') }
+      #     and_terms.each do |term|
+      #       columns = []
+      #       and_terms.each do |col|
+      #         and_columns.push("(LOWER(#{col}) ILIKE ?)")
+      #         and_args.push '%' + term.downcase.strip + '%'
+      #       end
+      #       or_terms.each do |col|
+      #         columns.push("(LOWER(#{col}) ILIKE ?)")
+      #         or_args.push '%' + term[1, term.length].downcase.strip + '%'
+      #       end
+      #       clause = if or_columns.empty?
+      #                  '(' + and_columns.join(' OR ') + ')'
+      #                else
+      #                  '(' + '(' + and_columns.join(' OR ') + ')' + 'AND' + '(' + or_columns.join(' OR ') + ')' + ')'
+      #                         end
+      #     end
+      #     [clause, and_args + or_args]
+      #   else
+      #     ['', []]
+      #   end
+      # end
+
+      # @searchable_columns, is an array of column names that you can compare to your terms.
+      #
+      def generate_search_clause(search)
+        if search.present? && searchable_columns.is_a?(Array)
+          # holds all of the sql from sanitized_and_terms
+          and_args = []
+          # holds all the table columns sql for all the AND terms
+          and_clause = []
+          # holds all of the sql from sanitized_or_terms
+          or_args = []
+          # holds all the table columns sql for all the OR terms
+          or_clause = []
+          # extract and terms, remove casing, and add ILIKE '%' comparisions
+          sanitized_and_terms = search.split(' ')
+                                      .reject { |term| term.include?('+') }
+                                      .map { |term| '%' + term.downcase.strip + '%' }
+          # extract or terms, remove casing, and add ILIKE '%' comparisions
+          sanitized_or_terms = search.split(' ')
+                                     .select { |term| term.include?('+') }
+                                     .map { |term| '%' + term[1, term.length].downcase.strip + '%' }
+          # loop through sanitized_and_terms to find all possible columns.
+          sanitized_and_terms.each do |sanitized_term|
+            columns = []
+            # all possible columns where this should be searched
+            searchable_columns.each do |col|
+              columns.push("(LOWER(#{col}) ILIKE ?)")
+              and_args.push sanitized_term
+            end
+            and_clause.push '(' + columns.join(' OR ') + ')'
+          end
+          # loop through sanitized_or_terms to find all possible columns.
+          sanitized_or_terms.each do |sanitized_term|
+            columns = []
+            # all possible columns where this should be searched
+            searchable_columns.each do |col|
+              columns.push("(LOWER(#{col}) ILIKE ?)")
+              or_args.push sanitized_term
+            end
+            or_clause.push '(' + columns.join(' OR ') + ')'
+          end
+          if or_clause.empty? && and_clause.empty?
+            ['', []]
+          elsif or_clause.empty?
+            ['(' + and_clause.join(' AND ') + ')', and_args]
+          elsif and_clause.empty?
+            ['(' + or_clause.join(' OR ') + ')', or_args]
+          else
+            ['((' + and_clause.join(' AND ') + ') AND (' + or_clause.join(' OR ') + '))', and_args + or_args]
+          end
+        else
+          ['', []]
+        end
+      end
+
+      # Generate Boolean clause
+      def generate_boolean_clause(column_name, filter)
+        str = "#{column_name} = ?"
+        args = []
+        args << filter[:values][0]
+
+        [str, args]
+      end
+
+      def generate_model_clause(column_name, filter, optional_exclusion_clause = nil)
+        str = if optional_exclusion_clause.present? && filter[:option] == '!='
+                optional_exclusion_clause
+              else
+                # probably should fix this.
+                # somtimes we arent sending a filter option, so just default it to =
+                "(#{column_name} #{filter[:option] || '='} ANY(ARRAY[?]))"
+              end
+        args = [filter[:values]]
+
+        [str, args]
+      end
+
+      def generate_zip_codes_clause(column_name, filter)
+        str = "(#{column_name} = ANY(#{zip_code_class.distance_query}))"
+        args = zip_code_class.distance_args(filter)
+
+        [str, args]
+      end
+
+      def generate_array_clause(column_name, filter)
+        str = "(#{column_name} && ARRAY[?])"
+        args = [filter[:values]]
+
+        [str, args]
+      end
+
+      def generate_reference_link_clause(link_out_type, filter)
+        str = "(reference_links.link_out_type = '#{link_out_type}' AND reference_links.link_out_id = ANY(?))"
+        args = [filter[:values]]
+
+        [str, args]
+      end
+
+      def generate_jsonb_array_clause(unique_filter_key, column_name, filter)
+        str = "(#{column_name}  ?| ARRAY[:#{unique_filter_key}])"
+        args = [{ "#{unique_filter_key}": filter[:values] }]
+
+        [str, args]
+      end
+
+      def generate_number_clause(column_name, filter)
+        option = filter[:option]
+        values = filter[:values]
+        str = ''
+        args = []
+
+        case option
+        when '='
+          str = "#{column_name} = ?"
+          args << values[0]
+        when '>'
+          str = "#{column_name} > ?"
+          args << values[0]
+        when '<'
+          str = "#{column_name} < ?"
+          args << values[0]
+        when '..'
+          str = "(#{column_name} BETWEEN ? AND ?)"
+          args << values[0]
+          args << values[1]
+        end
+        [str, args]
+      end
+
+      def generate_date_clause(column_name, filter)
+        option = filter[:option]
+        values = filter[:values]
+        str = ''
+        args = []
+
+        case option
+        when '='
+          str = "#{column_name}::date = ?::date"
+          args << values[0]
+        when '>'
+          str = "#{column_name}::date > ?::date"
+          args << values[0]
+        when '<'
+          str = "#{column_name}::date < ?::date"
+          args << values[0]
+        when '..'
+          str = "(#{column_name}::date BETWEEN ?::date AND ?::date)"
+          args << values[0]
+          args << values[1]
+        end
+        [str, args]
+      end
+
+      def sort_direction(direction)
+        direction == 'asc' ? 'ASC' : 'DESC'
+      end
+
+      private
+
+      def handle_columns(columns)
+        return self.columns.select { |c| c.type == :string }.map { |c| "#{table_name}.#{c.name}" } if columns.empty?
+
+        columns.map do |c|
+          splitted_c = c.split('.')
+
+          if splitted_c.size == 1 && splitted_c.first != table_name
+            "#{table_name}.#{c}"
+          else
+            c
+          end
+        end
+      end
+
+      def handle_filterable(filters_data)
+        return nil if filters_data.empty?
+        @zip_code_class = filters_data.delete(:zip_code_class)
+
+        result = {}
+
+        filters_data.each do |filter_data|
+          filter_type, filter_column = filter_data.last
+          result[filter_data.first] = lambda { |filter|
+            public_send("generate_#{filter_type}_clause", filter_column, filter)
+          }
+        end
+
+        result.with_indifferent_access
+      end
+
+      def zip_code_class
+        return RadCoreRails::ZipCode unless @zip_code_class
+        @zip_code_class.to_s.constantize
+      end
+    end
+  end
+end

data/lib/rad_core_rails/railtie.rb

@@ -0,0 +1,7 @@
+module RadCoreRails
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load "tasks/rad_core_rails.rake"
+    end
+  end
+end

data/lib/rad_core_rails/version.rb

@@ -1,5 +1,5 @@
-# frozen_string_literal: true
-
-module RadCoreRails
-  VERSION = '0.5.0'
-end
+# frozen_string_literal: true
+
+module RadCoreRails
+  VERSION = '0.7.0'
+end

data/lib/rad_core_rails/zip_code.rb

@@ -0,0 +1,54 @@
+module RadCoreRails
+  class ZipCode < ActiveRecord::Base
+    self.table_name = 'zip_codes'
+
+    validates_presence_of :city, :state, :zip, :latitude, :longitude
+
+    class << self
+      # Query for returning a one latitude for given zip-code
+      def lat_sub_query
+        <<-SQL
+        SELECT zip_codes.latitude
+        FROM zip_codes
+        WHERE zip = ?
+        LIMIT 1
+        SQL
+      end
+
+      # Query for returning a one longitude value for given zip-code
+      def lng_sub_query
+        <<-SQL
+        SELECT zip_codes.longitude
+        FROM zip_codes
+        WHERE zip = ?
+        LIMIT 1
+        SQL
+      end
+
+      # Query for returning an array of zip codes around the zip-code sent to this function with a given radius in miles.
+      def distance_query
+        <<-SQL
+        WITH t AS (SELECT
+        zip, (
+          3959 * acos (
+            cos(RADIANS((#{lat_sub_query})))
+            * cos(RADIANS(zip_codes.latitude))
+            * cos(RADIANS(zip_codes.longitude) - RADIANS((#{lng_sub_query})))
+            + sin(RADIANS((#{lat_sub_query})))
+            * sin(RADIANS(zip_codes.latitude))
+          )
+        ) AS distance
+        FROM zip_codes) SELECT t.zip FROM t WHERE t.distance < ?
+        SQL
+      end
+
+      # Query arguments for the `distance_query` based on passed filter params.
+      def distance_args(filter)
+        zip_value = filter[:values].try(:first) || ''
+        distance_miles = filter[:option] || 0
+
+        [zip_value, zip_value, zip_value, distance_miles]
+      end
+    end
+  end
+end

data/lib/rad_core_rails/zip_importer.rb

@@ -0,0 +1,43 @@
+require "rad_core_rails/zip_code"
+
+module RadCoreRails
+  class ZipImporter
+    attr_reader :file_path, :zip_codes_data
+
+    def initialize(file_path)
+      @file_path = file_path
+    end
+
+    def call
+      puts "Parsing file..."
+      parse_data
+      puts "Parsing completed."
+
+      puts "Importing data..."
+      import_data!
+      puts "Successfully imported!"
+
+      true
+    end
+
+    private
+
+    def import_data!
+      zip_codes_data.each do |zip_code_data|
+        fields = zip_code_data["fields"]
+
+        RadCoreRails::ZipCode.find_or_create_by!(
+          city: fields["city"].to_s,
+          state: fields["state"].to_s,
+          zip: fields["zip"].to_s,
+          latitude: fields["latitude"].to_s,
+          longitude: fields["longitude"].to_s
+        )
+      end
+    end
+
+    def parse_data
+      @zip_codes_data = JSON.parse(IO.read(file_path))
+    end
+  end
+end

data/lib/resources/us_zip_codes.json

@@ -0,0 +1,102 @@
+[
+   {
+      "datasetid": "us-zip-code-latitude-and-longitude",
+      "recordid": "9656735f9d9c7b64eae1f3f19c263b9598e057de",
+      "fields":
+      {
+         "city": "Eudora",
+         "zip": "66025",
+         "dst": 1,
+         "geopoint": [
+            38.917032, -95.06455
+         ],
+         "longitude": -95.06455,
+         "state": "KS",
+         "latitude": 38.917032,
+         "timezone": -6
+      },
+      "geometry":
+      {
+         "type": "Point",
+         "coordinates": [
+            -95.06455, 38.917032
+         ]
+      },
+      "record_timestamp": "2018-02-09T18:33:38.603+02:00"
+   },
+   {
+      "datasetid": "us-zip-code-latitude-and-longitude",
+      "recordid": "d4fd79372fc6ba5d7205ff4a430b0dcbe0c7dbbd",
+      "fields":
+      {
+         "city": "Savanna",
+         "zip": "74565",
+         "dst": 1,
+         "geopoint": [
+            34.831398, -95.83967
+         ],
+         "longitude": -95.83967,
+         "state": "OK",
+         "latitude": 34.831398,
+         "timezone": -6
+      },
+      "geometry":
+      {
+         "type": "Point",
+         "coordinates": [
+            -95.83967, 34.831398
+         ]
+      },
+      "record_timestamp": "2018-02-09T18:33:38.603+02:00"
+   },
+   {
+      "datasetid": "us-zip-code-latitude-and-longitude",
+      "recordid": "66439c8a6e1286118738eae874a5b0d1ef4dd249",
+      "fields":
+      {
+         "city": "Beckville",
+         "zip": "75631",
+         "dst": 1,
+         "geopoint": [
+            32.237924, -94.46427
+         ],
+         "longitude": -94.46427,
+         "state": "TX",
+         "latitude": 32.237924,
+         "timezone": -6
+      },
+      "geometry":
+      {
+         "type": "Point",
+         "coordinates": [
+            -94.46427, 32.237924
+         ]
+      },
+      "record_timestamp": "2018-02-09T18:33:38.603+02:00"
+   },
+   {
+      "datasetid": "us-zip-code-latitude-and-longitude",
+      "recordid": "0721c46587455339063b0b8e58766ddddfc2d83a",
+      "fields":
+      {
+         "city": "Rancho Santa Fe",
+         "zip": "92067",
+         "dst": 1,
+         "geopoint": [
+            33.016492, -117.20264
+         ],
+         "longitude": -117.20264,
+         "state": "CA",
+         "latitude": 33.016492,
+         "timezone": -8
+      },
+      "geometry":
+      {
+         "type": "Point",
+         "coordinates": [
+            -117.20264, 33.016492
+         ]
+      },
+      "record_timestamp": "2018-02-09T18:33:38.603+02:00"
+   }
+]

data/lib/tasks/rad_core_rails.rake

@@ -0,0 +1,14 @@
+require "rad_core_rails/zip_importer"
+
+namespace :rad_core_rails do
+  desc "Import zip codes data from file"
+  task :import_zip_codes, [:file_path] => [:environment] do |task, args|
+    file_path = args[:file_path] || "#{File.dirname __dir__}/resources/us_zip_codes.json"
+
+    unless ActiveRecord::Base.connection.table_exists? "zip_codes"
+      abort "Table `zip_codes` doesn't exist. Run `rails generate rad_core_rails:zip_codes_migration`"
+    end
+
+    RadCoreRails::ZipImporter.new(file_path).call
+  end
+end

data/rad_core_rails.gemspec

@@ -1,39 +1,44 @@
-require_relative 'lib/rad_core_rails/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "rad_core_rails"
-  spec.version       = RadCoreRails::VERSION
-  spec.authors       = ["Oleksandr Poltavets, James Marrs"]
-  spec.email         = ["sancho.ck@gmail.com"]
-
-  spec.summary       = %q{RadCoreRails}
-  spec.description   = %q{RadCoreRails lib}
-  spec.homepage      = "https://github.com/jamesmarrs/rad-core-rails"
-  spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
-
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://rubygems.org/gems/rad_core_rails"
-  spec.metadata["changelog_uri"] = "https://rubygems.org/gems/rad_core_rails"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency "activesupport", '>= 4.2'
-  spec.add_dependency "activemodel", '>= 4.2'
-  spec.add_dependency "activerecord", '>= 4.2'
-  # spec.add_dependency 'pg', '>= 0.17.1'
-  spec.add_development_dependency "actionpack", '>= 4.2'
-  spec.add_development_dependency "bundler", '>= 1.17.3'
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec", '>= 3.0'
-  # spec.add_development_dependency "simplecov", '~> 0.17', '>= 0.18.5'
-end
+require_relative 'lib/rad_core_rails/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rad_core_rails"
+  spec.version       = RadCoreRails::VERSION
+  spec.authors       = ["Oleksandr Poltavets, James Marrs"]
+  spec.email         = ["sancho.ck@gmail.com"]
+
+  spec.summary       = %q{RadCoreRails}
+  spec.description   = %q{RadCoreRails lib}
+  spec.homepage      = "https://github.com/jamesmarrs/rad-core-rails"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://rubygems.org/gems/rad_core_rails"
+  spec.metadata["changelog_uri"] = "https://rubygems.org/gems/rad_core_rails"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|support|bin|config|db)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # spec.add_dependency "rails", '>= 4.2'
+  spec.add_dependency "activesupport", '>= 4.2'
+  spec.add_dependency "activemodel", '>= 4.2'
+  spec.add_dependency "activerecord", '>= 4.2'
+
+  spec.add_development_dependency "actionpack", '>= 4.2'
+  spec.add_development_dependency "bundler", '>= 1.17.3'
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec-rails"
+  spec.add_development_dependency "factory_bot_rails"
+  spec.add_development_dependency "shoulda-matchers", '>= 4.0'
+  spec.add_development_dependency 'pg', '>= 0.19'
+  spec.add_development_dependency 'railties', '>= 5'
+  # spec.add_development_dependency "simplecov", '~> 0.17', '>= 0.18.5'
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rad_core_rails
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Oleksandr Poltavets, James Marrs
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-13 00:00:00.000000000 Z
+date: 2020-12-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -95,19 +95,75 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: factory_bot_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda-matchers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5'
 description: RadCoreRails lib
 email:
 - sancho.ck@gmail.com
@@ -117,17 +173,25 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".travis.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- lib/generators/rad_core_rails/templates/migration.rb.tt
+- lib/generators/rad_core_rails/zip_codes_migration_generator.rb
 - lib/rad_core_rails.rb
 - lib/rad_core_rails/query_generator.rb
+- lib/rad_core_rails/railtie.rb
 - lib/rad_core_rails/search_terms.rb
 - lib/rad_core_rails/sortable.rb
 - lib/rad_core_rails/version.rb
+- lib/rad_core_rails/zip_code.rb
+- lib/rad_core_rails/zip_importer.rb
+- lib/resources/us_zip_codes.json
+- lib/tasks/rad_core_rails.rake
 - rad_core_rails.gemspec
 homepage: https://github.com/jamesmarrs/rad-core-rails
 licenses: