Class: WorldDb::Model::StateBase

Inherits:
ActiveRecord::Base
  • Object
show all
Extended by:
TextUtils::TagHelper, TextUtils::ValueHelper
Defined in:
lib/worlddb/models/forward.rb,
lib/worlddb/models/state_base.rb

Direct Known Subclasses

County, Muni, Part, State

Class Method Summary collapse

Instance Method Summary collapse

Methods included from TextUtils::ValueHelper

is_state?, match_city, match_country, match_metro, match_metro_flag, match_metro_pop, match_state_for_country, match_supra, match_supra_flag

Class Method Details

.create_or_update_from_attribs(new_attributes, values, opts = {}) ⇒ Object 



87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
 
# File 'lib/worlddb/models/state_base.rb', line 87

def self.create_or_update_from_attribs( new_attributes, values, opts={} )

  ## opts e.g. :skip_tags true|false

  ## fix: add/configure logger for ActiveRecord!!!
  logger = LogKernel::Logger.root

  value_numbers     = []
  value_tag_keys    = []
  value_cities      = []

  ### check for "default" tags - that is, if present new_attributes[:tags] remove from hash
  value_tag_keys += find_tags_in_attribs!( new_attributes )

  ## check for optional values
  values.each_with_index do |value,index|
    if match_country( value ) do |country| # country:
         new_attributes[ :country_id ] = country.id
       end
    elsif match_km_squared( value ) do |num| # allow numbers like 453 km²
            value_numbers << num
          end
    elsif match_number( value ) do |num|  # numeric (nb: can use any _ or spaces inside digits e.g. 1_000_000 or 1 000 000)
            value_numbers << num
          end
    elsif value =~ /#{STATE_CODE_PATTERN}/  ## assume two or three-letter code
      new_attributes[ :code ] = value
    elsif (values.size==(index+1)) && is_taglist?( value )   # tags must be last entry
      logger.debug "   found tags: >>#{value}<<"
      value_tag_keys += find_tags( value )
    else
        
      ### assume it is the capital city - mark it for auto add
      value_cities << value
      next
 
      # issue warning: unknown type for value
      # logger.warn "unknown type for value >#{value}<"
    end
  end # each value

  if value_numbers.size > 0
    new_attributes[ :area ] = value_numbers[0]
    new_attributes[ :pop  ] = value_numbers[1]
  end  # if value_numbers.size > 0

  ## todo: assert that country_id is present/valid, that is, NOT null
  puts "[debug] StateBase.create_or_update_from_attribs calling #{self.name}.where"  # note: assume self is derived class (object)
  # note: was self.find_by_key_and_country_id
  if self == State
    ## note: state scoped by country (all others by top-level state and NOT country)
    rec = self.where(
                  key:         new_attributes[ :key ],
                  country_id:  new_attributes[ :country_id] ).first
  else
    rec = self.where(
                  key:      new_attributes[ :key ],
                  state_id: new_attributes[ :state_id] ).first
  end

  if rec.present?
    logger.debug "update #{self.name} #{rec.id}-#{rec.key}:"
  else
    logger.debug "create #{self.name}:"    ## e.g. self.name => State, County, Muni, etc.
    puts "[debug] StateBase.create_or_update_from_attribs calling #{self.name}.new"  # note: assume self is derived class (object)
    rec = self.new
  end

  logger.debug new_attributes.to_json

  rec.update_attributes!( new_attributes )

  #################
  # auto add capital cities
  #  - note: get added to top-level state (e.g. adm1)

  City.create_or_update_from_titles( value_cities,
                                          state_id:  rec.state_id,
                                          country_id: rec.country_id )

  ### todo/fix: add captial ref to country/state
  ## todo/fix: use update_from_title and only allow one capital city


  ##################
  # add taggings 

  ## todo/fix: reuse - move add taggings into method etc.

    if value_tag_keys.size > 0
      
      if opts[:skip_tags].present?
        logger.debug "   skipping add taggings (flag skip_tag)"
      else
        value_tag_keys.uniq!  # remove duplicates
        logger.debug "   adding #{value_tag_keys.size} taggings: >>#{value_tag_keys.join('|')}<<..."

        ### fix/todo: check tag_ids and only update diff (add/remove ids)

        value_tag_keys.each do |key|
          tag = Tag.find_by_key( key )
          if tag.nil?  # create tag if it doesn't exit
            logger.debug "   creating tag >#{key}<"
            tag = Tag.create!( key: key )
          end
          rec.tags << tag
        end
      end
    end

  rec

end

.create_or_update_from_values(values, more_attribs = {}) ⇒ Object 



73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/worlddb/models/state_base.rb', line 73

def self.create_or_update_from_values( values, more_attribs={} )

  ## key & title & country required
  attribs, more_values = find_key_n_title( values )
  ## fix/hack: change :title to :name
  ## attribs[:name] = attribs[:title]; attribs.delete( :title )
  attribs = attribs.merge( more_attribs )

  ## check for optional values
  puts "[debug] StateBase.create_or_update_from_values calling #{self.name}"  # note: assume self is derived class (object)
  self.create_or_update_from_attribs( attribs, more_values )
end

.parse(*args) ⇒ Object 



65
66
67
68
69
70
71
 
# File 'lib/worlddb/models/state_base.rb', line 65

def self.parse( *args )
  ## remove (extract) attribs hash (if last arg is a hash n present)
  more_attribs = args.last.is_a?(Hash) ? args.pop : {}  ## extract_options!
  values       = args

  self.create_or_update_from_values( values, more_attribs )
end

Instance Method Details

#all_names(opts = {}) ⇒ Object 



51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/worlddb/models/state_base.rb', line 51

def all_names( opts={} )
  ### fix:
  ## allow to passing in sep or separator e.g. | or other

  return name if alt_names.blank?
  
  buf = ''
  buf << name
  buf << ' | '
  buf << alt_names.split('|').join(' | ')
  buf
end

#on_create ⇒ Object

end



37
 
# File 'lib/worlddb/models/state_base.rb', line 37

before_create :on_create

#on_update ⇒ Object 



45
46
47
48
 
# File 'lib/worlddb/models/state_base.rb', line 45

def on_update
  ## fix/todo: check - if name or kind changed - only update if changed ?? why? why not??
  place.update_attributes!( name: name, kind: place_kind )
end

#synonyms ⇒ Object 



33
 
# File 'lib/worlddb/models/state_base.rb', line 33

def synonyms()       alt_names;              end

#synonyms=(value) ⇒ Object 



34
 
# File 'lib/worlddb/models/state_base.rb', line 34

def synonyms=(value) self.alt_names = value; end

#title ⇒ Object

begin compat



30
 
# File 'lib/worlddb/models/state_base.rb', line 30

def title()       name;              end

#title=(value) ⇒ Object 



31
 
# File 'lib/worlddb/models/state_base.rb', line 31

def title=(value) self.name = value; end