pemilu 0.5.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b972a663d36270f5cb44ac23f67912c49dab9275
-  data.tar.gz: 1688f1637c95559c5cf1e8d3b614d6315f83058e
+  metadata.gz: d6c0e7caedcb15b71e2a0baf61421bb95c0227dd
+  data.tar.gz: d4ed5955fc4615e25666434bcd43910a86eb4e25
 SHA512:
-  metadata.gz: 304c05b90f80d5cad9e671c39869657f8410938ac58457b3c0d82f659f5f8f15cd7629ebf05deb31463fcad2c980ab067df4d1ebc99c96df898f2e7edc5e108a
-  data.tar.gz: db067f0cd237b00a26b90efb6ba6e07e2fc49e17eea8b36a398d1251b4e1d960c28b3710a4ea2415b6c59619a18ad2f8d20f2f6dd277205809298e2f325c6e49
+  metadata.gz: 9ef63effe307e8bce81f0e392f56969a93d6480e463b6ea3592e591c4f84d6f435b0a602628afc72c158f2516c71842ba3f0a566128830adb436670228ea9c50
+  data.tar.gz: 3e19059d2b0f3fbeaae60c9169c09b6ea161433ea8899ccc0f4327be73710e94993714e066bf80374c0df1ce644cc892be5352b27f9f8b7bc3876ad3f33dccd9

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.1.0
+script: bundle exec rspec spec

data/README.md

