china_region_fu 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+doc

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in china_region_fu.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,62 @@
+= ChinaRegionFu
+
+ChinaRegionFu include the region data of china,and region CURD actions.Got ChinaRegionFu it means you got
+a powerfull region controller system about china.
+       
+
+== Getting Started
+
+1. Put 'gem china_region_fu' to your Gemfile:
+
+    gem china_region_fu
+
+2. Run bundler command to install the gem:
+
+    bundle install
+
+3. After you install the gem, you need run the generator:
+
+    rails g china_region_fu:install
+   
+   It will:
+   * Generate <em>db/migrate/<timestamp>create_china_region_tables.rb</em> migrate file to your app, *_china_regions_* table is used for store the regions.
+   * Copy regions.yml to config/ directory.
+   * Run "rake db:migrate".
+   * Run "rake region:import".
+
+   Now you have there ActiveRecord modules: <b>Province, City, District</b>.
+   
+   Run with <em>rails g</em> for get generator list.
+
+4. If you want to customize the region modules you can run the generator:
+    rails g china_region_fu:mvc
+
+   This will create:
+   
+    create  app/models/province.rb
+    create  app/models/city.rb
+    create  app/models/district.rb
+
+   So you can do what you want to do in this files.
+   
+5. Examples
+
+    a = Province.last
+    a.name                # => "台湾省"
+    a.cities.map(&:name)  # => ["嘉义市", "台南市", "新竹市", "台中市", "基隆市", "台北市"]
+    
+    Province.first.districts.map(&:name) # => ["延庆县", "密云县", "平谷区", ...]
+    
+    c = City.last
+    c.name                # => "酒泉市"
+    c.districts.map(&:name) # => ["敦煌市", "玉门市", "阿克塞哈萨克族自治县", "肃北蒙古族自治县", "安西县", ...]
+    c.brothers.map(&:name)  # => ["甘南藏族自治州", "临夏回族自治州", "陇南市", ...]
+
+== Contributing
+
+Xuhao <{rubyfans.com}[http://www.rubyfans.com]>.
+
+== License
+
+ChinaRegionFu is released under the MIT license.
+

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/app/models/city.rb

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+class City < ActiveRecord::Base
+  attr_accessible :name, :province_id, :level, :zip_code, :pinyin, :pinyin_abbr
+  
+  belongs_to :province
+  has_many :districts, :dependent => :destroy
+  has_many :hospitals, :dependent => :nullify
+
+  def short_name
+    @short_name ||= name.gsub(/市|自治州|地区|特别行政区/,'')
+  end
+
+  def brothers
+    @brothers ||= City.where("province_id = #{province_id}")
+  end
+
+end

data/app/models/district.rb

@@ -0,0 +1,16 @@
+# -*- encoding: utf-8 -*-
+class District < ActiveRecord::Base
+  attr_accessible :name, :city_id, :pinyin, :pinyin_abbr
+  
+	belongs_to :city
+	has_many :hospitals, :dependent => :nullify
+
+	def short_name
+		@short_name ||= name.gsub(/区|县|市|自治县/,'')
+	end
+	
+	def brothers
+		@brothers ||= District.where("city_id = #{city_id}")
+	end
+	
+end

data/app/models/province.rb

@@ -0,0 +1,8 @@
+# -*- encoding: utf-8 -*-
+class Province < ActiveRecord::Base
+  attr_accessible :name, :pinyin, :pinyin_abbr
+  
+	has_many :cities, :dependent => :destroy
+	has_many :districts, :through => :cities
+	has_many :hospitals, :dependent => :nullify
+end

data/china_region_fu.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "china_region_fu/version"
+
+Gem::Specification.new do |s|
+  s.name        = "china_region_fu"
+  s.version     = ChinaRegionFu::VERSION
+  s.authors     = ["xuhao"]
+  s.email       = ["xuhao@rubyfans.com"]
+  s.homepage    = ""
+  s.summary     = %q{china region}
+  s.description = %q{china region}
+
+  s.rubyforge_project = "china_region_fu"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/china_region_fu/engine.rb

@@ -0,0 +1,5 @@
+require "rails"
+
+module ChinaRegionFu
+  class Engine < Rails::Engine;end
+end

data/lib/china_region_fu/version.rb

@@ -0,0 +1,3 @@
+module ChinaRegionFu
+  VERSION = "0.0.1"
+end

data/lib/china_region_fu.rb

@@ -0,0 +1,8 @@
+require 'china_region_fu/engine' if defined? Rails
+
+module ChinaRegionFu
+  YAML_FILE = File.expand_path('../../config/regions.yml', __FILE__)
+end
+
+
+require "china_region_fu/version"

data/lib/generators/china_region_fu/install/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Explain the generator
+
+Example:
+    rails generate china_region:fu:migration Thing
+
+    This will create:
+        db/migrate/create_china_region_tables.rb

data/lib/generators/china_region_fu/install/install_generator.rb

@@ -0,0 +1,30 @@
+module ChinaRegionFu
+  class InstallGenerator < Rails::Generators::Base
+    include Rails::Generators::Migration
+    source_root File.expand_path('../templates', __FILE__)
+
+    def copy_migration_file
+      migration_template "migration.rb", "db/migrate/create_china_region_tables.rb"
+    end
+    
+    def copy_region_config_file
+      copy_file 'regions.yml', 'config/regions.yml'
+    end
+    
+    def execute_migrate
+      rake("db:migrate")
+    end
+    
+    def import_region_to_data
+      rake('region:import')
+    end
+
+    def self.next_migration_number(dirname)
+      if ActiveRecord::Base.timestamped_migrations
+        Time.now.utc.strftime("%Y%m%d%H%M%S")
+      else
+        "%.3d" % (current_migration_number(dirname) + 1)
+      end
+    end
+  end
+end

data/lib/generators/china_region_fu/install/templates/migration.rb

@@ -0,0 +1,45 @@
+class CreateChinaRegionTables < ActiveRecord::Migration
+  def self.up
+    create_table :provinces do |t|
+      t.string :name
+      t.string :pinyin
+      t.string :pinyin_abbr
+      t.timestamps
+    end
+    create_table :cities do |t|
+      t.string :name
+      t.integer :province_id
+      t.integer :level
+      t.string :zip_code
+      t.string :pinyin
+      t.string :pinyin_abbr
+      t.timestamps
+    end    
+    create_table :districts do |t|
+      t.string :name
+      t.integer :city_id
+      t.string :pinyin
+      t.string :pinyin_abbr
+      t.timestamps
+    end
+    add_index :districts, :name
+    add_index :districts, :city_id
+    add_index :districts, :pinyin
+    add_index :districts, :pinyin_abbr
+    add_index :cities, :name
+    add_index :cities, :province_id
+    add_index :cities, :level
+    add_index :cities, :zip_code
+    add_index :cities, :pinyin
+    add_index :cities, :pinyin_abbr
+    add_index :provinces, :name
+    add_index :provinces, :pinyin
+    add_index :provinces, :pinyin_abbr
+  end
+
+
+  def self.down
+    drop_table :provinces, :cities, :districts
+  end
+
+end