us_geo 2.0.4 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6b963948f153ee9add87c2daa3d45fd79ec3ed1d79f156c94bec7cc8b9ca879
-  data.tar.gz: 69b5d532013234f466319b8fc52ba4ea1809579bedc663f80258c7fd80246fef
+  metadata.gz: c76c059a8661033a5ac658fc7cb9aa3f3a10f478adb44c1c1c4681374dba1b78
+  data.tar.gz: fe0d4bc194e683493ed4bc7be6cb0f886b2223c7ae20e9b9c71595300cf4e5ee
 SHA512:
-  metadata.gz: 51b285a6397f15652483f2c9f36eebbf423fa8ceb7b97fd672cb5361860e351333d562a6b36fb39388c21adb67ef4e7156ceaf1ccb88e727683fab5471ff8b1c
-  data.tar.gz: d3ff6ae39376c494ac87f4533f6aeee5017546547f56ac1a1bb1cb35f8ad84cfac89f41090792c494de889d31718db6fff15cecbb13f8eb39ad5ee4823e0ae84
+  metadata.gz: a11dc0cebe135efdec9b1d6a94ebfc87786311ef2266cd987778121de1b18ead07d099914342ba027d0002ff574d4d9f7c39f226c412a3c02c97dc51f9f05fc6
+  data.tar.gz: d23e1c89a23594ee86284f3597a22e0f26f69621b827dc411abad38088aa8faf1b0dace47d619950bc0e5714f75df80034aeb27cec58a41f8960821f14455926

data/CHANGELOG.md

@@ -4,13 +4,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 2.1.1
+
+### Fixed
+
+- Made `belongs_to` associations on models optional so that you don't need to import the full data set in order to have valid records.
+
+## 2.1.0
+
+### Changed
+
+- Lazy load ActiveRecord classes so they don't add overhead during application initialization.
+- Update distribution data files with latest Census data as of March 2024.
+  - Geographic data is based on 2023 Gazetteer files.
+  - Population and housing data are based on 2022 ACS estimates.
+  - Some of the Core Based Statistical Area, Combined Statisical Area, and Metropolitan Division names have changed.
+  - All Urban Areas now include "Urban Area" in their name. The Census Bureau no longer distinguishes between Urbanized Areas and Urban Clusters and the data now reflects the official names.
+
+### Deprecated
+
+- The USGeo::UrbanizedArea and USGeo::UrbanCluster classes are deprecated. These classes are now just aliases for USGeo::UrbanArea. You can still use the `urbanized?` and `cluster?` methods to determine the size of an UrbanArea based on the pre-2020 definition of greater or less then 50,000 residents.
+
 ## 2.0.4
 
+### Fixed
+
 - Remove "Urbanized Area" from short name for urban areas.
 - Fix short name for Louisville, KY in the in the CBSA's, CSA's, and Urban Areas to omit "Jefferson County" so it matches convention for other short names of only showing the major city.
 
-
-
 ## 2.0.3
 
 ### Added

data/README.md

@@ -1,7 +1,8 @@
 # USGeo
 
