wikipedia_rest_client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8c452900722d27ada17549e2b5c55ee1b1c7ebda6325c801f645d072ac02db6f
+  data.tar.gz: d6a092296053ccba45997df0b7d018235bcf439ea4c9ee980eb980f1dde99a1c
+SHA512:
+  metadata.gz: 0c215658d8f812a68d7f6ebe302e5936caf08445e0983e2fab32fc1e1079bdb3cb3fdf5c1e7561e061c00783c98f7ffbc7921945e8ebc2c0b78a24bb9d59354d
+  data.tar.gz: 4b38f3542b2c1eac428b3b62cc80985384bbdeb6e5ad8d1597aa94f084e5fe8f33d28aaca245d0e91ed91910ebb96740f887f6110b4d9c4d9eee409bb3ddd4d1

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.16.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at balaji030698@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in wikipedia_rest_client.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,45 @@
+PATH
+  remote: .
+  specs:
+    wikipedia_rest_client (0.0.1)
+      httparty (~> 0.15.6)
+      json (~> 2.0.2)
+      nokogiri (>= 1.6.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    httparty (0.15.7)
+      multi_xml (>= 0.5.2)
+    json (2.0.4)
+    mini_portile2 (2.3.0)
+    multi_xml (0.6.0)
+    nokogiri (1.8.2)
+      mini_portile2 (~> 2.3.0)
+    rake (10.5.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.0)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  wikipedia_rest_client!
+
+BUNDLED WITH
+   1.16.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Balaji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,274 @@
+# WikipediaRestClient
+
+wikipedia_rest_client is a ruby gem to ease your usage of the Wikipedia REST API. You can find the Wikipedia REST API [here](https://en.wikipedia.org/api/rest_v1/#/). 
+By using this gem we can get the following,
+- Wikipedia page details for a given topic.
+- Featured article.
+- Picture of the day.
+- News.
+- Most-read articles of the day.
+- On This Day.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'wikipedia_rest_client'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install wikipedia_rest_client
+
+## Usage
+
+### Set User Agent 
+Set a unique User-Agent or Api-User-Agent header that allows us to contact you quickly. 
+
+Note: Setting User-Agent is optional but it is a good practice to handle more HTTPS requests for the API.
+```ruby
+WikipediaRestClient.setUserAgent(< Email addresses or URLs of contact pages >)
+```
+
+**Example**
+```ruby
+WikipediaRestClient.setUserAgent("someone@gmail.com")
+```
+
+### Page Summary
+It will return details of the Wikipedia page for the query string.
+
+**Example**
+```ruby
+page = WikipediaRestClient.get_page("Indian President")
+  #Returns an object that contains contents of the required page
+page.title
+ #=> "President of India"
+page.text
+ #=> "The President of the Republic of India is the head of state of India and the commander-in-chief of the Indian Armed Forces."
+page.image_url
+ #=> "https://upload.wikimedia.org/wikipedia/commons/8/80/Ram_Nath_Kovind_2017.jpg"
+page.url 
+ #=> "https://en.wikipedia.org/wiki/President_of_India"
+page.pageid
+ #=> 141896
+page.description
+ #=> "executive head of state of the Republic of India"
+```
+The Page class contains the following information,
+- type
+- title
+- display_title
+- namespace_id
+- namespace_text
+- titles_canonical
+- titles_normalized
+- titles_display
+- pageid
+- thumbnail_source
+- thumbnail_width   
+- thumbnail_height
+- lang
+- dir
+- revision
+- tid
+- timestamp
+- description
+- image_url
+- image_width
+- image_height
+- url_desktop_page
+- url_desktop_revisions
+- url_desktop_edit
+- url_desktop_talk
+- url_mobile_page
+- url_mobile_revisions
+- url_mobile_edit
+- url_mobile_talk
+- api_urls_summary
+- api_urls_metadata
+- api_urls_references
+- api_urls_media
+- api_urls_edit_html
+- api_urls_talk_page_html
+- text
+- text_html
+- normalized_title
+- url
+
+### Random Article 
+
+**Example**
+```ruby
+page = WikipediaRestClient.get_random
+ #=> Return a random page from wikipedia 
+page.title
+ #=> "Adams Glacier (Victoria Land)"
+page.text
+ #=> "Adams Glacier is a small glacier immediately south of Miers Glacier in Victoria Land. The heads of Adams and Miers glaciers, both located in the Miers Valley, are separated by a low ridge, and the east end of this ridge is almost completely surrounded by the snouts of the two glaciers, which nearly meet in the bottom of the valley, about 1 mile (1.6 km) above Lake Miers, into which they drain. It was named by the New Zealand Northern Survey Party of the Commonwealth Trans-Antarctic Expedition (1956–58) after Lieutenant Jameson Adams, second in command of the shore party of the British Antarctic Expedition (1907–09), who was one of the men to accompany Ernest Shackleton to within 97 miles (156 km) of the South Pole."
+page.url
+ #=> "https://en.wikipedia.org/wiki/Adams_Glacier_(Victoria_Land)"
+page.pageid
+ #=> 16524953
+page.image_url
+ #=> "https://upload.wikimedia.org/wikipedia/commons/2/24/Antarctica_relief_location_map.jpg"
+
+```
+
+### Featured Article
+
+Returns the Page object of the featured article
+
+```ruby
+article_of_the_day = WikipediaRestClient.get_featured_article
+#=> Returns today's featured article
+
+article = WikipediaRestClient.get_featured_article(<DATE>) #Date Should be in YYYY/MM/DD Format
+#=> Returns featured article for the specified date
+```
+
+
+**Example**
+```ruby
+old_article = WikipediaRestClient.get_featured_article("2018/05/10")
+#=> Returns featured article dated (2018/05/10)
+article.title
+#=> "Russian_battleship_Pobeda"
+article.image_url
+#=> "https://upload.wikimedia.org/wikipedia/commons/0/01/Pobeda1904Port-Artur.jpg"
+article.text
+#=> "Pobeda was the last of the three Peresvet-class pre-dreadnought battleships built for the Imperial Russian Navy at the end of the nineteenth century. The ship was assigned to the Pacific Squadron upon completion and based at Port Arthur from 1903. During the Russo-Japanese War of 1904–1905, she participated in the battles of Port Arthur and the Yellow Sea. Having escaped serious damage in these engagements, Pobeda was sunk by gunfire during the Siege of Port Arthur, and then salvaged by the Japanese and placed into service under the name Suwo (周防)."
+
+today_article = WikipediaRestClient.get_featured_article
+#=> Returns featured article of the current day
+today_article.title
+#=> "Arlington,_Washington"
+today_article.url
+#=> "https://en.wikipedia.org/wiki/Arlington,_Washington"
+today_article.pageid
+#=> 138192
+```
+
+
+### Picture of the day
+
+**Example**
+```ruby
+picture_of_the_day = WikipediaRestClient.get_image_of_the_day
+#=> Returns image of the day from Wikipedia.
+picture_of_the_day.title
+#=> "File:Haus der Kulturen der Welt, Blaue Stunde, Berlin, 160521, ako.jpg"
+picture_of_the_day.image_url
+#=> "https://upload.wikimedia.org/wikipedia/commons/2/25/Haus_der_Kulturen_der_Welt%2C_Blaue_Stunde%2C_Berlin%2C_160521%2C_ako.jpg"
+picture_of_the_day.image_height
+#=> 3648
+picture_of_the_day.thumbnail
+#=> "https://upload.wikimedia.org/wikipedia/commons/thumb/2/25/Haus_der_Kulturen_der_Welt%2C_Blaue_Stunde%2C_Berlin%2C_160521%2C_ako.jpg/640px-Haus_der_Kulturen_der_Welt%2C_Blaue_Stunde%2C_Berlin%2C_160521%2C_ako.jpg"
+picture_of_the_day_for_a_date = WikipediaRestClient.get_image_of_the_day("2017/03/12")
+#=> Returns pictured of the day for the specified date ("YYYY/MM/DD")
+picture_of_the_day_for_a_date.image_url 
+#=> "https://upload.wikimedia.org/wikipedia/commons/4/4b/Cyclosia_papilionaris-Kadavoor-2016-06-17-001.jpg"
+picture_of_the_day_for_a_date.description_text
+#=>  "<i><a rel=\"mw:WikiLink/Interwiki\" href=\"https://en.wikipedia.org/wiki/Cyclosia%20papilionaris\" title=\"en:Cyclosia papilionaris\">Cyclosia papilionaris</a></i>, Drury's Jewel, is a moth in the <a rel=\"mw:WikiLink/Interwiki\" href=\"https://en.wikipedia.org/wiki/Zygaenidae\" title=\"en:Zygaenidae\">Zygaenidae</a> family. There are many subspecies and this is <i>Cyclosia papilionaris australinda</i> found in <a rel=\"mw:WikiLink/Interwiki\" href=\"https://en.wikipedia.org/wiki/South%20India\" title=\"en:South India\">South India</a>."
+```
+
+It will have the following information,
+- title
+- image_url
+- image_width
+- image_height
+- thumbnail
+- thumbnail_width
+- thumbnail_height
+- description_text
+
+
+### On This Day
+
+```ruby
+on_this_day_content = WikipediaRestClient.get_on_this_day
+#=> Returns 'on this day' contents of the current date
+on_that_day = WikipediaRestClient.get_on_this_day(<DATE>) #Date Should be in YYYY/MM/DD Format
+#=> Returns 'on this day' contents of the specified date
+```
+
+**Example**
+```ruby
+on_this_day_content = WikipediaRestClient.get_on_this_day
+#=> Returns Array of Hash values which contains 'on this day' contents
+on_this_day_content[0]["text"]
+#=> "A corroded oil pipeline in Santa Barbara County, California, burst, spilling 142,800 U.S. gallons (3,400 barrels) of crude oil onto one of the most biologically diverse coastlines of the U.S. West Coast."
+on_this_day_content[0]["year"]
+#=> 2013
+on_this_day_content[0]["pages"]
+#=> Returns Array of Wikipedia pages related to that topic
+
+on_that_day = WikipediaRestClient.get_on_this_day("2018/03/11")
+#=> Returns 'on this day' contents for the specified date
+on_that_day[0]["text"]
+#=>  "United States Army officer Robert Bales murdered sixteen civilians and wounded six others in the Panjwayi District of Kandahar Province, Afghanistan."
+```
+
+### Get News
+
+```ruby
+on_this_day_content = WikipediaRestClient.get_news
+#=> Returns 'news' contents of the current date
+on_that_day = WikipediaRestClient.get_news(<DATE>) #Date Should be in YYYY/MM/DD Format
+#=> Returns 'news' contents of the specified date
+```
+
+**Example**
+```ruby
+news = WikipediaRestClient.get_news
+#=> Returns Array of Hash values which contains news contents
+news[0]["story"]
+#=> "Incumbent Nicolás Maduro is re-elected President of Venezuela."
+news[0]["links"]
+#=> Returns Array of link pages related to that news
+```
+
+### Most-Read articles of the day
+
+```ruby
+on_this_day_content = WikipediaRestClient.get_most_read
+#=> Returns 'most read' contents of the current date
+on_that_day = WikipediaRestClient.get_most_read(<DATE>) #Date Should be in YYYY/MM/DD Format
+#=> Returns 'most read' contents of the specified date
+```
+
+***Example***
+```ruby
+most_read = WikipediaRestClient.get_most_read
+#=> Returns Hash value
+most_read["articles"][0]["views"]
+#=> 709029
+most_read["articles"][0]["title"]
+#=> "Elizabeth_II"
+most_read["articles"][0]["extract"]
+#=> "Elizabeth II is Queen of the United Kingdom and fifteen other Commonwealth realms."
+most_read["articles"][0]["content_urls"]["desktop"]["page"]
+#=> "https://en.wikipedia.org/wiki/Elizabeth_II"
+```
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/Balaji-Ramasubramanian/wikipedia_rest_client. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the WikipediaRestClient project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/Balaji-Ramasubramanian/wikipedia_rest_client/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "wikipedia_rest_client"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/wikipedia_rest_client.rb

@@ -0,0 +1,283 @@
+require "wikipedia_rest_client/version"
+require "wikipedia_rest_client/utils"
+require "wikipedia_rest_client/page"
+require "wikipedia_rest_client/featured_article"
+require "wikipedia_rest_client/image_of_the_day"
+
+require 'httparty'
+require 'json'
+require 'date'
+require 'uri'
+require 'nokogiri'
+
+# @author Balaji
+module WikipediaRestClient
+  	# header options to be passed through HTTP requests.
+  	@@options = {}
+	# @param username [String] Email address or URLs of contact pages
+	# @return [nil]
+	# This method will set up the User-Agent header to the HTTP request.
+	#
+	# Example:
+	#
+	#      WikipediaRestClient.setUserAgent("someone@gmail.com")
+	#
+	def self.setUserAgent(username)
+		@@options = {
+			headers: {"User-Agent" => username}
+		}
+	end
+
+	# @param title [String] A Wikipedia page title that has to be fetched.
+	# @return [WikipediaRestClient::Page] WikipediaRestClient::Page object which contains the data about the specified title.
+	# This method gets search query as a parameter and returns an object that contains the data about the specified Wikipedia page. 
+	#
+	# Example:
+	#
+	#      page = WikipediaRestClient.get_page("Indian President")
+	#      => "<Returns an object that contains contents of the required page>"
+	#      page.title
+	#      => "President of India"
+	#      page.text
+	#      => "The President of the Republic of India is the head of state of India and the commander-in-chief of the Indian Armed Forces."
+	#      page.image_url
+	#      => "<Returns the image url of the page>"
+	#      The Page class contains the following information,
+	#      page.url 
+	#      => "https://en.wikipedia.org/wiki/President_of_India"
+	#      page.pageid
+	#      => 141896
+	#      page.description
+	#      => "executive head of state of the Republic of India"
+	#
+	# Page class contains the following methods,
+	#
+	#      - type
+	#      - title
+	#      - display_title
+	#      - namespace_id
+	#      - namespace_text
+	#      - titles_canonical
+	#      - titles_normalized
+	#      - titles_display
+	#      - pageid
+	#      - thumbnail_source
+	#      - thumbnail_width   
+	#      - thumbnail_height
+	#      - lang
+	#      - dir
+	#      - revision
+	#      - tid
+	#      - timestamp
+	#      - description
+	#      - image_url
+	#      - image_width
+	#      - image_height
+	#      - url_desktop_page
+	#      - url_desktop_revisions
+	#      - url_desktop_edit
+	#      - url_desktop_talk
+	#      - url_mobile_page
+	#      - url_mobile_revisions
+	#      - url_mobile_edit
+	#      - url_mobile_talk
+	#      - api_urls_summary
+	#      - api_urls_metadata
+	#      - api_urls_references
+	#      - api_urls_media
+	#      - api_urls_edit_html
+	#      - api_urls_talk_page_html
+	#      - text
+	#      - text_html
+	#      - normalized_title
+	#      - url
+	#
+	def self.get_page(title)
+		title = URI::encode(title)
+		page_url = BASE_URL + PAGE_URL + title
+		page_response = HTTParty.get(page_url, @@options)
+		page = Page.new(page_response)
+		page
+	end
+	# @param null
+	# @return [WikipediaRestClient::Page] WikipediaRestClient::Page object which returns a random page from Wikipedia.
+	# This method will return a random page from Wikipedia.
+	#
+	# Example:
+	# 
+	#      page = WikipediaRestClient.get_random
+	#      => Return a random page from wikipedia 
+	#      page.title
+	#      => "Adams Glacier (Victoria Land)"
+	#      page.text
+	#      => "Adams Glacier is a small glacier immediately south of Miers Glacier in Victoria Land. The heads of Adams and Miers glaciers, both located in the Miers Valley, are separated by a low ridge, and the east end of this ridge is almost completely surrounded by the snouts of the two glaciers, which nearly meet in the bottom of the valley, about 1 mile (1.6 km) above Lake Miers, into which they drain. It was named by the New Zealand Northern Survey Party of the Commonwealth Trans-Antarctic Expedition (1956–58) after Lieutenant Jameson Adams, second in command of the shore party of the British Antarctic Expedition (1907–09), who was one of the men to accompany Ernest Shackleton to within 97 miles (156 km) of the South Pole."
+	#      page.url
+	#      => "https://en.wikipedia.org/wiki/Adams_Glacier_(Victoria_Land)"
+	#      page.pageid
+	#      => 16524953
+	#      page.image_url
+	#      => "<Returns the URL of the image>"
+	#
+	def self.get_random
+		random_url = BASE_URL + RANDOM_PAGE_URL
+		random_page_response = JSON.parse(HTTParty.get(random_url, @@options))
+		random_title = random_page_response["uri"].gsub("/en.wikipedia.org/v1/page/random/../summary/","")
+		random_page = get_page(random_title)
+		random_page
+
+	end
+
+	# @param date [String] The string must be a date in YYYY/MM/DD format. The default parameter is the current date.
+	# @return [WikipediaRestClient::Page] An object of WikipediaRestClient::Page.
+	# This method will return the featured article of the specified date from Wikipedia(Default parameter is current date).
+	#
+	# Example:
+	#
+	#      old_article = WikipediaRestClient.get_featured_article("2018/05/10")
+	#      => Returns featured article dated (2018/05/10)
+	#      article.title
+	#      => "Russian_battleship_Pobeda"
+	#      article.image_url
+	#      => "<Returns the URL of the image>"
+	#      article.text
+	#      => "Pobeda was the last of the three Peresvet-class pre-dreadnought battleships built for the Imperial Russian Navy at the end of the nineteenth century. The ship was assigned to the Pacific Squadron upon completion and based at Port Arthur from 1903. During the Russo-Japanese War of 1904–1905, she participated in the battles of Port Arthur and the Yellow Sea. Having escaped serious damage in these engagements, Pobeda was sunk by gunfire during the Siege of Port Arthur, and then salvaged by the Japanese and placed into service under the name Suwo (周防)."
+	#      today_article = WikipediaRestClient.get_featured_article
+	#      => Returns featured article of the current day
+	#      today_article.title
+	#      => "Arlington,_Washington"
+	#      today_article.url
+	#      => "https://en.wikipedia.org/wiki/Arlington,_Washington"
+	#      today_article.pageid
+	#      => 138192
+	#
+	def self.get_featured_article( date = Time.now.strftime("%Y/%m/%d") )
+		url = BASE_URL + FEATURED_ARTICLE + date
+		response = HTTParty.get(url, @@options)
+		article = FeaturedArticle.new.featured_article(response)
+		page = Page.new(article)
+		page
+	end
+
+	# @param date [String] The string must be a date in YYYY/MM/DD format. default parameter is current date.
+	# @return [WikipediaRestClient::IageOfTheDay] An object of WikipediaRestClient::ImageOfTheDay.
+	# This method will return 'Image of the day' content of the specified date from Wikipedia(Default parameter is current date).
+	# 
+	# Example:
+	#
+	#      picture_of_the_day = WikipediaRestClient.get_image_of_the_day
+	#      => Returns picture of the day from Wikipedia.
+	#      picture_of_the_day.title
+	#      => "File:Haus der Kulturen der Welt, Blaue Stunde, Berlin, 160521, ako.jpg"
+	#      picture_of_the_day.image_url
+	#      => "<Returns the URL of the image>"
+	#      picture_of_the_day.image_height
+	#      => 3648
+	#      picture_of_the_day.thumbnail
+	#      => "<Returns the thumbnail URL of the image>"
+	#      picture_of_the_day_for_a_date = WikipediaRestClient.get_image_of_the_day("2017/03/12")
+	#      => Returns pictured of the day for the specified date ("YYYY/MM/DD")
+	#      picture_of_the_day_for_a_date.image_url 
+	#      => "<Returns the URL of the image>"
+	#      picture_of_the_day_for_a_date.description_text
+	#      =>  "<i><a rel=\"mw:WikiLink/Interwiki\" href=\"https://en.wikipedia.org/wiki/Cyclosia%20papilionaris\" title=\"en:Cyclosia papilionaris\">Cyclosia papilionaris</a></i>, Drury's Jewel, is a moth in the <a rel=\"mw:WikiLink/Interwiki\" href=\"https://en.wikipedia.org/wiki/Zygaenidae\" title=\"en:Zygaenidae\">Zygaenidae</a> family. There are many subspecies and this is <i>Cyclosia papilionaris australinda</i> found in <a rel=\"mw:WikiLink/Interwiki\" href=\"https://en.wikipedia.org/wiki/South%20India\" title=\"en:South India\">South India</a>."
+	#	
+	#
+	# It will have the following information,
+	#
+	#      - title
+	#      - image_url
+	#      - image_width
+	#      - image_height
+	#      - thumbnail
+	#      - thumbnail_width
+	#      - thumbnail_height
+	#      - description_text
+	#
+	def self.get_image_of_the_day(date = Time.now.strftime("%Y/%m/%d") )
+		url = BASE_URL + FEATURED_ARTICLE + date
+		response = HTTParty.get(url, @@options)
+		image = ImageOfTheDay.new(response)
+		image
+	end
+
+	# @param date [String] The string must be a date in YYYY/MM/DD format.The default parameter is the current date.
+	# @return [JSON] "on this day" content from Wikipedia. 
+	# This method will be used to get the 'On this day' content from Wikipedia. The default parameter is the current date. If you need you can pass a date in YYYY/MM/DD format and get the "on this day " content for that specified date.
+	# 
+	# Example:
+	#
+	#      on_this_day_content = WikipediaRestClient.get_on_this_day
+	#      => Returns Array of Hash values which contains 'on this day' contents
+	#      on_this_day_content[0]["text"]
+	#      => "A corroded oil pipeline in Santa Barbara County, California, burst, spilling 142,800 U.S. gallons (3,400 barrels) of crude oil onto one of the most biologically diverse coastlines of the U.S. West Coast."
+	#      on_this_day_content[0]["year"]
+	#      => 2013
+	#      on_this_day_content[0]["pages"]
+	#      => Returns Array of Wikipedia pages related to that topic
+	#      on_that_day = WikipediaRestClient.get_on_this_day("2018/03/11")
+	#      => Returns 'on this day' contents for the specified date
+	#      on_that_day[0]["text"]
+	#      =>  "United States Army officer Robert Bales murdered sixteen civilians and wounded six others in the Panjwayi District of Kandahar Province, Afghanistan."
+	#
+	def self.get_on_this_day(date = Time.now.strftime("%Y/%m/%d"))
+		url = BASE_URL + FEATURED_ARTICLE + date
+		response = HTTParty.get(url, @@options)
+		response["onthisday"]
+	end
+
+	# @param date [String] The string must be a date in YYYY/MM/DD format. The default parameter is the current date.
+	# @return [JSON] JSON object that contains news contents from Wikipedia page.
+	# This method will return the list of news that is in the form of JSON object. Each news content will contain news and their related links.
+	#
+	# Example:
+	# 
+	#      news = WikipediaRestClient.get_news
+	#      => Returns Array of Hash values which contains news contents
+	#      news[0]["story"]
+	#      => "Incumbent Nicolás Maduro is re-elected President of Venezuela."
+	#      news[0]["links"]
+	#      => Returns Array of link pages related to that news
+	#
+	def self.get_news(date = Time.now.strftime("%Y/%m/%d"))
+		url = BASE_URL + FEATURED_ARTICLE + date
+		response = HTTParty.get(url, @@options)
+		news = WikipediaRestClient.parsed_news(response["news"])
+		news
+	end
+
+	# @param date [String] The string must be a date in YYYY/MM/DD format. The default parameter is the current date.
+	# @return [JSON] an JSON object that contains the most-read contents of the specified date
+	# This method will return the contents of mostread pages of the specified date(Default is current date). 
+	#
+	# Example:
+	#
+	#      most_read = WikipediaRestClient.get_most_read
+	#      => Returns Hash value
+	#      most_read["articles"][0]["views"]
+	#      => 709029
+	#      most_read["articles"][0]["title"]
+	#      => "Elizabeth_II"
+	#      most_read["articles"][0]["extract"]
+	#      => "Elizabeth II is Queen of the United Kingdom and fifteen other Commonwealth realms."
+	#      most_read["articles"][0]["content_urls"]["desktop"]["page"]
+	#      => "https://en.wikipedia.org/wiki/Elizabeth_II"
+	#
+	def self.get_most_read(date = Time.now.strftime("%Y/%m/%d"))
+		url = BASE_URL + FEATURED_ARTICLE + date
+		response = HTTParty.get(url, @@options)
+		response["mostread"]
+	end
+
+	# @param news [JSON] The JSON object from the get_news method will be used here.
+	# @return [JSON] Returns the parsed HTML contents inside the JSON object of get_news method.
+	def self.parsed_news(news)
+		news.each do |news|
+			data = news["story"]
+			parsed_data = Nokogiri::HTML(data)
+			news["story"] = parsed_data.text
+		end
+		news
+	end
+
+
+end

data/lib/wikipedia_rest_client/featured_article.rb

@@ -0,0 +1,25 @@
+module WikipediaRestClient
+
+	# @author Balaji
+	class FeaturedArticle
+
+		# Today's Featured Article from Wikipedia page.
+		def featured_article(json)
+			@data = json
+			if @data["tfa"]
+				then 
+				@data["tfa"]
+			end
+		end
+
+		# Image of the day content from Wikipedia page.
+		def image_of_the_day
+			@data["image"]["image"]["source"]
+		end
+		
+	end
+
+
+end
+
+

data/lib/wikipedia_rest_client/image_of_the_day.rb

@@ -0,0 +1,56 @@
+require 'nokogiri'
+module WikipediaRestClient
+
+	# @author Balaji
+	class ImageOfTheDay
+
+		# Returns
+		def initialize(json)
+			@data = json["image"]
+		end
+
+		# Returns the tile of ImageOfTheDay
+		def title
+			@data["title"]
+		end
+
+		# Returns the URL of the image
+		def image_url
+			@data["image"]["source"]
+		end
+
+		# Returns width of the image
+		def image_width
+			@data["image"]["width"]
+		end
+
+		# Returns height of the image
+		def image_height
+			@data["image"]["height"]
+		end
+
+		# Returns the source of the thumbnail image
+		def thumbnail
+			@data["thumbnail"]["source"]
+		end
+
+		# Returns width of thumbnail
+		def thumbnail_width
+			@data["thumbnail"]["width"]
+		end
+
+		# Returns height of thumbnail
+		def thumbnail_height
+			@data["thumbnail"]["height"]
+		end
+
+		# Returns description about the image
+		def description_text
+			html_data = @data["description"]["text"]
+			parsed_data = Nokogiri::HTML(html_data)
+			parsed_data.text
+		end
+
+	end
+
+end

data/lib/wikipedia_rest_client/page.rb

@@ -0,0 +1,208 @@
+module WikipediaRestClient
+	# WikipediaRestClient::Page class
+	# @author Balaji
+	class Page
+
+		# initialize the data of the Page object
+		def initialize(json)
+			@data = json
+		end
+
+		# Returns the type of the Page
+		def type
+			@data["type"]
+		end
+
+		# Returns the title of the Page
+		def title
+			@data["title"]
+		end
+
+		# Returns the display title of the Page
+		def display_title
+			@data["displaytitle"]
+		end
+
+		# Returns the namepade id of the page
+		def namespace_id
+			@data["namespace"]["id"]
+		end
+
+		# Returns the namespace text
+		def namespace_text
+			@data["namespace"]["text"]
+		end
+
+		# Returns the tile (canonical)
+		def titles_canonical
+			@data["titles"]["canonical"]
+		end
+
+		# Returns the title (normalized)
+		def titles_normalized
+			@data["titles"]["normalized"]
+		end
+
+		# Returns the title (display)
+		def titles_display
+			@data["titles"]["display"]
+		end
+
+		# Returns the pageid of that page
+		def pageid
+			@data["pageid"]
+		end
+
+		# Returns the source of the thumbnail image
+		def thumbnail_source
+			@data["thumbnail"]["source"]
+		end
+
+		# Returns the width of the thumbnail image
+		def thumbnail_width
+			@data["thumbnail"]["width"]
+		end
+
+		# Returns the height of the thumbnail image
+		def thumbnail_height
+			@data["thumbnail"]["height"]
+		end
+
+		# Returns the language of that page
+		def lang
+			@data["lang"]
+		end
+
+		# Returns dir
+		def dir
+			@data["dir"]
+		end
+
+		# Returns revision
+		def revision
+			@data["revision"]
+		end
+
+		# Returns tid
+		def tid
+			@data["tid"]
+		end
+
+		# Returns timestamp
+		def timestamp
+			@data["timestamp"]
+		end
+
+		# Returns description of that page content
+		def description
+			@data["description"]
+		end
+
+		# Returns the url of the main image in the page
+		def image_url
+			@data["originalimage"]["source"]
+		end
+
+		# Returns width of the main image it the page
+		def image_width
+			@data["originalimage"]["width"]
+		end
+
+		# Returns height of the main image it the page
+		def image_height
+			@data["originalimage"]["height"]
+		end
+
+		# Returns page url (desktop)
+		def url_desktop_page
+			@data["content_urls"]["desktop"]["page"]
+		end
+
+		# Returns revision url (desktop)
+		def url_desktop_revisions
+			@data["content_urls"]["desktop"]["revision"]
+		end
+
+		# Returns edit url (desktop)
+		def url_desktop_edit
+			@data["content_urls"]["desktop"]["edit"]
+		end
+
+		# Returns talk url (desktop)
+		def url_desktop_talk
+			@data["content_urls"]["desktop"]["talk"]
+		end
+
+		# Returns page url (mobile)
+		def url_mobile_page
+			@data["content_urls"]["mobile"]["page"]
+		end
+
+		# Returns revision url (mobile)
+		def url_mobile_revisions
+			@data["content_urls"]["mobile"]["revision"]
+		end
+
+		# Returns mobile_edit url (mobile)
+		def url_mobile_edit
+			@data["content_urls"]["mobile"]["edit"]
+		end
+
+		# Returns mobile_talk url (mobile)
+		def url_mobile_talk
+			@data["content_urls"]["mobile"]["talk"]
+		end
+
+		# Returns summary url
+		def api_urls_summary
+			@data["api_urls"]["summary"]
+		end
+
+		# Returns metadata url
+		def api_urls_metadata
+			@data["api_urls"]["metadata"]
+		end
+
+		# Returns references rul
+		def api_urls_references
+			@data["api_urls"]["references"]
+		end
+
+		# Returns media url
+		def api_urls_media
+			@data["api_urls"]["media"]
+		end
+
+		# Returns edit_html url
+		def api_urls_edit_html
+			@data["api_urls"]["edit_html"]
+		end
+
+		# Returns talk_page_html url
+		def api_urls_talk_page_html
+			@data["api_urls"]["talk_page_html"]
+		end
+
+		# Returns the text of the page
+		def text
+			@data["extract"]
+		end
+
+		# Returns extract_html
+		def text_html
+			@data["extract_html"]
+		end
+
+		# Returns normalized title
+		def normalized_title
+			@data["normalizedtitle"]
+		end
+
+		# Returns page url (desktop)
+		def url
+			@data["content_urls"]["desktop"]["page"]
+		end
+
+	end
+
+end

data/lib/wikipedia_rest_client/utils.rb

@@ -0,0 +1,12 @@
+module WikipediaRestClient
+
+	# Base URL of the Wikipedia REST API.
+	BASE_URL = "https://en.wikipedia.org/api/rest_v1"
+	# URL parameters that are used to fetch the page content. 
+	PAGE_URL = "/page/summary/"
+	# URL parameters that are used to fetch random page from Wikipedia.
+	RANDOM_PAGE_URL = "/page/random/summary"
+	# URL parameters that are used to get featured articles.
+	FEATURED_ARTICLE = "/feed/featured/"
+
+end

data/lib/wikipedia_rest_client/version.rb

@@ -0,0 +1,4 @@
+module WikipediaRestClient
+  # Version number of the gem
+  VERSION = "0.1.0"
+end

data/wikipedia_rest_client.gemspec

@@ -0,0 +1,45 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "wikipedia_rest_client/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "wikipedia_rest_client"
+  spec.version       = WikipediaRestClient::VERSION
+  spec.authors       = ["Balaji"]
+  spec.email         = ["balaji030698@gmail.com"]
+
+  spec.summary       = %q{This is ruby gem for getting Wikipedia contents.}
+  spec.description   = %q{By using this gem, we can get Wikipedia page contents, today's featured article, and picture of the day from Wikipedia.}
+  spec.homepage      = "https://github.com/Balaji-Ramasubramanian/wikipedia_rest_client.git"
+  spec.license       = "MIT"
+  spec.files         = ['lib/wikipedia_rest_client/version.rb',
+                        'lib/wikipedia_rest_client/utils.rb',
+                        'lib/wikipedia_rest_client/page.rb',
+                        'lib/wikipedia_rest_client/featured_article.rb',
+                        'lib/wikipedia_rest_client/image_of_the_day.rb'
+                        ]
+  # spec.files = Dir['lib/**/*.rb']
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_dependency "json", "~> 2.0.2"
+  spec.add_dependency "httparty", "~> 0.15.6"
+  spec.add_dependency 'nokogiri',  '>= 1.6.8'
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: wikipedia_rest_client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Balaji
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-05-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.15.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.15.6
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.8
+description: By using this gem, we can get Wikipedia page contents, today's featured
+  article, and picture of the day from Wikipedia.
+email:
+- balaji030698@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".DS_Store"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/wikipedia_rest_client.rb
+- lib/wikipedia_rest_client/featured_article.rb
+- lib/wikipedia_rest_client/image_of_the_day.rb
+- lib/wikipedia_rest_client/page.rb
+- lib/wikipedia_rest_client/utils.rb
+- lib/wikipedia_rest_client/version.rb
+- wikipedia_rest_client.gemspec
+homepage: https://github.com/Balaji-Ramasubramanian/wikipedia_rest_client.git
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.2
+signing_key: 
+specification_version: 4
+summary: This is ruby gem for getting Wikipedia contents.
+test_files: []