has_geo_lookup 0.1.0

data/lib/tasks/has_geo_lookup.rake

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+namespace :has_geo_lookup do
+  desc "Check HasGeoLookup database setup (columns and indexes)"
+  task check_setup: :environment do
+    puts HasGeoLookup::IndexChecker.performance_report
+  end
+
+  desc "Generate Rails migration for complete HasGeoLookup setup"
+  task create_setup: :environment do
+    migration_path = HasGeoLookup::IndexChecker.generate_index_migration
+    
+    if migration_path
+      puts "\n✓ Migration generated successfully!"
+      puts "Next steps:"
+      puts "  1. Review the migration: #{migration_path}"
+      puts "  2. Run: rails db:migrate"
+    end
+  end
+
+  desc "Preview HasGeoLookup setup changes without executing (dry run)"
+  task preview_setup: :environment do
+    results = HasGeoLookup::IndexChecker.analyze_all_models
+    
+    if results.empty?
+      puts "No models found that include HasGeoLookup"
+      exit 0
+    end
+    
+    models_with_missing = results.select do |_, analysis|
+      (analysis[:missing_columns] || 0) > 0 || (analysis[:missing_indexes] || 0) > 0
+    end
+    
+    if models_with_missing.empty?
+      puts "✓ All models have optimal HasGeoLookup setup"
+      exit 0
+    end
+    
+    puts "Preview: HasGeoLookup setup changes that would be created"
+    puts "=" * 70
+    
+    models_with_missing.each do |model_name, analysis|
+      puts "\n#{model_name} (#{analysis[:table_name]}):"
+      
+      if (analysis[:missing_columns] || 0) > 0
+        puts "  Missing columns:"
+        analysis[:missing_column_details].each do |col_def|
+          puts "    add_column :#{analysis[:table_name]}, :#{col_def[:name]}, :#{col_def[:type]}"
+        end
+      end
+      
+      if (analysis[:missing_indexes] || 0) > 0
+        puts "  Missing indexes:"
+        analysis[:recommendations].each do |command|
+          puts "    #{command}"
+        end
+      end
+    end
+    
+    puts "\n" + "=" * 70
+    puts "To create this setup, run: rake has_geo_lookup:create_setup"
+  end
+
+  desc "Show detailed index analysis for a specific model"
+  task :analyze_model, [:model_name] => :environment do |task, args|
+    unless args[:model_name]
+      puts "Usage: rake has_geo_lookup:analyze_model[ModelName]"
+      puts "Example: rake has_geo_lookup:analyze_model[Listing]"
+      exit 1
+    end
+    
+    begin
+      model = args[:model_name].constantize
+    rescue NameError
+      puts "Error: Model '#{args[:model_name]}' not found"
+      exit 1
+    end
+    
+    unless model.include?(HasGeoLookup)
+      puts "Error: Model '#{args[:model_name]}' does not include HasGeoLookup"
+      exit 1
+    end
+    
+    analysis = HasGeoLookup::IndexChecker.check_model(model)
+    
+    puts "=" * 60
+    puts "HasGeoLookup Index Analysis: #{args[:model_name]}"
+    puts "=" * 60
+    puts "Table: #{analysis[:table_name]}"
+    puts "Missing indexes: #{analysis[:missing_indexes]}"
+    
+    if analysis[:existing_indexes].any?
+      puts "\nExisting coordinate/geo indexes:"
+      analysis[:existing_indexes].each do |columns|
+        puts "  • #{columns.join(', ')}"
+      end
+    end
+    
+    if analysis[:recommendations].any?
+      puts "\nRecommended additions:"
+      analysis[:recommendations].each do |rec|
+        puts "  #{rec}"
+      end
+    else
+      puts "\n✓ All recommended indexes are present"
+    end
+    
+    puts "=" * 60
+  end
+
+end

data/sig/has_geo_lookup.rbs

@@ -0,0 +1,4 @@
+module HasGeoLookup
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: has_geo_lookup
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael Edlund
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: iso_3166
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: rgeo
+  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: rgeo-geojson
+  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: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: A Ruby gem that provides geographic lookup functionality using both GeoBoundaries.org
+  and Geonames.org datasets. Features include coordinate validation with radian/degree
+  detection, spatial containment queries, distance-based lookups, and data coverage
+  analysis utilities.
+email:
+- medlund@mac.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/generators/has_geo_lookup/install_generator.rb
+- lib/generators/has_geo_lookup/templates/INSTALL.md
+- lib/generators/has_geo_lookup/templates/create_feature_codes.rb.erb
+- lib/generators/has_geo_lookup/templates/create_geoboundaries.rb.erb
+- lib/generators/has_geo_lookup/templates/create_geoboundaries_metros.rb.erb
+- lib/generators/has_geo_lookup/templates/create_geonames.rb.erb
+- lib/generators/has_geo_lookup/templates/create_geonames_metros.rb.erb
+- lib/generators/has_geo_lookup/templates/create_metros.rb.erb
+- lib/has_geo_lookup.rb
+- lib/has_geo_lookup/concern.rb
+- lib/has_geo_lookup/index_checker.rb
+- lib/has_geo_lookup/models/feature_code.rb
+- lib/has_geo_lookup/models/geoboundary.rb
+- lib/has_geo_lookup/models/geoname.rb
+- lib/has_geo_lookup/models/metro.rb
+- lib/has_geo_lookup/railtie.rb
+- lib/has_geo_lookup/version.rb
+- lib/tasks/has_geo_lookup.rake
+- sig/has_geo_lookup.rbs
+homepage: https://github.com/arcticleo/has_geo_lookup
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/arcticleo/has_geo_lookup
+  source_code_uri: https://github.com/arcticleo/has_geo_lookup
+  changelog_uri: https://github.com/arcticleo/has_geo_lookup/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.1
+specification_version: 4
+summary: Geographic lookup functionality using GeoBoundaries and Geonames data
+test_files: []