-[![Build Status](https://travis-ci.com/bdurand/us_geo.svg?branch=master)](https://travis-ci.com/bdurand/us_geo)
+[![Continuous Integration](https://github.com/bdurand/us_geo/actions/workflows/continuous_integration.yml/badge.svg)](https://github.com/bdurand/us_geo/actions/workflows/continuous_integration.yml)
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)
+[![Gem Version](https://badge.fury.io/rb/us_geo.svg)](https://badge.fury.io/rb/us_geo)
 
 This gem provides a variety of U.S. geographic data ActiveRecord models. It is designed to provide a normalized way to access the data from a relational database. This is by no means a complete set of data.
 

data/VERSION

@@ -1 +1 @@
-2.0.4
+2.1.1

data/explorer_app/app/controllers/urban_areas_controller.rb

@@ -5,13 +5,10 @@ class UrbanAreasController < ApplicationController
     urban_areas = USGeo::UrbanArea.not_removed
 
     @tab = params[:tab]
-    if @tab.present?
-      type = if @tab == "urbanized"
-        "UrbanizedArea"
-      elsif @tab == "cluster"
-        "UrbanCluster"
-      end
-      urban_areas = urban_areas.where(type: type)
+    if @tab == "urbanized"
+      urban_areas = urban_areas.where(population: 50_000..)
+    elsif @tab == "cluster"
+      urban_areas = urban_areas.where(population: ...50_000)
     end
 
     @urban_areas = urban_areas.order(:name)

data/lib/us_geo/county.rb

@@ -12,7 +12,7 @@ module USGeo
 
     belongs_to :core_based_statistical_area, foreign_key: :cbsa_geoid, optional: true, inverse_of: :counties
     belongs_to :metropolitan_division, foreign_key: :metropolitan_division_geoid, optional: true, inverse_of: :counties
-    belongs_to :state, foreign_key: :state_code, inverse_of: :counties
+    belongs_to :state, foreign_key: :state_code, optional: true, inverse_of: :counties
 
     has_many :subdivisions, -> { not_removed }, foreign_key: :county_geoid, inverse_of: :county, class_name: "USGeo::CountySubdivision"
 

data/lib/us_geo/county_subdivision.rb

@@ -8,7 +8,7 @@ module USGeo
 
     self.primary_key = "geoid"
 
-    belongs_to :county, foreign_key: :county_geoid, inverse_of: :subdivisions
+    belongs_to :county, foreign_key: :county_geoid, optional: true, inverse_of: :subdivisions
 
     has_many :zcta_county_subdivisions, -> { not_removed }, foreign_key: :county_subdivision_geoid, inverse_of: :county_subdivision, dependent: :destroy
     has_many :zctas, -> { not_removed }, through: :zcta_county_subdivisions

data/lib/us_geo/division.rb

@@ -6,7 +6,7 @@ module USGeo
     include Population
     include Area
 
-    belongs_to :region, inverse_of: :divisions
+    belongs_to :region, optional: true, inverse_of: :divisions
     has_many :states, -> { not_removed }, inverse_of: :division
 
     validates :name, presence: true, length: {maximum: 30}, uniqueness: true

data/lib/us_geo/place.rb

@@ -26,7 +26,7 @@ module USGeo
 
     # !@method primary_county
     #   @return [County] County that contains most of the place.
-    belongs_to :primary_county, foreign_key: :primary_county_geoid, class_name: "USGeo::County"
+    belongs_to :primary_county, foreign_key: :primary_county_geoid, optional: true, class_name: "USGeo::County"
 
     # !@method urban_area
     #   @return [UrbanArea] Urban area that the place is a part of.
@@ -34,7 +34,7 @@ module USGeo
 
     # !@method state
     #   @return [State] State that the place is in.
-    belongs_to :state, foreign_key: :state_code, inverse_of: :places
+    belongs_to :state, foreign_key: :state_code, optional: true, inverse_of: :places
 
     validates :geoid, length: {is: 7}
     validates :state_code, length: {is: 2}

data/lib/us_geo/state.rb

@@ -13,8 +13,8 @@ module USGeo
     self.primary_key = "code"
     self.inheritance_column = :_type_disabled
 
-    belongs_to :region, optional: -> { territory? }, inverse_of: :states
-    belongs_to :division, optional: -> { territory? }, inverse_of: :states
+    belongs_to :region, optional: true, inverse_of: :states
+    belongs_to :division, optional: true, inverse_of: :states
 
     has_many :counties, -> { not_removed }, foreign_key: :state_code, inverse_of: :state
     has_many :places, -> { not_removed }, foreign_key: :state_code, inverse_of: :state

data/lib/us_geo/urban_area.rb

@@ -19,7 +19,7 @@ module USGeo
 
     # !@method primary_county
     #   @return [USGeo::County] Primary county that contains most of the urban area.
-    belongs_to :primary_county, foreign_key: :primary_county_geoid, class_name: "USGeo::County"
+    belongs_to :primary_county, foreign_key: :primary_county_geoid, optional: true, class_name: "USGeo::County"
 
     # !@method urban_area_county_subdivisions
     #   @return [ActiveRecord::Relation<USGeo::UrbanAreaCountySubdivision>] County subdivision to urban area mapping.
@@ -85,12 +85,18 @@ module USGeo
       end
     end
 
+    # Return true if the population is greater than or equal to 50,000.
+    #
+    # @return [Boolean]
     def urbanized?
-      raise NotImplementedError
+      population >= 50_000
     end
 
+    # Return true if the population is less than 50,000.
+    #
+    # @return [Boolean]
     def cluster?
-      raise NotImplementedError
+      population < 50_000
     end
   end
 end

data/lib/us_geo/urban_cluster.rb

@@ -2,6 +2,8 @@
 
 module USGeo
   # Urban area with population < 50,000.
+  #
+  # @deprecated This class will be removed in version 3.0 and only UrbanArea will be used.
   class UrbanCluster < UrbanArea
     def urbanized?
       false

data/lib/us_geo/urbanized_area.rb

@@ -2,6 +2,8 @@
 
 module USGeo
   # Urban area with population >= 50,000.
+  #
+  # @deprecated This class will be removed in version 3.0 and only UrbanArea will be used.
   class UrbanizedArea < UrbanArea
     def urbanized?
       true

data/lib/us_geo/zcta.rb

@@ -36,7 +36,7 @@ module USGeo
 
     # @!method primary_county
     #   @return [USGeo::County] County that contains most of the ZCTA's land area.
-    belongs_to :primary_county, foreign_key: :primary_county_geoid, class_name: "USGeo::County"
+    belongs_to :primary_county, foreign_key: :primary_county_geoid, optional: true, class_name: "USGeo::County"
 
     # @!method zcta_urban_areas
     #   @return [ActiveRecord::Relation] ZCTA to urban area mappings.
@@ -48,7 +48,7 @@ module USGeo
 
     # @!method primary_urban_area
     #   @return [USGeo::UrbanArea] Urban area that contains most of the ZCTA's land area.
-    belongs_to :primary_urban_area, foreign_key: :primary_urban_area_geoid, class_name: "USGeo::UrbanArea"
+    belongs_to :primary_urban_area, foreign_key: :primary_urban_area_geoid, optional: true, class_name: "USGeo::UrbanArea"
 
     # @!method zcta_county_subdivisions
     #   @return [ActiveRecord::Relation] ZCTA to county subdivision mappings.
@@ -60,7 +60,7 @@ module USGeo
 
     # @!method primary_county_subdivision
     #   @return [USGeo::CountySubdivision] County subdivision that contains most of the ZCTA's land area.
-    belongs_to :primary_county_subdivision, foreign_key: :primary_county_subdivision_geoid, class_name: "USGeo::CountySubdivision"
+    belongs_to :primary_county_subdivision, foreign_key: :primary_county_subdivision_geoid, optional: true, class_name: "USGeo::CountySubdivision"
 
     # @!method zcta_places
     #   @return [ActiveRecord::Relation] ZCTA to place mappings.
@@ -72,7 +72,7 @@ module USGeo
 
     # @!method primary_place
     #   @return [USGeo::Place] Place that contains most of the ZCTA's land area.
-    belongs_to :primary_place, foreign_key: :primary_place_geoid, class_name: "USGeo::Place"
+    belongs_to :primary_place, foreign_key: :primary_place_geoid, optional: true, class_name: "USGeo::Place"
 
     # @!method zcta_mappings
     #   @return [ActiveRecord::Relation] 2010 ZCTA to current ZCTA mappings.

data/lib/us_geo.rb

@@ -4,37 +4,37 @@ require "active_record"
 
 require_relative "us_geo/version"
 
-require_relative "us_geo/area"
-require_relative "us_geo/population"
-require_relative "us_geo/base_record"
-
-require_relative "us_geo/region"
-require_relative "us_geo/division"
-require_relative "us_geo/state"
-require_relative "us_geo/combined_statistical_area"
-require_relative "us_geo/core_based_statistical_area"
-require_relative "us_geo/metropolitan_area"
-require_relative "us_geo/micropolitan_area"
-require_relative "us_geo/metropolitan_division"
-require_relative "us_geo/county"
-require_relative "us_geo/county_subdivision"
-require_relative "us_geo/place"
-require_relative "us_geo/place_county"
-require_relative "us_geo/urban_area"
-require_relative "us_geo/urban_area_county"
-require_relative "us_geo/urban_area_county_subdivision"
-require_relative "us_geo/urban_cluster"
-require_relative "us_geo/urbanized_area"
-require_relative "us_geo/zcta"
-require_relative "us_geo/zcta_county"
-require_relative "us_geo/zcta_county_subdivision"
-require_relative "us_geo/zcta_mapping"
-require_relative "us_geo/zcta_place"
-require_relative "us_geo/zcta_urban_area"
-
 require_relative "us_geo/engine" if defined?(::Rails::Engine)
 
 module USGeo
+  autoload :Area, "us_geo/area"
+  autoload :Population, "us_geo/population"
+  autoload :BaseRecord, "us_geo/base_record"
+
+  autoload :Region, "us_geo/region"
+  autoload :Division, "us_geo/division"
+  autoload :State, "us_geo/state"
+  autoload :CombinedStatisticalArea, "us_geo/combined_statistical_area"
+  autoload :CoreBasedStatisticalArea, "us_geo/core_based_statistical_area"
+  autoload :MetropolitanArea, "us_geo/metropolitan_area"
+  autoload :MicropolitanArea, "us_geo/micropolitan_area"
+  autoload :MetropolitanDivision, "us_geo/metropolitan_division"
+  autoload :County, "us_geo/county"
+  autoload :CountySubdivision, "us_geo/county_subdivision"
+  autoload :Place, "us_geo/place"
+  autoload :PlaceCounty, "us_geo/place_county"
+  autoload :UrbanArea, "us_geo/urban_area"
+  autoload :UrbanAreaCounty, "us_geo/urban_area_county"
+  autoload :UrbanAreaCountySubdivision, "us_geo/urban_area_county_subdivision"
+  autoload :UrbanCluster, "us_geo/urban_cluster"
+  autoload :UrbanizedArea, "us_geo/urbanized_area"
+  autoload :Zcta, "us_geo/zcta"
+  autoload :ZctaCounty, "us_geo/zcta_county"
+  autoload :ZctaCountySubdivision, "us_geo/zcta_county_subdivision"
+  autoload :ZctaMapping, "us_geo/zcta_mapping"
+  autoload :ZctaPlace, "us_geo/zcta_place"
+  autoload :ZctaUrbanArea, "us_geo/zcta_urban_area"
+
   BASE_DATA_URI = "https://raw.githubusercontent.com/bdurand/us_geo/master/data/2020_dist"
 
   class << self

data/us_geo.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activerecord", ">= 5.2"
+  spec.add_dependency "csv"
 
   spec.add_development_dependency "bundler"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: us_geo
 version: !ruby/object:Gem::Version
-  version: 2.0.4
+  version: 2.1.1
 platform: ruby
 authors:
 - Brian Durand
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-20 00:00:00.000000000 Z
+date: 2024-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -219,7 +233,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.12
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Collection of geographic data for the United States for use with ActiveRecord