aylien_text_api 0.0.1

data/spec/fixtures/aylien_text_api/client/summarize_with_unauthenticated_client.yml

@@ -0,0 +1,40 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.aylien.com/api/v1/summarize
+    body:
+      encoding: US-ASCII
+      string: text=Batman+has+always+been+my+favourite+superhero+ever+since+the+first+time+I+heard+about+him+because+he+his+human+with+no+powers%2C+also+he+is+much+more+questionable+than+any+other+superhero.+The+story+of+the+film+is+about+Batman%2C+Lieutenant+James+Gordon%2C+and+new+district+attorney+Harvey+Dent+beginning+to+succeed+in+rounding+up+the+criminals+that+plague+Gotham+City.+They+are+unexpectedly+challenged+when+a+mysterious+criminal+mastermind+known+as+the+Joker+appears+in+Gotham.+Batman%27s+struggle+against+the+Joker+becomes+deeply+personal%2C+forcing+him+to+%22confront+everything+he+believes%22+and+to+improve+his+technology+%28which+introduces+the+recreation+of+the+Batcycle%2C+known+as+the+Batpod+and+the+Batsuit+was+redesigned%29+to+stop+the+madman%27s+campaign+of+destruction.+During+the+course+of+the+film%2C+a+love+triangle+develops+between+Bruce+Wayne%2C+Dent+and+Rachel+Dawes.++There+are+now+six+Batman+films+and+I+must+say+that+The+Dark+Knight+is+the+best+out+of+all+of+them.+The+title+is+good+because+that+is+what+Batman+actually+is.+It+has+been+3+years+for+the+adventure+to+continue+from+Batman+Begins+but+that+entire+wait+was+worth+it.+Gotham+city+is+very+Gothic+looking+and+is+very+haunting+and+visionary.+The+whole+movie+is+charged+with+pulse-pounding+suspense%2C+ingenious+special+effects+and+riveting+performances+from+a+first-rate+cast+especially+from+Heath+Ledger+who+gave+an+Oscar+nomination+performance+for+best+supporting-actor.+It+is+a+shame+that+he+can%27t+see+his+terrific+work+on-screen.+The+cinematography+is+excellent+which+is+made+so+dark+%26+sinister+that+really+did+suit+the+mood+for+the+film.+Usually+sequels+don%27t+turn+out+to+be+better+than+the+original+but+The+Dark+Knight+is+one+of+those+rare+sequels+that+surpasses+the+original+like+The+Godfather+2.+I+also+really+liked+the+poster+where+the+building+is+on+fire+in+a+Bat+symbol+%26+Batman+is+standing+in+front+of+it.+Christopher+Nolan+is+a+brilliant+director+and+his+film+Memento+is+one+of+my+most+favourite+films.+He+hasn%27t+made+10+movies+yet+and+3+of+them+are+already+on+the+IMDb+top+250.+Overall+The+Dark+Knight+is+the+kind+of+movie+that+will+make+the+audience+cheer+in+the+end+instead+of+throwing+fruit+%26+vegetables+on+the+screen.
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Aylien Text API Ruby Gem 0.0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      App-Id:
+      - random_string
+      App-Key:
+      - random_string
+  response:
+    status:
+      code: 403
+      message: Forbidden
+    headers:
+      Server:
+      - openresty/1.5.12.1
+      Date:
+      - Tue, 02 Dec 2014 18:16:03 GMT
+      Content-Type:
+      - text/plain; charset=us-ascii
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: Authentication failed
+    http_version: 
+  recorded_at: Tue, 02 Dec 2014 18:15:00 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/aylien_text_api/client/summarize_with_valid_url.yml