@@ -1,56 +1,96 @@
-# pemilu
+# pemilu [![Gem Version](https://badge.fury.io/rb/pemilu.png)](http://badge.fury.io/rb/pemilu) [![Build Status](https://travis-ci.org/pyk/pemilu.png?branch=master)](https://travis-ci.org/pyk/pemilu)
 A beautiful Ruby interface of [Pemilu APIs](http://pemiluapi.org)
 
 ## Contents
-- [Installation](in)
-- [How to use pemilu gem](ht)
-  - [Configure API key](c)
-  - [APIs](a)
-    - [List of Candidate attributes](ca)
-    - [Get list of all Candidates (`#candidates`)](g)
-    - [`#candidates` usage example](cux)
-    - [Get details of Candidate (`#candidate`)](gdoc)
-    - [`#candidate` usage example](cue)
-    - Get list of all Parties [**wait for the next release**](si)
-    - Get details of Party [**wait for the next release**](si)
-    - Get list of all Provinces [**wait for the next release**](si)
-    - Get details of Province [**wait for the next release**](si)
-    - Get list of all Electoral Districts [**wait for the next release**](si)
-    - Get details of Electoral District [**wait for the next release**](si)
-
-[in]: http
-[ht]: http
-[c]: http
-[a]: http
-[ca]: http
-[g]: http
-[cux]: http
-[gdoc]: http
-[cue]: http
-[si]: http
+- [Installation][in]
+- [How to use pemilu gem][ht]
+  - [Configure API key][c]
+  - [APIs][a]
+    - **Candidate APIs**
+      - [List of Candidate attributes][ca]
+      - [Get list of all Candidates][g]
+      - [#candidates usage example][cux]
+      - [Get details of Candidate][gdoc]
+      - [#candidate usage example][cue]
+    - **Party APIs**
+      - [List of Party attributes][lop]
+      - [Get list of all Parties][gloap]
+      - [#parties usage example][psue]
+      - [Get details of Party][gdop]
+      - [#party(id) usage example][pue] 
+    - **Province APIs**
+      - [List of Province attributes][lopa]
+      - [Get list of all Provinces][gloapv]
+      - [#provinces usage example][pvue]
+      - [Get details of Province][gopv]
+      - [#province(id) usage example][pvue]
+    - **Electoral District APIs**
+      - [List of Electoral District attributes][loeda]
+      - [Get list of all Electoral Districts][adom1]
+      - [#electoral_districts usage example][adom2]
+      - [Get details of Electoral District][adom3]
+      - [#electoral_district(id) usage example][adom4]
+  - [Exception Handling][eh]
+- [Author][auth]
+- [License][licn]
+
+[in]: https://github.com/pyk/pemilu#installation
+[ht]: https://github.com/pyk/pemilu#how-to-use-pemilu-gem
+[c]: https://github.com/pyk/pemilu#configure
+[a]: https://github.com/pyk/pemilu#apis
+[ca]: https://github.com/pyk/pemilu#list-of-candidate-attributes-object
+[g]: https://github.com/pyk/pemilu#get-list-of-all-candidates
+[cux]: https://github.com/pyk/pemilu#candidate-usage-example
+[gdoc]: https://github.com/pyk/pemilu#get-details-of-candidate
+[cue]: https://github.com/pyk/pemilu#candidate-usage-example
+[si]: https://github.com/pyk/pemilu#still-in-active-development
+[lop]: https://github.com/pyk/pemilu#list-of-party-attributes-object
+[gloap]: https://github.com/pyk/pemilu#get-list-of-all-parties
+[psue]: https://github.com/pyk/pemilu#parties-usage-example
+[gdop]: https://github.com/pyk/pemilu#get-details-of-party
+[pue]: https://github.com/pyk/pemilu#partyid-usage-example
+[lopa]: https://github.com/pyk/pemilu#list-of-province-attributes-object
+[gloapv]: https://github.com/pyk/pemilu#get-list-of-all-provinces
+[pvue]: https://github.com/pyk/pemilu#provinceid-usage-example
+[gopv]: https://github.com/pyk/pemilu#get-details-of-province
+[loeda]: https://github.com/pyk/pemilu#list-of-electoral-district-attribute
+[adom1]: https://github.com/pyk/pemilu#get-list-of-all-electoral-district
+[adom2]: https://github.com/pyk/pemilu#electoral_districts-usage-example
+[adom3]: https://github.com/pyk/pemilu#get-details-of-electoral-district
+[adom4]: https://github.com/pyk/pemilu#electoral_districtid-usage-example
+[eh]: https://github.com/pyk/pemilu#exception-handling
+[auth]: https://github.com/pyk/pemilu#author
+[licn]: https://github.com/pyk/pemilu#license
 
 ## Installation
 Add this line to your application's Gemfile:
 
-    gem 'test'
+```ruby
+    gem 'pemilu'
+```
 
 And then execute:
 
+```shell
     $ bundle
+```
 
 Or install it yourself as:
 
-    $ gem install test
-
+```shell
+    $ gem install pemilu
+```
 
 ## How to use pemilu gem
 
 ### Configure
-Before accessing all available [APIs](a) make sure Configure your API key first.
+Before accessing all available [APIs](#contents) make sure Configure your API key first.
 
+``` ruby
     require "pemilu"
 
     pemilu = Pemilu::API.new(key: "YOUR API KEY")
+```
 
 ### APIs
 
@@ -58,54 +98,60 @@ Before accessing all available [APIs](a) make sure Configure your API key first.
 List of available attribute to each candidate that you can get some information
 about candidate itself. For example `candidate.id` will display id of candidate.
 
-|Attribute|Return|Description|`#candidates`|`#candidate`|
----------------------------------------------------------
-|`id`|String|ID of Candidate|x|x|
-|`name`|String|Name of Candidate|x|x|
-|`gender`|String|Gender of Candidate|x|x|
-|`religion`|String|Religion of Candidate|x|x|
-|`birthplace`|String|Birthplace of Candidate|x|x|
-|`date_of_birth`|String|Date of Candidate birth|x|x|
-|`marital_status`|String|Marital status of Candidate|x|x|
-|`name_of_couples`|String|Name of Candidate couples|x|x|
-|`number_of_children`|Integer|Number of Candidate children|x|x|
-|`village`|String|Village where Candidate live|x|x|
-|`sub_district`|String|Sub district where Candidate live|x|x|
-|`district`|String|District where Candidate live|x|x|
-|`province`|Hash|Province where Candidate live|x|x|
-|`electoral_district`|Hash|Electoral district where Candidate running on|x|x|
-|`election_year`|Integer|Election year where Candidate running on|x|x|
-|`legislative_body`|String|Legislative body where Candidate running on (ex. DPR)|x|x|
-|`party`|String|Party of Candidate|x|-|
-|`party`|Hash|Party of Candidate|-|x|
-|`ordinal`|Integer|Ordinal of Candidate|x|x|
-|`picture`|String|URL of Candidate picture|x|x|
-|`educations`|Array|List of Candidate education history|-|x|
-|`jobs`|Array|List of Candidate job history|-|x|
-|`organizations`|Array|List of Candidate organization history|-|x|
+| Attribute | Return | Description | `#candidates` | `#candidate` |
+| --------- | ------ | ----------- | ------------- | ------------ |
+| `id` | String | ID of Candidate | x | x |
+| `name` | String | Name of Candidate | x | x |
+| `gender` | String | Gender of Candidate | x | x |
+| `religion`| String | Religion of Candidate | x | x |
+| `birthplace` | String | Birthplace of Candidate | x | x |
+| `date_of_birth` | String | Date of Candidate birth | x | x |
+| `marital_status`| String | Marital status of Candidate | x | x |
+| `name_of_couples`| String | Name of Candidate couples | x | x |
+| `number_of_children` | Integer | Number of Candidate children | x | x |
+| `village` | String | Village where Candidate live | x | x |
+| `sub_district` | String | Sub district where Candidate live | x | x |
+| `district`| String | District where Candidate live | x | x |
+| `province`| Hash | Province where Candidate live | x | x |
+| `electoral_district` | Hash | Electoral district where Candidate running on | x | x |
+| `election_year`| Integer | Election year where Candidate running on | x | x |
+| `legislative_body` | String | Legislative body where Candidate running on (ex. DPR) | x | x |
+| `party` | String | Party of Candidate | x | - |
+| `party` | Hash | Party of Candidate | - | x |
+| `ordinal` | Integer | Ordinal of Candidate | x | x |
+| `picture` | String | URL of Candidate picture | x | x |
+| `educations` | Array | List of Candidate education history | - | x |
+| `jobs` | Array | List of Candidate job history | - | x |
+| `organizations` | Array | List of Candidate organization history | - | x |
+
+description:
+- `x` mark is sign this attribute available when return from `#candidates` or `#candidate`
+- `-` mark is sign this attribute `nil` when return from `#candidates` or `#candidate`
 
 #### Get list of all candidates
 Return an array of `Pemilu::Candidate` object that filtered by declared option.
 
+```ruby
     pemilu.candidates(options = {})
-
+```
 ##### Available options
 
-|Option|Value|Default|Description|Return|
------------------------------------------
-|`name`|String|`nil`|String full or partial name of the candidate|Only all candidates that matching with `name`|
-|`party`|String|`nil`|Name of the available party|Only all candidates on the `party`|
-|`electoral_district`|String|`nil`|ID of electoral district (daerah pilihan)|Only all candidates that running on electoral district|
-|`election_year`|Integer|`nil`|Election year (tahun pemilihan)of candidate|Only all candidates that running on election year|
-|`province`|String|`nil`|ID of the Province|Only all candidates that running on `province`|
-|`gender`|String|`nil`|`"L"` for man and `"W"` for woman|Only all candidates has `gender` specified|
-|`religion`|String|`nil`|Religion of the candidate|Only all candidates that have religion specified|
-|`legislative_body`|String|`nil`|Legislative body that the candidate is running for|Only all candidates that running on that legislative body|
-|`limit`|Integer|`100`| Number of records to return| All candidates on specific limit number|
-|`offset`|Integer|`nil`|Number the offset|All candidates from beginning of the offset number|
+| Option | Value | Default | Description | Return |
+| ------ | ----- | ------- | ----------- | ------ |
+| `name` | String | `nil`| String full or partial name of the candidate | Only all candidates that matching with `name` |
+| `party` | String | `nil` | Name of the available party | Only all candidates on the `party` |
+| `electoral_district` | String | `nil`| ID of electoral district (daerah pilihan) | Only all candidates that running on electoral district |
+| `election_year` | Integer | `nil` | Election year (tahun pemilihan)of candidate | Only all candidates that running on election year|
+| `province` | String | `nil` | ID of the Province | Only all candidates that running on `province` |
+| `gender` | String | `nil` | `"L"` for man and `"W"` for woman|Only all candidates has `gender` specified |
+| `religion` | String | `nil` | Religion of the candidate | Only all candidates that have religion specified |
+| `legislative_body` | String | `nil` | Legislative body that the candidate is running for | Only all candidates that running on that legislative body |
+| `limit` | Integer | `100` | Number of records to return | All candidates on specific limit number |
+| `offset` | Integer | `nil` | Number the offset | All candidates from beginning of the offset number |
 
 #### `#candidates` usage example
 
+```ruby
     # get 10 man candidates
     pemilu.candidates(limit: 10, gender: "L")
 
@@ -115,24 +161,225 @@ Return an array of `Pemilu::Candidate` object that filtered by declared option.
       puts "Name: #{candidate.name}"
       puts "Regligion: #{candidate.religion}"
     end
-
+```
 
 #### Get details of Candidate
 Return an object of `Pemilu::Candidate` with an `id` specified.
 
+```ruby
     pemilu.candidate("ID CANDIDATE")
+```
+
+ID Candidate must be String. like this `"1101-00-0000-0102"`
 
 #### `#candidate` usage example
 
+```ruby
     # print some information about Candidate with id=1101-00-0000-0102
     candidate = pemilu.candidate("1101-00-0000-0102")
     puts "Name: #{candidate.name}"
+```
+
+#### List of Party attributes object
+List of available attribute to each Party that you can use for get some information
+about party itself. For example `party.id` will display id of party.
+
+| Attribute | Return | Decription | `#parties` | `#party` |
+| --------- | ------ | ---------- | ---------- | -------- |
+| `id` | Integer | ID of Party | x | x |
+| `nick_name` | String | Nick name or abbreviation of Party | x | x |
+| `full_name` | String | Full name of Party | x | x |
+| `url` | String | URL to Party homepage | x | x |
+| `facebook` | String | URL to Party facebook page | x | x |
+| `twitter` | String | URL to Party twitter page | x | x |
+
+description:
+- `x` mark is sign this attribute available when return from `#parties` or
+  `#party`
+- `-` mark is sign this attribute `nil` when return from `#parties` or `#party`
+
+#### Get list of all Parties
+Return an array of `Pemilu::Party` object.
+
+```ruby
+    # get all parties
+    pemilu.parties
+    #=> [#<Pemilu::Party:0xb833bfcc....]
+```
+
+#### `#parties` usage example
+
+```ruby
+    # print name and facebook url each for each party
+    pemilu.parties.each do |party|
+      puts "Party name: #{party.full_name}"
+      puts "Party facebook: #{party.facebook}"
+    end
+```
+
+#### Get details of Party
+Return one object of Pemilu::Party specified by ID.
+
+```ruby
+    pemilu.party("ID PARTY")
+```
+
+`ID PARTY` must be an Integer.
+
+#### `#party(id)` usage example
+
+```ruby
+    # print information about Partai Demokrasi Indonesia Perjuangan
+    pdip = pemilu.party(4)
+
+    puts pdip.id #=> 4
+    puts pdip.nick_name #=> PDI-P
+    puts pdip.full_name #=> Partai Demokrasi Indonesia Perjuangan
+    puts pdip.facebook #=> https://www.facebook.com/DPP.PDI.Perjuangan
+    puts pdip.twitter #=> https://twitter.com/pdi_perjuangan
+```
+
+#### List of Province attributes object
+List of available attribute to each Province that you can use for get some information
+about province itself. For example `province.id` will display id of province.
+
+| Attribute | Return | Decription | `#provinces` | `#province` |
+| --------- | ------ | ---------- | ---------- | -------- |
+| `id` | Integer | ID of Province | x | x |
+| `name` | String | Nick Name of Province | x | x |
+| `full_name` | String | Full Name of Province | x | x |
+| `international_name` | String | International Name (English) of Province | x | x |
+| `available_chairs` | Integer | Availalble chairs for Candidates | x | x |
+| `population` | Integer | Population of Province | x | x |
+| `electoral_district` | Array | List of Electoral District on Province | - | x |
+
+description:
+- `x` mark is sign this attribute available when return from `#provinces` or
+  `#province`
+- `-` mark is sign this attribute `nil` when return from `#provinces` or `#province`
+
+#### Get list of all Provinces
+Return an array of `Pemilu::Province` object.
+
+```ruby
+    # get all provinces
+    pemilu.provinces
+    #=> [#<Pemilu::Province:0xb8c4ceb8....]
+```
+
+#### `#provinces` usage example
+
+```ruby
+    # print id and international name of each province
+    pemilu.provinces.each do |province|
+      puts "ID: #{province.id}"
+      puts "Internatioal Name: #{province.international_name}"
+    end
+```
+
+#### Get details of Province
+Return one object of Pemilu::Province specified by ID.
+
+```ruby
+    pemilu.province("ID PROVINCE")
+```
+
+`ID PROVINCE` must be an Integer.
+
+#### `#province(id)` usage example
+
+```ruby
+    # print information about Special Region of Aceh
+    aceh = pemilu.province(11)
+
+    puts aceh.id #=> 11
+    puts aceh.name #=> Aceh
+    puts aceh.international_name #=> Special Region of Aceh
+```
+
+#### List of Electoral District attribute
+List of available attribute to each Electoral District that you can use for get some information
+about Electoral District itself. For example `ed.id` will display id of Electoral District.
+
+| Attribute | Return | Decription | `#electoral_districts` | `#electoral_district` |
+| --------- | ------ | ---------- | ---------- | -------- |
+| `id` | String | ID of Electoral District | x | x |
+| `name` | String | Name or Electoral District | x | x |
+| `legislative_body` | String | Legislative body of Electoral District | x | x |
+| `available_chairs` | Integer | Number of available chairs in Electoral District| x | x |
+| `population` | Integer | Population in Electoral District | x | x |
+| `province` | Hash | Province of Electoral District | x | X |
+| `province.id` | Integer | Province id of Electoral District | x | x |
+| `province.name` | String | Province name of Electoral District | x | x |
+
+
+description:
+- `x` mark is sign this attribute available when return from `#parties` or
+  `#party`
+- `-` mark is sign this attribute `nil` when return from `#parties` or `#party`
+
+### Get list of all electoral district
+Return an array of `Pemilu::ElectoralDistrict` object that filtered by declared option.
+
+```ruby
+    pemilu.electoral_districts(options = {})
+```
+##### Available options
+
+| Option | Value | Default | Description | Return |
+| ------ | ----- | ------- | ----------- | ------ |
+| `province` | String | `nil`| Name of province | Only all electoral district in `province` |
+| `legislative_body` | String | `nil` | Legislative body of Electoral District | Only all electoral district that have specified legislative body |
+
+#### `#electoral_districts` usage example
+
+```ruby
+    # get electoral district on Aceh province
+    pemilu.electoral_districts(province: "Aceh")
+```
+
+#### Get details of Electoral District
+Return one object of Pemilu::ElectoralDistrict specified by ID.
+
+```ruby
+    pemilu.electoral_district("ID ELETORAL DISTRICT")
+```
+
+`ID ELECTORAL DISTRICT` should be String. Like this `"1101-00-0000"` 
+
+#### `#electoral_district(id)` usage example
+
+```ruby
+    # print information about Aceh I electoral district
+    ed = pemilu.electoral_district("1101-00-0000")
+
+    puts ed.id #=> 1101-00-0000
+    puts ed.legislative_body #=> DPR
+    puts ed.available_chairs #=> 7
+    puts ed.population #=> 2642760
+```
+
+### Exception Handling
+When get details of specific information about Candidate, Party, Province and Electoral District using ID that doesn't exist it will raised error like this:
+
+
+```shell
+    NoMethodError: undefined method `[]' for nil:NilClass
+```
+
+but, with exception handling feature now every return object that didn't exist return like this:
+
+
+```shell
+    "Cann't get party with id: 100"
+```
 
-## Still in active development
-23:32 Saturday, 1 March 2014.
-Sorry this gem is still under development. Actually you can use it on production
-because this gem is [well tested](wt). But, you don't get full feature yet.
-Please wait for the next release. You can give me a shot at [@peeyek](pyk) on twitter.
+## Author
+| Author |
+| ---------------- |
+|Bayu Aldi Yansyah |
+|S1 Matematika, 2013, Universitas Airlangga |
+|[@peeyek](https://twitter.com/peeyek) |
 
-[wt]: http://linktospec
-[pyk] : http:/twitterlink
+## License
+MIT (c) 2014 Bayu Aldi Yansyah

data/lib/pemilu/api.rb

@@ -1,4 +1,3 @@
-require "pp"
 module Pemilu
   class API
 
@@ -28,40 +27,36 @@ module Pemilu
       uri.query = URI.encode_www_form(params)
       respond = Net::HTTP.get_response(uri)
       result = []
-      if respond.is_a?(Net::HTTPSuccess)
-        data = JSON.parse(respond.body)
-        @total_candidate = data["data"]["results"]["total"]
-        candidates = data["data"]["results"]["caleg"]
-        candidates.each do |caleg|
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      @total_candidate = data["data"]["results"]["total"]
+      candidates = data["data"]["results"]["caleg"]
+      candidates.each do |caleg|
         result << Pemilu::Candidate.new(
           id: caleg["id"],
           name: caleg["nama"],
           gender: caleg["jenis_kelamin"],
           religion: caleg["agama"],
-          birthplace: caleg["tempat_lahir"], 
-          date_of_birth: caleg["tanggal_lahir"], 
-          marital_status: caleg["status_perkawinan"], 
-          name_of_couples: caleg["nama_pasangan"], 
-          number_of_children: caleg["jumlah_anak"], 
-          village: caleg["kelurahan_tinggal"], 
-          sub_district: caleg["kecamatan_tinggal"], 
-          district: caleg["kab_kota_tinggal"], 
+          birthplace: caleg["tempat_lahir"],
+          date_of_birth: caleg["tanggal_lahir"],
+          marital_status: caleg["status_perkawinan"],
+          name_of_couples: caleg["nama_pasangan"],
+          number_of_children: caleg["jumlah_anak"],
+          village: caleg["kelurahan_tinggal"],
+          sub_district: caleg["kecamatan_tinggal"],
+          district: caleg["kab_kota_tinggal"],
           province: {
-            "id" => caleg["provinsi"]["id"], 
+            "id" => caleg["provinsi"]["id"],
             "name" => caleg["provinsi"]["nama"]
             },
           electoral_district: {
             "id" => caleg["dapil"]["id"],
             "nama" => caleg["dapil"]["nama"]
             },
-          election_year: caleg["tahun"], 
+          election_year: caleg["tahun"],
           legislative_body: caleg["lembaga"],
           party: caleg["partai"],
           ordinal: caleg["urutan"],
           picture: caleg["foto_url"])
-        end
-      else
-        return "Can't reach the http://api.pemiluapi.org"
       end
       return result
     end
@@ -72,32 +67,33 @@ module Pemilu
       uri.query = URI.encode_www_form(params)
       respond = Net::HTTP.get_response(uri)
       data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      return "Cann't get candidate with id: #{id}" if data.nil?
       candidate = data["data"]["results"]["caleg"][0]
       return Pemilu::Candidate.new(
         id: candidate["id"],
         name: candidate["nama"],
         gender: candidate["jenis_kelamin"],
         religion: candidate["agama"],
-        birthplace: candidate["tempat_lahir"], 
-        date_of_birth: candidate["tanggal_lahir"], 
-        marital_status: candidate["status_perkawinan"], 
-        name_of_couples: candidate["nama_pasangan"], 
-        number_of_children: candidate["jumlah_anak"].to_i, 
-        village: candidate["kelurahan_tinggal"], 
-        sub_district: candidate["kecamatan_tinggal"], 
-        district: candidate["kab_kota_tinggal"], 
+        birthplace: candidate["tempat_lahir"],
+        date_of_birth: candidate["tanggal_lahir"],
+        marital_status: candidate["status_perkawinan"],
+        name_of_couples: candidate["nama_pasangan"],
+        number_of_children: candidate["jumlah_anak"].to_i,
+        village: candidate["kelurahan_tinggal"],
+        sub_district: candidate["kecamatan_tinggal"],
+        district: candidate["kab_kota_tinggal"],
         province: {
-          "id" => candidate["provinsi"]["id"], 
+          "id" => candidate["provinsi"]["id"],
           "name" => candidate["provinsi"]["nama"]
           },
         electoral_district: {
           "id" => candidate["dapil"]["id"],
           "name" => candidate["dapil"]["nama"]
           },
-        election_year: candidate["tahun"], 
+        election_year: candidate["tahun"],
         legislative_body: candidate["lembaga"],
         party: {
-          "id" => candidate["partai"]["id"].to_i, 
+          "id" => candidate["partai"]["id"].to_i,
           "name" => candidate["partai"]["nama"]
           },
         ordinal: candidate["urutan"],
@@ -106,5 +102,143 @@ module Pemilu
         jobs: candidate["riwayat_pekerjaan"],
         organizations: candidate["riwayat_organisasi"])
     end
+
+    def parties
+      uri = URI("http://api.pemiluapi.org/candidate/api/partai")
+      params = { apiKey: @key }
+      uri.query = URI.encode_www_form(params)
+      respond = Net::HTTP.get_response(uri)
+      result = []
+
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      @total_parties = data["data"]["results"]["count"]
+      parties = data["data"]["results"]["partai"]
+      parties.each do |party|
+        result << Pemilu::Party.new(
+          id: party["id"].to_i,
+          nick_name: party["nama"],
+          full_name: party["nama_lengkap"],
+          url: party["url_situs"],
+          facebook: party["url_facebook"],
+          twitter: party["url_twitter"]
+        )
+      end
+      return result
+    end
+
+    def party(id)
+      uri = URI("http://api.pemiluapi.org/candidate/api/partai/#{id}")
+      params = { apiKey: @key }
+      uri.query = URI.encode_www_form(params)
+      respond = Net::HTTP.get_response(uri)
+
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      party = data["data"]["results"]["partai"][0]
+      return "Cann't get party with id: #{id}" if party.nil?
+      return Pemilu::Party.new(
+          id: party["id"].to_i,
+          nick_name: party["nama"],
+          full_name: party["nama_lengkap"],
+          url: party["url_situs"],
+          facebook: party["url_facebook"],
+          twitter: party["url_twitter"]
+        )
+    end
+
+    def provinces
+      uri = URI("http://api.pemiluapi.org/candidate/api/provinsi")
+      params = { apiKey: @key }
+      uri.query = URI.encode_www_form(params)
+      respond = Net::HTTP.get_response(uri)
+      result = []
+
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      @total_provinsi = data["data"]["results"]["count"]
+      provinces = data["data"]["results"]["provinsi"]
+      provinces.each do |province|
+        result << Pemilu::Province.new(
+          id: province["id"].to_i,
+          name: province["nama"],
+          full_name: province["nama_lengkap"],
+          international_name: province["nama_inggris"],
+          available_chairs: province["jumlah_kursi"],
+          population: province["jumlah_penduduk"])
+      end
+      return result
+    end
+
+    def province(id)
+      uri = URI("http://api.pemiluapi.org/candidate/api/provinsi/#{id}")
+      params = { apiKey: @key }
+      uri.query = URI.encode_www_form(params)
+      respond = Net::HTTP.get_response(uri)
+
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      return "Cann't get province with id: #{id}" if data.nil?
+      province = data["data"]["results"]["provinsi"][0]
+      return Pemilu::Province.new(
+          id: province["id"].to_i,
+          name: province["nama"],
+          full_name: province["nama_lengkap"],
+          international_name: province["nama_inggris"],
+          available_chairs: province["jumlah_kursi"],
+          electoral_district: province["dapil"],
+          population: province["jumlah_penduduk"])
+    end
+
+
+    def electoral_districts(province: nil, legislative_body: nil)
+
+      uri = URI("http://api.pemiluapi.org/candidate/api/dapil")
+      params = {
+        apiKey: @key,
+        lembaga: legislative_body,
+        provinsi: province
+      }
+      params.delete_if{ |k,v| v.nil? }
+      uri.query = URI.encode_www_form(params)
+      respond = Net::HTTP.get_response(uri)
+      result = []
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      @total_election_districts = data["data"]["results"]["count"]
+      eds = data["data"]["results"]["dapil"]
+      eds.each do |ed|
+        result << Pemilu::ElectoralDistrict.new(
+          id: ed["id"],
+          name: ed["nama"],
+          full_name: ed["nama_lengkap"],
+          legislative_body: ed["nama_lembaga"],
+          available_chairs: ed["jumlah_kursi"],
+          population: ed["jumlah_penduduk"],
+          province: {
+            "id" => ed["provinsi"]["id"],
+            "name" => ed["provinsi"]["nama"]
+          })
+      end
+      return result
+    end
+
+    def electoral_district(id)
+      uri = URI("http://api.pemiluapi.org/candidate/api/dapil/#{id}")
+      params = { apiKey: @key }
+      uri.query = URI.encode_www_form(params)
+      respond = Net::HTTP.get_response(uri)
+
+      data = JSON.parse(respond.body) if respond.is_a?(Net::HTTPSuccess)
+      return "Cann't get province with id: #{id}" if data.nil?
+      ed = data["data"]["results"]["dapil"][0]
+      return Pemilu::ElectoralDistrict.new(
+          id: ed["id"],
+          name: ed["nama"],
+          full_name: ed["nama_lengkap"],
+          legislative_body: ed["nama_lembaga"],
+          available_chairs: ed["jumlah_kursi"],
+          population: ed["jumlah_penduduk"],
+          province: {
+            "id" => ed["provinsi"]["id"],
+            "name" => ed["provinsi"]["nama"]
+          })
+    end
+
   end
 end

data/lib/pemilu/electoral_district.rb

@@ -0,0 +1,17 @@
+module Pemilu
+  class ElectoralDistrict
+
+    attr_reader :id, :name, :full_name, :legislative_body, :available_chairs, :population, :province
+
+    def initialize(id: nil, name: nil, full_name: nil, legislative_body: nil, available_chairs: nil, population: nil, province: nil)
+      @id = id
+      @name = name
+      @full_name = full_name
+      @legislative_body = legislative_body
+      @available_chairs = available_chairs
+      @population = population
+      @province = province
+    end
+
+  end
+end

data/lib/pemilu/party.rb

@@ -0,0 +1,14 @@
+module Pemilu
+  class Party
+    attr_reader :id, :nick_name, :full_name, :url, :facebook, :twitter
+    def initialize(id: nil, nick_name: nil, full_name: nil, url: nil, facebook: nil, twitter: nil)
+      @id        = id
+      @nick_name = nick_name
+      @full_name = full_name
+      @url       = url
+      @facebook  = facebook
+      @twitter   = twitter
+
+    end
+  end
+end

data/lib/pemilu/province.rb

@@ -0,0 +1,17 @@
+module Pemilu
+  class Province
+
+    attr_reader :id, :name, :full_name, :international_name, :available_chairs, :population, :electoral_district
+
+    def initialize(id: nil, name: nil, full_name: nil, international_name: nil, available_chairs: nil, population: nil, electoral_district: nil)
+      @id = id
+      @name = name
+      @full_name = full_name
+      @international_name = international_name
+      @available_chairs = available_chairs
+      @population = population
+      @electoral_district = electoral_district
+    end
+
+  end
+end

data/lib/pemilu/version.rb

@@ -1,3 +1,3 @@
 module Pemilu
-  VERSION = "0.5.1"
+  VERSION = "1.0.0"
 end

data/lib/pemilu.rb

@@ -4,6 +4,9 @@ require "pemilu/version"
 require "pemilu/api"
 require "pemilu/candidate"
 require "pemilu/hash_extension"
+require "pemilu/party"
+require "pemilu/province"
+require "pemilu/electoral_district"
 
 module Pemilu
   # Your code goes here...

data/spec/pemilu/api_spec.rb

@@ -6,7 +6,7 @@ module Pemilu
       let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
 
       it "should an object" do
-        pemilu.class.should be_a(Object)
+        pemilu.should be_a(Object)
       end
 
     end
@@ -22,27 +22,20 @@ module Pemilu
     describe "#candidates" do
       let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
 
-      it "should return an array" do
-        pemilu.candidates.should be_a(Array)
-      end
-
       it "should return an array of Pemilu::Candidate object" do
+        pemilu.candidates.should be_a(Array)
         pemilu.candidates.each do |candidate|
           expect(candidate.class).to eq(Pemilu::Candidate)
         end
       end
     end
 
-    describe "#candidate" do
+    describe "#candidate(id)" do
       let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
 
-      it "should return one Pemilu::Candidate object" do
-        caleg = pemilu.candidate("1101-00-0000-0102")
-        expect(caleg.class).to eq(Pemilu::Candidate)
-      end
-
-      it "should return details of candidate" do
+      it "should return one Pemilu::Candidate object and correct details" do
         caleg = pemilu.candidate("1101-00-0000-0102")
+        caleg.should be_a(Pemilu::Candidate)
         expect(caleg.id).to eq("1101-00-0000-0102")
         expect(caleg.name).to eq("Drs. H. T. PRIBADI")
         expect(caleg.gender).to eq("L")
@@ -71,5 +64,86 @@ module Pemilu
       end
     end
 
+    describe "#parties" do
+      let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
+
+      it "should return an array of Pemilu::Party object" do
+        pemilu.parties.should be_a(Array)
+        pemilu.parties.each do |party|
+          expect(party.class).to eq(Pemilu::Party)
+        end
+      end
+    end
+
+    describe "#party(id)" do
+      let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
+
+      it "should return Pemilu::Party object and have correct details" do
+        party = pemilu.party(1)
+        party.should be_a(Pemilu::Party)
+        expect(party.id).to eq(1)
+        expect(party.nick_name).to eq("Partai NasDem")
+        expect(party.full_name).to eq("Partai NasDem")
+        expect(party.url).to eq("http://www.partainasdem.org/")
+        expect(party.facebook).to eq("https://www.facebook.com/pages/Partai-Nasdem/135724689838285")
+        expect(party.twitter).to eq("https://twitter.com/NasDem")
+      end
+    end
+
+    describe "#provinces" do
+      let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
+
+      it "should return an array of Pemilu::Province object" do
+        pemilu.provinces.should be_a(Array)
+        pemilu.provinces.each do |province|
+          expect(province.class).to eq(Pemilu::Province)
+        end
+      end
+    end
+
+    describe "#province(id)" do
+      let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
+
+      it "should return Pemilu::Province object and have correct details" do
+        province = pemilu.province(11)
+        province.should be_a(Pemilu::Province)
+        expect(province.id).to eq(11)
+        expect(province.name).to eq("Aceh")
+        expect(province.full_name).to eq("Aceh")
+        expect(province.international_name).to eq("Special Region of Aceh")
+        expect(province.available_chairs).to eq(13)
+        expect(province.population).to eq(5015234)
+        province.electoral_district.should be_a(Array)
+      end
+    end
+
+    describe "#electoral_districts" do
+      let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
+
+      it "should return an array of Pemilu::ElectoralDistrict object" do
+        pemilu.electoral_districts.should be_a(Array)
+        pemilu.electoral_districts.each do |ed|
+          expect(ed.class).to eq(Pemilu::ElectoralDistrict)
+        end
+      end
+    end
+
+    describe "#electoral_district(id)" do
+      let(:pemilu) { Pemilu::API.new(key: "06ec082d057daa3d310b27483cc3962e") }
+
+      it "should return Pemilu::ElectoralDistrict object and have correct details" do
+        electoral_district = pemilu.electoral_district("1101-00-0000")
+        electoral_district.should be_a(Pemilu::ElectoralDistrict)
+        expect(electoral_district.id).to eq("1101-00-0000")
+        expect(electoral_district.name).to eq("Aceh I")
+        expect(electoral_district.legislative_body).to eq("DPR")
+        expect(electoral_district.available_chairs).to eq(7)
+        expect(electoral_district.population).to eq(2642760)
+        electoral_district.province.should be_a(Hash)
+        expect(electoral_district.province.id).to eq(11)
+        expect(electoral_district.province.name).to eq("Aceh")
+      end
+    end
+
   end
 end

data/spec/pemilu/candidate_spec.rb

@@ -8,23 +8,23 @@ module Pemilu
         name: "bayu aldi yansyah",
         gender: "L",
         religion: "ISLAM",
-        birthplace: "Nganjuk", 
-        date_of_birth: "07 Oktober 1996", 
-        marital_status: "Di PHPin", 
-        name_of_couples: "Pevita Pearce", 
-        number_of_children: 100, 
-        village: "Keloposepuluh", 
-        sub_district: "Sukodono", 
-        district: "Sidoarjo", 
+        birthplace: "Nganjuk",
+        date_of_birth: "07 Oktober 1996",
+        marital_status: "Di PHPin",
+        name_of_couples: "Pevita Pearce",
+        number_of_children: 100,
+        village: "Keloposepuluh",
+        sub_district: "Sukodono",
+        district: "Sidoarjo",
         province: {
-          "id" => 2, 
+          "id" => 2,
           "name" => "Jawa Timur"
           },
         electoral_district: {
           "id" => 20,
           "name" => "Sidoarjo"
           },
-        election_year: 2014, 
+        election_year: 2014,
         legislative_body: "DPR",
         party: "Partai Asolole jos!",
         ordinal: 1,
@@ -42,7 +42,8 @@ module Pemilu
 					"ringkasan" => "Test"
 				}] ) }
 
-			it "should return a correct candidate details" do
+			it "should return Pemilu::Candidate object and have correct details" do
+        candidate.should be_a(Pemilu::Candidate)
 				expect(candidate.id).to eq(1)
 				expect(candidate.name).to eq("bayu aldi yansyah")
 				expect(candidate.gender).to eq("L")
@@ -72,4 +73,4 @@ module Pemilu
 
 		end
 	end
-end
+end

data/spec/pemilu/electoral_district_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+
+module Pemilu
+  describe ElectoralDistrict do
+    describe "new" do
+      let(:ed) { Pemilu::ElectoralDistrict.new(
+        id: 1,
+        full_name: "test",
+        legislative_body: "test",
+        available_chairs: 1,
+        population: 1,
+        province: {
+        "id" => 1,
+        "name" => "test"
+      })}
+
+      it "should become Pemilu::ElectoralDistrict object and have correct details" do
+        ed.should be_a(Pemilu::ElectoralDistrict)
+        expect(ed.id).to eq(1)
+        expect(ed.full_name).to eq("test")
+        expect(ed.legislative_body).to eq("test")
+        expect(ed.available_chairs).to eq(1)
+        expect(ed.population).to eq(1)
+        ed.province.should be_a(Hash)
+        expect(ed.province.id).to eq(1)
+        expect(ed.province.name).to eq("test")
+      end
+    end
+  end
+end

data/spec/pemilu/party_spec.rb

@@ -0,0 +1,26 @@
+require "spec_helper"
+
+module Pemilu
+  describe Party do
+    describe "new" do
+      let(:party) { Pemilu::Party.new(
+        id: 1,
+        nick_name: "ASOLOLE",
+        full_name: "ASOLOLE JOS!",
+        url: "test",
+        facebook: "test",
+        twitter: "test"
+      ) }
+
+      it "should return Pemilu::Party object and have correct details" do
+        party.should be_a(Pemilu::Party)
+        expect(party.id).to eq(1)
+        expect(party.nick_name).to eq("ASOLOLE")
+        expect(party.full_name).to eq("ASOLOLE JOS!")
+        expect(party.url).to eq("test")
+        expect(party.facebook).to eq("test")
+        expect(party.twitter).to eq("test")
+      end
+    end
+  end
+end

data/spec/pemilu/province_spec.rb

@@ -0,0 +1,26 @@
+require "spec_helper"
+
+module Pemilu
+  describe Province do
+    describe "new" do
+      let(:province) { Pemilu::Province.new(
+        id: 1,
+        name: "Sidoarjo",
+        full_name: "Sidoarjo",
+        international_name: "Sidoarjo jos!",
+        available_chairs: 1,
+        population: 100000
+      ) }
+
+      it "should an object of Pemilu::Province and return correct details" do
+        expect(province.class).to eq(Pemilu::Province)
+        expect(province.id).to eq(1)
+        expect(province.name).to eq("Sidoarjo")
+        expect(province.full_name).to eq("Sidoarjo")
+        expect(province.international_name).to eq("Sidoarjo jos!")
+        expect(province.available_chairs).to eq(1)
+        expect(province.population).to eq(100000)
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pemilu
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Bayu Aldi Yansyah
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-01 00:00:00.000000000 Z
+date: 2014-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -61,6 +61,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -68,11 +69,17 @@ files:
 - lib/pemilu.rb
 - lib/pemilu/api.rb
 - lib/pemilu/candidate.rb
+- lib/pemilu/electoral_district.rb
 - lib/pemilu/hash_extension.rb
+- lib/pemilu/party.rb
+- lib/pemilu/province.rb
 - lib/pemilu/version.rb
 - pemilu.gemspec
 - spec/pemilu/api_spec.rb
 - spec/pemilu/candidate_spec.rb
+- spec/pemilu/electoral_district_spec.rb
+- spec/pemilu/party_spec.rb
+- spec/pemilu/province_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/pyk/pemilu
 licenses:
@@ -101,4 +108,7 @@ summary: A beautiful Ruby interface for Pemilu APIs (pemiluapi.org)
 test_files:
 - spec/pemilu/api_spec.rb
 - spec/pemilu/candidate_spec.rb
+- spec/pemilu/electoral_district_spec.rb
+- spec/pemilu/party_spec.rb
+- spec/pemilu/province_spec.rb
 - spec/spec_helper.rb