Propinsi

Gem Version Gem Version

Now, to get all provinces and Indonesia cities become easier. No need to find the excel file or sql file to get all the data. Propinsi gem has all of it. Just follow the instruction below:

Installation

Add this line to your application's Gemfile:

gem 'propinsi'

And then execute:

$ bundle

Or install it yourself as:

$ gem install propinsi

run 

$ rails g propinsi:install

after instalation there will be some new files

  • lib/tasks/propinsi.rake
  • db/migrate/yyyymmdd_create_cities.rb
  • db/migrate/yyyymmdd_create_provinces.rb
  • model/province.rb
  • model/city.rb

run:

$ rake db:migrate

to build model and create a table named provinces and cities in your database

then run: 

$ rake propinsi:import

to import all provinces and cities into your created table.

Usage

Usage with database

Since the province and city is already in your database, you can use it normaly as you call a table. To implement in a select box, you can use collection select.

`<%= collection_select(:user, :province_id, Province.all, :id, :name) %>`

Usage without database

If you do not want to use database, you can use our array based list.

Display all data

`Propinsi.all`

Display all province

`Propinsi.propinsi`

Find province based on ID or name

`Propinsi.findpropinsi(20)`

#{"name"=>"Kalimantan Barat", "id"=>20} 

`Propinsi.findpropinsi("jakarta")`

#{"name"=>"Dki Jakarta", "id"=>11}

Diplay all City

`Propinsi.kota`

find city based on ID or name

`Propinsi.findkota(2)` 

# {"name"=>"Kabupaten Aceh Singkil", "id"=>2, "province_id"=>1, "province_name"=>"Aceh"} 

`Propoinsi.findkota("bekasi")`

# {"name"=>"Kabupaten Bekasi", "id"=>176, "province_id"=>12, "province_name"=>"Jawa Barat"} 

`Propoinsi.findkota("kota bekasi")`

#{"name"=>"Kota Bekasi", "id"=>183, "province_id"=>12, "province_name"=>"Jawa Barat"}

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/kovloq/propinsi. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.