@@ -0,0 +1,65 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.aylien.com/api/v1/summarize
+    body:
+      encoding: US-ASCII
+      string: url=http%3A%2F%2Fwww.bbc.com%2Fsport%2F0%2Ffootball%2F25912393
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Aylien Text API Ruby Gem 0.0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      App-Id:
+      - <PASSWORD>
+      App-Key:
+      - <PASSWORD>
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - openresty/1.5.12.1
+      Date:
+      - Tue, 02 Dec 2014 18:16:05 GMT
+      Content-Type:
+      - application/json;charset=UTF-8
+      Content-Length:
+      - '1916'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"text\": \"Lionel Messi: Forward is not for sale, says Barcelona
+        president\\n\\nBarcelona forward Lionel Messi is not for sale and the club
+        plan to discuss a new contract with the Argentine, says president Josep Maria
+        Bartomeu.\\n\\nFour-time Ballon d'Or winner Messi, 26, is reported to be a\\n\\nIn
+        an interview with radio station RAC1, Bartomeu said: \\\"The club will sit
+        down and negotiate a new contract.\\n\\n\\\"We will do what we have to, to
+        ensure he's the best-paid player.\\\"\\n\\nMessi scored 60 goals in 50 appearances
+        last season but has struggled to match that goalscoring form in 2013-14.\\n\\nHe
+        has scored 18 goals so far but just eight of those have been in the league.\\n\\nHis
+        last league goal came in September, before he was out for five weeks with
+        a hamstring injury.\\n\\n\\\"He can do everything,\\\" said Barca coach Gerardo
+        Martino. \\\"If he succeeds in other facets of his game, it doesn't matter
+        if he scores.\\n\\n\\\"Nothing surprises me with him. He controls the game
+        well, passes the ball well, he is a good finisher, he can press and recover
+        the ball.\\n\\n\\\"He sees passes that most people can only see whilst watching
+        the game on TV or in the stands, not ones that you can normally see on the
+        field.\\\"\",\n  \"sentences\": [\"Lionel Messi: Forward is not for sale,
+        says Barcelona president\\n\\nBarcelona forward Lionel Messi is not for sale
+        and the club plan to discuss a new contract with the Argentine, says president
+        Josep Maria Bartomeu.\", \"Four-time Ballon d'Or winner Messi, 26, is reported
+        to be a\\n\\nIn an interview with radio station RAC1, Bartomeu said: \\\"The
+        club will sit down and negotiate a new contract.\", \"His last league goal
+        came in September, before he was out for five weeks with a hamstring injury.\",
+        \"\\\"If he succeeds in other facets of his game, it doesn't matter if he
+        scores.\", \"He controls the game well, passes the ball well, he is a good
+        finisher, he can press and recover the ball.\"]\n}"
+    http_version: 
+  recorded_at: Tue, 02 Dec 2014 18:15:02 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/aylien_text_api/client/summarize_with_value_as_text_and_title.yml

@@ -0,0 +1,78 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.aylien.com/api/v1/summarize
+    body:
+      encoding: US-ASCII
+      string: title=Batman+at+his+best+and+beyond&text=Batman+has+always+been+my+favourite+superhero+ever+since+the+first+time+I+heard+about+him+because+he+his+human+with+no+powers%2C+also+he+is+much+more+questionable+than+any+other+superhero.+The+story+of+the+film+is+about+Batman%2C+Lieutenant+James+Gordon%2C+and+new+district+attorney+Harvey+Dent+beginning+to+succeed+in+rounding+up+the+criminals+that+plague+Gotham+City.+They+are+unexpectedly+challenged+when+a+mysterious+criminal+mastermind+known+as+the+Joker+appears+in+Gotham.+Batman%27s+struggle+against+the+Joker+becomes+deeply+personal%2C+forcing+him+to+%22confront+everything+he+believes%22+and+to+improve+his+technology+%28which+introduces+the+recreation+of+the+Batcycle%2C+known+as+the+Batpod+and+the+Batsuit+was+redesigned%29+to+stop+the+madman%27s+campaign+of+destruction.+During+the+course+of+the+film%2C+a+love+triangle+develops+between+Bruce+Wayne%2C+Dent+and+Rachel+Dawes.++There+are+now+six+Batman+films+and+I+must+say+that+The+Dark+Knight+is+the+best+out+of+all+of+them.+The+title+is+good+because+that+is+what+Batman+actually+is.+It+has+been+3+years+for+the+adventure+to+continue+from+Batman+Begins+but+that+entire+wait+was+worth+it.+Gotham+city+is+very+Gothic+looking+and+is+very+haunting+and+visionary.+The+whole+movie+is+charged+with+pulse-pounding+suspense%2C+ingenious+special+effects+and+riveting+performances+from+a+first-rate+cast+especially+from+Heath+Ledger+who+gave+an+Oscar+nomination+performance+for+best+supporting-actor.+It+is+a+shame+that+he+can%27t+see+his+terrific+work+on-screen.+The+cinematography+is+excellent+which+is+made+so+dark+%26+sinister+that+really+did+suit+the+mood+for+the+film.+Usually+sequels+don%27t+turn+out+to+be+better+than+the+original+but+The+Dark+Knight+is+one+of+those+rare+sequels+that+surpasses+the+original+like+The+Godfather+2.+I+also+really+liked+the+poster+where+the+building+is+on+fire+in+a+Bat+symbol+%26+Batman+is+standing+in+front+of+it.+Christopher+Nolan+is+a+brilliant+director+and+his+film+Memento+is+one+of+my+most+favourite+films.+He+hasn%27t+made+10+movies+yet+and+3+of+them+are+already+on+the+IMDb+top+250.+Overall+The+Dark+Knight+is+the+kind+of+movie+that+will+make+the+audience+cheer+in+the+end+instead+of+throwing+fruit+%26+vegetables+on+the+screen.
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Aylien Text API Ruby Gem 0.0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      App-Id:
+      - <PASSWORD>
+      App-Key:
+      - <PASSWORD>
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - openresty/1.5.12.1
+      Date:
+      - Tue, 02 Dec 2014 18:16:06 GMT
+      Content-Type:
+      - application/json;charset=UTF-8
+      Content-Length:
+      - '2952'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"text\": \"Batman has always been my favourite superhero ever
+        since the first time I heard about him because he his human with no powers,
+        also he is much more questionable than any other superhero. The story of the
+        film is about Batman, Lieutenant James Gordon, and new district attorney Harvey
+        Dent beginning to succeed in rounding up the criminals that plague Gotham
+        City. They are unexpectedly challenged when a mysterious criminal mastermind
+        known as the Joker appears in Gotham. Batman's struggle against the Joker
+        becomes deeply personal, forcing him to \\\"confront everything he believes\\\"
+        and to improve his technology (which introduces the recreation of the Batcycle,
+        known as the Batpod and the Batsuit was redesigned) to stop the madman's campaign
+        of destruction. During the course of the film, a love triangle develops between
+        Bruce Wayne, Dent and Rachel Dawes.  There are now six Batman films and I
+        must say that The Dark Knight is the best out of all of them. The title is
+        good because that is what Batman actually is. It has been 3 years for the
+        adventure to continue from Batman Begins but that entire wait was worth it.
+        Gotham city is very Gothic looking and is very haunting and visionary. The
+        whole movie is charged with pulse-pounding suspense, ingenious special effects
+        and riveting performances from a first-rate cast especially from Heath Ledger
+        who gave an Oscar nomination performance for best supporting-actor. It is
+        a shame that he can't see his terrific work on-screen. The cinematography
+        is excellent which is made so dark & sinister that really did suit the mood
+        for the film. Usually sequels don't turn out to be better than the original
+        but The Dark Knight is one of those rare sequels that surpasses the original
+        like The Godfather 2. I also really liked the poster where the building is
+        on fire in a Bat symbol & Batman is standing in front of it. Christopher Nolan
+        is a brilliant director and his film Memento is one of my most favourite films.
+        He hasn't made 10 movies yet and 3 of them are already on the IMDb top 250.
+        Overall The Dark Knight is the kind of movie that will make the audience cheer
+        in the end instead of throwing fruit & vegetables on the screen.\",\n  \"sentences\":
+        [\"Batman has always been my favourite superhero ever since the first time
+        I heard about him because he his human with no powers, also he is much more
+        questionable than any other superhero.\", \"The story of the film is about
+        Batman, Lieutenant James Gordon, and new district attorney Harvey Dent beginning
+        to succeed in rounding up the criminals that plague Gotham City.\", \"There
+        are now six Batman films and I must say that The Dark Knight is the best out
+        of all of them.\", \"The cinematography is excellent which is made so dark
+        & sinister that really did suit the mood for the film.\", \"Overall The Dark
+        Knight is the kind of movie that will make the audience cheer in the end instead
+        of throwing fruit & vegetables on the screen.\"]\n}"
+    http_version: 
+  recorded_at: Tue, 02 Dec 2014 18:15:03 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/aylien_text_api/client/summarize_with_value_as_text_and_without_title.yml

@@ -0,0 +1,41 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.aylien.com/api/v1/summarize
+    body:
+      encoding: US-ASCII
+      string: text=Batman+has+always+been+my+favourite+superhero+ever+since+the+first+time+I+heard+about+him+because+he+his+human+with+no+powers%2C+also+he+is+much+more+questionable+than+any+other+superhero.+The+story+of+the+film+is+about+Batman%2C+Lieutenant+James+Gordon%2C+and+new+district+attorney+Harvey+Dent+beginning+to+succeed+in+rounding+up+the+criminals+that+plague+Gotham+City.+They+are+unexpectedly+challenged+when+a+mysterious+criminal+mastermind+known+as+the+Joker+appears+in+Gotham.+Batman%27s+struggle+against+the+Joker+becomes+deeply+personal%2C+forcing+him+to+%22confront+everything+he+believes%22+and+to+improve+his+technology+%28which+introduces+the+recreation+of+the+Batcycle%2C+known+as+the+Batpod+and+the+Batsuit+was+redesigned%29+to+stop+the+madman%27s+campaign+of+destruction.+During+the+course+of+the+film%2C+a+love+triangle+develops+between+Bruce+Wayne%2C+Dent+and+Rachel+Dawes.++There+are+now+six+Batman+films+and+I+must+say+that+The+Dark+Knight+is+the+best+out+of+all+of+them.+The+title+is+good+because+that+is+what+Batman+actually+is.+It+has+been+3+years+for+the+adventure+to+continue+from+Batman+Begins+but+that+entire+wait+was+worth+it.+Gotham+city+is+very+Gothic+looking+and+is+very+haunting+and+visionary.+The+whole+movie+is+charged+with+pulse-pounding+suspense%2C+ingenious+special+effects+and+riveting+performances+from+a+first-rate+cast+especially+from+Heath+Ledger+who+gave+an+Oscar+nomination+performance+for+best+supporting-actor.+It+is+a+shame+that+he+can%27t+see+his+terrific+work+on-screen.+The+cinematography+is+excellent+which+is+made+so+dark+%26+sinister+that+really+did+suit+the+mood+for+the+film.+Usually+sequels+don%27t+turn+out+to+be+better+than+the+original+but+The+Dark+Knight+is+one+of+those+rare+sequels+that+surpasses+the+original+like+The+Godfather+2.+I+also+really+liked+the+poster+where+the+building+is+on+fire+in+a+Bat+symbol+%26+Batman+is+standing+in+front+of+it.+Christopher+Nolan+is+a+brilliant+director+and+his+film+Memento+is+one+of+my+most+favourite+films.+He+hasn%27t+made+10+movies+yet+and+3+of+them+are+already+on+the+IMDb+top+250.+Overall+The+Dark+Knight+is+the+kind+of+movie+that+will+make+the+audience+cheer+in+the+end+instead+of+throwing+fruit+%26+vegetables+on+the+screen.
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Aylien Text API Ruby Gem 0.0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      App-Id:
+      - <PASSWORD>
+      App-Key:
+      - <PASSWORD>
+  response:
+    status:
+      code: 400
+      message: Bad Request
+    headers:
+      Server:
+      - openresty/1.5.12.1
+      Date:
+      - Tue, 02 Dec 2014 18:16:02 GMT
+      Content-Type:
+      - application/json;charset=UTF-8
+      Content-Length:
+      - '100'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! '{"error" : "requirement failed: if you are not providing an url,
+        both text and title are required."}'
+    http_version: 
+  recorded_at: Tue, 02 Dec 2014 18:14:59 GMT
+recorded_with: VCR 2.9.3

data/spec/fixtures/aylien_text_api/client/summarize_with_value_as_valid_url.yml

@@ -0,0 +1,65 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.aylien.com/api/v1/summarize
+    body:
+      encoding: US-ASCII
+      string: url=http%3A%2F%2Fwww.bbc.com%2Fsport%2F0%2Ffootball%2F25912393
+    headers:
+      Accept:
+      - ! '*/*'
+      User-Agent:
+      - Aylien Text API Ruby Gem 0.0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      App-Id:
+      - <PASSWORD>
+      App-Key:
+      - <PASSWORD>
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - openresty/1.5.12.1
+      Date:
+      - Tue, 02 Dec 2014 18:16:01 GMT
+      Content-Type:
+      - application/json;charset=UTF-8
+      Content-Length:
+      - '1916'
+      Connection:
+      - keep-alive
+    body:
+      encoding: US-ASCII
+      string: ! "{\n  \"text\": \"Lionel Messi: Forward is not for sale, says Barcelona
+        president\\n\\nBarcelona forward Lionel Messi is not for sale and the club
+        plan to discuss a new contract with the Argentine, says president Josep Maria
+        Bartomeu.\\n\\nFour-time Ballon d'Or winner Messi, 26, is reported to be a\\n\\nIn
+        an interview with radio station RAC1, Bartomeu said: \\\"The club will sit
+        down and negotiate a new contract.\\n\\n\\\"We will do what we have to, to
+        ensure he's the best-paid player.\\\"\\n\\nMessi scored 60 goals in 50 appearances
+        last season but has struggled to match that goalscoring form in 2013-14.\\n\\nHe
+        has scored 18 goals so far but just eight of those have been in the league.\\n\\nHis
+        last league goal came in September, before he was out for five weeks with
+        a hamstring injury.\\n\\n\\\"He can do everything,\\\" said Barca coach Gerardo
+        Martino. \\\"If he succeeds in other facets of his game, it doesn't matter
+        if he scores.\\n\\n\\\"Nothing surprises me with him. He controls the game
+        well, passes the ball well, he is a good finisher, he can press and recover
+        the ball.\\n\\n\\\"He sees passes that most people can only see whilst watching
+        the game on TV or in the stands, not ones that you can normally see on the
+        field.\\\"\",\n  \"sentences\": [\"Lionel Messi: Forward is not for sale,
+        says Barcelona president\\n\\nBarcelona forward Lionel Messi is not for sale
+        and the club plan to discuss a new contract with the Argentine, says president
+        Josep Maria Bartomeu.\", \"Four-time Ballon d'Or winner Messi, 26, is reported
+        to be a\\n\\nIn an interview with radio station RAC1, Bartomeu said: \\\"The
+        club will sit down and negotiate a new contract.\", \"His last league goal
+        came in September, before he was out for five weeks with a hamstring injury.\",
+        \"\\\"If he succeeds in other facets of his game, it doesn't matter if he
+        scores.\", \"He controls the game well, passes the ball well, he is a good
+        finisher, he can press and recover the ball.\"]\n}"
+    http_version: 
+  recorded_at: Tue, 02 Dec 2014 18:14:58 GMT
+recorded_with: VCR 2.9.3

data/spec/lib/aylien_text_api/classify.rb

@@ -0,0 +1,86 @@
+# encoding: utf-8
+
+describe "Classify endpoint" do
+  before do
+    @url = "http://techcrunch.com/2014/10/20/the-super-slim-kindle-voyage-is-a-great-travel-companion/"
+    @text = %q(CCTV footage shows the moment a suicide car bomber detonates
+      a device in Beirut on Tuesday. The incident took place in an area
+      of support for Hezbollah and left four people dead with many more wounded.
+      A group calling itself the al-Nusra Front in Lebanon has claimed
+      responsibility for the attack saying it was in retaliation for
+      Hezbollah's military support of president Bashar al-Assad's forces in Syria)
+  end
+
+  it "shouldn't be nil with valid url" do
+    VCR.use_cassette('classify_with_valid_url') do
+      result = @client.classify(url: @url)
+      result.wont_be_nil
+    end
+  end
+
+  it "shouldn't be nil with text" do
+    VCR.use_cassette('classify_with_text') do
+      result = @client.classify(text: @text)
+      result.wont_be_nil
+    end
+  end
+
+  it "shouldn't be nil with value as valid url" do
+    VCR.use_cassette('classify_with_value_as_valid_url') do
+      result = @client.classify(@url)
+      result.wont_be_nil
+    end
+  end
+
+  it "shouldn't be nil with value as value" do
+    VCR.use_cassette('classify_with_value_as_text') do
+      result = @client.classify(@text)
+      result.wont_be_nil
+    end
+  end
+
+  it "should be nil with invalid params" do
+    VCR.use_cassette('classify_with_invalid_params') do
+      result = @client.classify(wrong_param: @text)
+      result.must_be_nil
+    end
+  end
+
+  it "should be nil with unauthenticated client" do
+    VCR.use_cassette('classify_with_unauthenticated_client') do
+      result = @unauthenticated_client.classify(text: @text)
+      result.must_be_nil
+    end
+  end
+
+  it "should raise Forbidden with unauthenticated client" do
+    VCR.use_cassette('classify_with_unauthenticated_client') do
+      proc {
+        @unauthenticated_client.classify!(text: @text)
+      }.must_raise AylienTextApi::Error::Forbidden
+    end
+  end
+
+  it "should be nil with invalid client" do
+    VCR.use_cassette('classify_with_invalid_client') do
+      result = @invalid_client.classify(text: @text)
+      result.must_be_nil
+    end
+  end
+
+  it "should raise Forbidden with invalid client" do
+    VCR.use_cassette('classify_with_invalid_client') do
+      proc {
+        @invalid_client.classify!(text: @text)
+      }.must_raise AylienTextApi::Error::Forbidden
+    end
+  end
+
+  it "should raise BadRequest with invalid params" do
+    VCR.use_cassette('classify_with_invalid_params') do
+      proc {
+        @client.classify!(wrong_param: @text)
+      }.must_raise AylienTextApi::Error::BadRequest
+    end
+  end
+end

data/spec/lib/aylien_text_api/client_spec.rb

@@ -0,0 +1,23 @@
+require_relative '../../spec_helper'
+
+describe AylienTextApi::Client do
+  before do
+    @client = AylienTextApi::Client.new(
+      app_id: CONFIG["text_api"]["correct_keys"]["app_id"],
+      app_key: CONFIG["text_api"]["correct_keys"]["app_key"])
+    @unauthenticated_client = AylienTextApi::Client.new(
+      app_id: CONFIG["text_api"]["incorrect_keys"]["app_id"],
+      app_key: CONFIG["text_api"]["incorrect_keys"]["app_key"])
+    @invalid_client = AylienTextApi::Client.new(incorrect_param_app_id: CONFIG["text_api"]["app_id"],
+      incorrect_param_app_key: CONFIG["text_api"]["correct_keys"]["app_key"])
+  end
+  require_relative './classify'
+  require_relative './concepts'
+  require_relative './entities'
+  require_relative './extract'
+  require_relative './hashtags'
+  require_relative './language'
+  require_relative './related'
+  require_relative './sentiment'
+  require_relative './summarize'
+end

data/spec/lib/aylien_text_api/concepts.rb

@@ -0,0 +1,81 @@
+describe "Concepts endpoint" do
+  before do
+    @url = "http://www.bbc.co.uk/news/business-25821345"
+    @text = %q(Barack Hussein Obama II is the 44th and current
+      President of the United States, and the first
+      African American to hold the office.)
+  end
+
+  it "shouldn't be nil with valid url" do
+    VCR.use_cassette('concepts_with_valid_url') do
+      result = @client.concepts(url: @url)
+      result.wont_be_nil
+    end
+  end
+
+  it "shouldn't be nil with text" do
+    VCR.use_cassette('concepts_with_text') do
+      result = @client.concepts(text: @text)
+      result.wont_be_nil
+    end
+  end
+
+  it "shouldn't be nil with value as valid url" do
+    VCR.use_cassette('concepts_with_value_as_valid_url') do
+      result = @client.concepts(@url)
+      result.wont_be_nil
+    end
+  end
+
+  it "shouldn't be nil with value as text" do
+    VCR.use_cassette('concepts_with_value_as_text') do
+      result = @client.concepts(@text)
+      result.wont_be_nil
+    end
+  end
+
+  it "should be nil with unauthenticated client" do
+    VCR.use_cassette('concepts_with_unauthenticated_client') do
+      result = @unauthenticated_client.concepts(text: @text)
+      result.must_be_nil
+    end
+  end
+
+  it "should raise Forbidden with unauthenticated client" do
+    VCR.use_cassette('concepts_with_unauthenticated_client') do
+      proc {
+        @unauthenticated_client.concepts!(text: @text)
+      }.must_raise AylienTextApi::Error::Forbidden
+    end
+  end
+
+  it "should be nil with invalid client" do
+    VCR.use_cassette('concepts_with_invalid_client') do
+      result = @invalid_client.concepts(text: @text)
+      result.must_be_nil
+    end
+  end
+
+  it "should raise Forbidden with invalid client" do
+    VCR.use_cassette('concepts_with_invalid_client') do
+      proc {
+        @invalid_client.concepts!(text: @text)
+      }.must_raise AylienTextApi::Error::Forbidden
+    end
+  end
+
+  it "should be nil with invalid params" do
+    VCR.use_cassette('concepts_with_invalid_params') do
+      result = @client.concepts(wrong_param: @text)
+      result.must_be_nil
+    end
+  end
+
+  it "should raise BadRequest with invalid params" do
+    VCR.use_cassette('concepts_with_invalid_params') do
+      proc {
+        @client.concepts!(wrong_param: @text)
+      }.must_raise AylienTextApi::Error::BadRequest
+    end
+  end
+end