genius_fixed 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 590e1b590fa8778243a391fc22c2433989b8338df70c8c6cd76a3d3837a3a1f3
+  data.tar.gz: 4c99574b8a7898ed147caa87fadf449d6f1112f473daa4b9b78be684cb10d288
+SHA512:
+  metadata.gz: dd57a105e4689f40e01dbe84555cf00a8f47324e7d26e8959a82f86291a08170b19ea9ebaf3c953dce113a445156ead68e2334a3675dd14ecfbe45b1a01892ec
+  data.tar.gz: b052f957c632b2f408e6aa5823462386b9790e469c53355b684bb1f8208186d8cce7dcb38c32320d0b110731aa0aaaf304357ef04d4da6d5700ecf8bb8660b38

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,56 @@
+# For all options see https://github.com/bbatsov/rubocop/tree/master/config
+
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  RunRailsCops: false
+  Include:
+    - Rakefile
+  Exclude:
+    - .*/**/*
+
+# Limit lines to 80 characters.
+LineLength:
+  Max: 90
+
+ClassLength:
+  Enabled: false
+
+ModuleLength:
+  Enabled: false
+
+# Avoid methods longer than 30 lines of code
+MethodLength:
+  CountComments: false  # count full line comments?
+  Max: 87
+
+# Avoid single-line methods.
+SingleLineMethods:
+  AllowIfMethodIsEmpty: true
+
+StringLiterals:
+  Enabled: false
+
+GlobalVars:
+  Enabled: false # We use them Redis + StatsD (though maybe we shouldn't?)
+
+# Wants underscores in all large numbers. Pain in the ass for things like
+# unix timestamps.
+NumericLiterals:
+  Enabled: false
+
+# Wants you to use the same argument names for every reduce. This seems kinda
+# naff compared to naming them semantically
+SingleLineBlockParams:
+  Enabled: false
+
+Style/SignalException:
+  EnforcedStyle: 'only_raise'
+
+# Use trailing rather than leading dots on multi-line call chains
+Style/DotPosition:
+  EnforcedStyle: trailing
+
+# Allow non-ASCII characters (e.g. £) in comments
+Style/AsciiComments:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,117 @@
+# This configuration was generated by `rubocop --auto-gen-config`
+# on 2015-06-06 22:47:07 +0100 using RuboCop version 0.32.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 50
+# Cop supports --auto-correct.
+Lint/UnusedBlockArgument:
+  Enabled: false
+
+# Offense count: 187
+Metrics/AbcSize:
+  Max: 61
+
+# Offense count: 26
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+# Offense count: 11
+Metrics/PerceivedComplexity:
+  Max: 10
+
+# Offense count: 12
+Style/AccessorMethodName:
+  Enabled: false
+
+# Offense count: 164
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle, SupportedLastArgumentHashStyles.
+Style/AlignHash:
+  Enabled: false
+
+# Offense count: 3
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, ProceduralMethods, FunctionalMethods, IgnoredMethods.
+Style/BlockDelimiters:
+  Enabled: false
+
+# Offense count: 128
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+# Offense count: 21
+# Cop supports --auto-correct.
+Style/ClosingParenthesisIndentation:
+  Enabled: false
+
+# Offense count: 13
+# Cop supports --auto-correct.
+# Configuration parameters: Keywords.
+Style/CommentAnnotation:
+  Enabled: false
+
+# Offense count: 743
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 9
+Style/DoubleNegation:
+  Enabled: false
+
+# Offense count: 109
+# Configuration parameters: MinBodyLength.
+Style/GuardClause:
+  Enabled: false
+
+# Offense count: 48
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/IndentHash:
+  Enabled: false
+
+# Offense count: 70
+# Cop supports --auto-correct.
+Style/Lambda:
+  Enabled: false
+
+# Offense count: 577
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/MultilineOperationIndentation:
+  Enabled: false
+
+# Offense count: 21
+# Configuration parameters: NamePrefix, NamePrefixBlacklist.
+Style/PredicateName:
+  Enabled: false
+
+# Offense count: 4
+# Cop supports --auto-correct.
+Style/Proc:
+  Enabled: false
+
+# Offense count: 173
+# Cop supports --auto-correct.
+Style/RedundantSelf:
+  Enabled: false
+
+# Offense count: 28
+# Cop supports --auto-correct.
+Style/SingleSpaceBeforeFirstArg:
+  Enabled: false
+
+# Offense count: 3
+# Cop supports --auto-correct.
+# Configuration parameters: MultiSpaceAllowedForOperators.
+Style/SpaceAroundOperators:
+  Enabled: false
+
+# Offense count: 5
+# Cop supports --auto-correct.
+# Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, Whitelist.
+Style/TrivialAccessors:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.2.0
+  - 2.0.0
+before_install: gem install bundler -v 1.10.4
+script:
+  - bundle exec rubocop

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+## 0.1.1 (3rd July 2015)
+
+* Support for new Annotations APIs
+
+## 0.1.0 (26th June 2015)
+
+* Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+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. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tim Rogers
+
+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,153 @@
+# Genius
+
+[![Build Status](https://travis-ci.org/timrogers/genius.svg)](https://travis-ci.org/timrogers/genius)
+[![Gem Version](https://badge.fury.io/rb/genius.svg)](http://badge.fury.io/rb/genius)
+
+![Genius logo](http://assets.rapgenius.com/images/apple-touch-icon.png?1432674944)
+
+## What does this do?
+
+It's a Ruby gem for accessing songs, artists and annotations on
+[Genius](http://genius.com), based on the original [rapgenius](https://github.com/timrogers/rapgenius) gem.
+
+## Installation
+
+Install the gem, and you're ready to go. Simply add the following to your Gemfile:
+
+```ruby
+gem "genius", "~> 0.1.1"
+```
+
+## Usage
+
+The best way to get a decent idea of the attributes available on `Song` and
+the other objects is by checking out the API documentation at:
+https://docs.genius.com
+
+### Authentication
+
+You'll need to set your access token before using the library. You can create a client and grab an access token from
+<http://genius.com/api-clients>. You can then use that like so:
+
+``` ruby
+Genius.access_token = 'your-access-token'
+```
+
+At the moment, this library isn't set up for a traditional multi-user OAuth setup - despite the Genius API being [based](https://docs.genius.com/#/authentication-h1) on OAuth. It's built for the use case of just accessing the API with your account. This may change in future.
+
+### Configuration
+
+The library has one configuration option letting you choose between response formats between `plain`, `html` and `dom` - this is the [`text_format` option in the API](https://docs.genius.com/#/response-format-h1).
+
+It'll default to `plain`, meaning you'll get back plain texts from API fields which return rich resources (artists' descriptions or annotations' contents). You can change this like so:
+
+```ruby
+Genius.text_format = "html"
+```
+
+### Songs
+
+You can find a song by name, or using it's unique ID.
+
+To find a song by name, use `Genius::Song.search` like this:
+
+```ruby
+songs = Genius::Song.search("The Hills") # Returns an array of Song objects
+the_hills = songs.first
+the_hills.title # => "The Hills"
+the_hills.primary_artist.name # => "The Weeknd"
+```
+
+Alternatively, you can find a song by it's unique ID. They're not especially easy to find, but if you hover over the "PYONG!" button near the top of the page, you'll see the song's ID in the URL. Once you have an ID, you can load a song via the API:
+
+```ruby
+song = Genius::Song.find(176872)
+song.title # => "Versace"
+song.primary_artist.name # => "Migos"
+```
+
+Once you've found the song you're looking for, there are plenty of other useful details you can access:
+
+```ruby
+song.title
+# => "Versace"
+
+song.url
+# => "http://genius.com/Migos-versace-lyrics"
+
+song.pyongs_count
+# => 198
+
+song.description
+# => "Released in June 2013, not only did they take the beat from Soulja Boy’s OMG part 2 but they absolutely killed it."
+```
+
+Check out [song.rb](https://github.com/timrogers/genius/blob/master/lib/genius/song.rb) or the [Genius API documentation](https://docs.genius.com/#songs-h2) for a full list of available fields.
+
+### Artist
+
+You can find artists from their songs (e.g. `Song#primary_artist`) and a couple of other places, or you can find them by their ID. As with songs, artists' IDs are pretty tricky to find, but you can get them by hovering over the "Follow" button on an artist's page on the Genius site.
+
+```ruby
+the_hills = Genius::Song.find(727466)
+the_weeknd = the_hills.primary_artist
+
+# or...
+
+the_weeknd = Genius::Artist.find(2358)
+```
+
+Once you've found the artist you're looking for, you can then query its attributes:
+
+```ruby
+artist.name
+# => "The Weeknd"
+
+artist.description
+# => "Abel Tesfaye (otherwise known as The Weeknd)..."
+
+# You can even find the artist's songs with the #songs method
+artist.songs # => [<Genius::Song...]
+```
+
+Check out [artist.rb](https://github.com/timrogers/genius/blob/master/lib/genius/artist.rb) or the [Genius API documentation](https://docs.genius.com/#artists-h2) for a full list of available fields.
+
+### Account
+
+You can access your user profile with the `Genius::Account.me` method:
+
+```ruby
+me = Genius::Account.me
+```
+
+From there, you can get access to a range of attributes:
+
+```ruby
+me.name
+# => "timrogers"
+
+me.iq
+# => 1691
+```
+
+Check out [account.rb](https://github.com/timrogers/genius/blob/master/lib/genius/account.rb) or the [Genius API documentation](https://docs.genius.com/#account-h2) for a full list of available fields.
+
+### Other resources
+
+The API library also supports working with web pages, annotations and referents in the API. See the [Genius API documentation](https://docs.genius.com/#account-h2) and the library [source](https://github.com/timrogers/genius/tree/master/lib/genius).
+
+## Contributing
+
+If you'd like to contribute anything else, go ahead or better still, make an issue and we can talk it over and spec it out! A few quick tips:
+
+* Don't update the version numbers before your pull request - I'll sort that part out for you.
+* Make sure you write specs, then run them with `$ bundle exec rake`. When running tests, you'll want to set `GENIUS_ACCESS_TOKEN` so your requests can be authenticated - don't worry, your token will be filtered out of the `vcr` cassettes.
+* Update this README.md file so I, and users, know how your changes work
+
+## Copyright
+
+Copyright (c) 2015 Tim Rogers. See LICENSE for details.
+
+## Get in touch
+
+Any questions, thoughts or comments? Email me at <me@timrogers.co.uk> or create an issue.

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 "genius"
+
+# 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

data/bin/setup

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

data/genius.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'genius/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "genius_fixed"
+  spec.version       = Genius::VERSION
+  spec.authors       = ["Tim Rogers"]
+  spec.email         = ["tim@gocardless.com"]
+
+  spec.summary       = %q{A Ruby client for the Genius API (<http://genius.com/developers>).}
+  spec.description   = %q{A Ruby client for the Genius API (<http://genius.com/developers>). [Forked version, from https://github.com/Homologist/genius.git — none of the credit goes to me (jltml)!]}
+  spec.homepage      = "https://github.com/Homologist/genius"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler",   ">= 1.10"
+  spec.add_development_dependency "rake",      "~> 10.0"
+  spec.add_development_dependency "rspec",     "~> 3.3.0"
+  spec.add_development_dependency "rspec-its", "~> 1.1.0"
+  spec.add_development_dependency "mocha",     "~> 0.14.0"
+  spec.add_development_dependency "webmock",   "~> 1.11.0"
+  spec.add_development_dependency "vcr",       "~> 2.5.0"
+  spec.add_development_dependency "rubocop",   "~> 0.31.0"
+
+  spec.add_runtime_dependency     "httparty",  ">= 0.14.0"
+end

data/lib/genius.rb

@@ -0,0 +1,22 @@
+require "genius/version"
+require "genius/errors"
+require "genius/resource"
+require "genius/artist"
+require "genius/song"
+require "genius/web_page"
+require "genius/account"
+require "genius/annotation"
+require "genius/referent"
+
+module Genius
+  class << self
+    attr_accessor :access_token
+    attr_writer   :text_format
+
+    PLAIN_TEXT_FORMAT = "plain".freeze
+
+    def text_format
+      @text_format || PLAIN_TEXT_FORMAT
+    end
+  end
+end

data/lib/genius/account.rb

@@ -0,0 +1,42 @@
+module Genius
+  class Account < Resource
+    resource_name "user"
+
+    attr_reader :unread_messages_count, :artist, :role_for_display, :iq,
+                :unread_main_activity_inbox_count, :avatar, :about_me,
+                :tracking_paths, :id, :current_user_metadata, :login, :name
+
+    def parse_resource!
+      @unread_messages_count = resource["unread_messages_count"]
+      @artist = resource["artist"]
+      @role_for_display = resource["role_for_display"]
+      @unread_main_activity_inbox_count = resource["unread_main_activity_inbox_count"]
+      @avatar = resource["avatar"]
+      @about_me = formatted_attribute("about_me")
+      @identities = resource["identities"]
+      @name = resource["name"]
+      @tracking_paths = resource["tracking_paths"]
+      @id = resource["id"]
+      @current_user_metadata = resource["current_user_metadata"]
+      @iq = resource["iq"]
+      @login = resource["login"]
+    end
+
+    def reload
+      raise NotReloadableError, "An Account cannot be reloaded"
+    end
+
+    def self.find(*)
+      raise NotImplementedError, "An Account cannot be loaded by its ID in the public API"
+    end
+
+    def self.me(params = {})
+      headers = default_headers.merge(params.delete(:headers) || {})
+      params = default_params.merge(params)
+
+      new(http_get("/account", query: params,
+                               headers: headers),
+          text_format: params[:text_format])
+    end
+  end
+end

data/lib/genius/annotation.rb

@@ -0,0 +1,58 @@
+module Genius
+  class Annotation < Resource
+    attr_reader :verified_by, :share_url, :body, :votes_total, :comment_count,
+                :state, :authors, :current_user_metadata, :id, :url
+
+    def parse_resource!
+      @verified_by = Account.from_hash(resource["verified_by"])
+      @share_url = resource["share_url"]
+      @body = formatted_attribute("body")
+      @votes_total = resource["votes_total"]
+      @comment_count = resource["comment_count"]
+      @authors = resource["authors"]
+      @state = resource["state"]
+      @current_user_metadata = resource["current_user_metadata"]
+      @id = resource["id"]
+      @url = resource["url"]
+    end
+
+    def update!(body = {})
+      response = self.class.http_put("/annotations/#{id}",
+                                     body: body,
+                                     headers: self.class.default_headers)
+
+      self.class.new(response, text_format: text_format)
+    end
+
+    def destroy!
+      self.class.http_delete("/annotations/#{id}", headers: self.class.default_headers)
+
+      true
+    end
+
+    def upvote!
+      self.class.http_put("/annotations/#{id}/upvote",
+                          headers: self.class.default_headers)
+
+      true
+    end
+
+    def unvote!
+      self.class.http_put("/annotations/#{id}/unvote",
+                          headers: self.class.default_headers)
+
+      true
+    end
+
+    def downvote!
+      self.class.http_put("/annotations/#{id}/downvote",
+                          headers: self.class.default_headers)
+
+      true
+    end
+
+    def self.create!(body = {})
+      new(http_post("/annotations", body: body, headers: default_headers))
+    end
+  end
+end

data/lib/genius/artist.rb

@@ -0,0 +1,27 @@
+module Genius
+  class Artist < Resource
+    attr_reader :name, :image_url, :id, :url, :user, :tracking_paths, :description
+
+    def parse_resource!
+      @id = resource["id"]
+      @name = resource["name"]
+      @image_url = resource["image_url"]
+      @url = resource["url"]
+      @user = Account.from_hash(resource["user"])
+      @description = formatted_attribute("description")
+      @tracking_paths = resource["tracking_paths"]
+    end
+
+    def songs(params: {}, headers: {})
+      headers = self.class.default_headers.merge(headers)
+      params = self.class.default_params.merge(id: id).merge(params)
+
+      response = self.class.http_get("/#{resource_name}s/#{id}/songs", query: params,
+                                                                       headers: headers)
+
+      response.parsed_response["response"]["songs"].map do |song|
+        Song.from_hash(song, text_format: text_format)
+      end
+    end
+  end
+end

data/lib/genius/errors.rb

@@ -0,0 +1,7 @@
+module Genius
+  class Error < StandardError; end
+  class NotFoundError < Error; end
+  class AuthenticationError < Error; end
+  class MissingAccessTokenError < Error; end
+  class NotReloadableError < Error; end
+end

data/lib/genius/referent.rb

@@ -0,0 +1,46 @@
+module Genius
+  class Referent < Resource
+    attr_reader :id, :url, :song_id, :annotator_id, :fragment, :range, :classification,
+                :annotatable, :annotations
+
+    def self.find(*)
+      raise NotImplementedError, "A Referent cannot be loaded by its ID in the public API"
+    end
+
+    def self.where(params = {})
+      headers = default_headers.merge(params.delete(:headers) || {})
+      params = default_params.merge(params)
+
+      response = http_get("/#{resource_name}s/", query: params, headers: headers)
+
+      response.parsed_response["response"]["referents"].map do |referent|
+        self.from_hash(referent, text_format: params[:text_format])
+      end
+    end
+
+    def reload
+      raise NotReloadableError, "A Referent cannot be reloaded"
+    end
+
+    def parse_resource!
+      @url = resource["url"]
+
+      @annotations = resource["annotations"].map do |annotation|
+        Annotation.from_hash(annotation)
+      end
+
+      @song_id = resource["song_id"]
+      @annotator_id = resource["annotator_id"]
+      @fragment = resource["fragment"]
+      @range = resource["range"]
+      @classification = resource["classification"]
+      @annotatable = resource["annotatable"]
+      @id = resource["id"]
+    end
+
+    def song
+      return nil unless song_id
+      Song.find(song_id)
+    end
+  end
+end

data/lib/genius/resource.rb

@@ -0,0 +1,100 @@
+require 'httparty'
+
+module Genius
+  class Resource
+    include HTTParty
+
+    base_uri 'https://api.genius.com'
+    format   :json
+
+    attr_reader :raw_response, :resource
+
+    def self.resource_name(resource_name = nil)
+      @resource_name = resource_name if resource_name
+      @resource_name || name.downcase.split("::").last
+    end
+
+    def self.find(id, params: {}, headers: {})
+      params = default_params.merge(params)
+      headers = default_headers.merge(headers)
+
+      new(http_get("/#{resource_name}s/#{id}",
+                   query: params,
+                   headers: headers),
+          text_format: params[:text_format])
+    end
+
+    def reload
+      self.class.find(id, params: { text_format: text_format })
+    end
+
+    def self.http_get(path, query: {}, headers: {})
+      response = get(path, query: query, headers: headers)
+      handle_response(response)
+    end
+
+    def self.http_post(path, body: {}, headers: {})
+      response = post(path, body: body, headers: headers)
+      handle_response(response)
+    end
+
+    def self.http_put(path, body: {}, headers: {})
+      response = put(path, body: body, headers: headers)
+      handle_response(response)
+    end
+
+    def self.http_delete(path, headers: {})
+      response = delete(path, headers: headers)
+      handle_response(response)
+    end
+
+    def self.handle_response(response)
+      case response.code
+      when 404 then raise NotFoundError
+      when 401, 403 then raise AuthenticationError
+      else response
+      end
+    end
+
+    def self.default_params
+      {
+        text_format: Genius.text_format
+      }
+    end
+
+    def self.default_headers
+      {
+        'Authorization' => "Bearer #{Genius.access_token}",
+        'User-Agent' => "genius.rb v#{Genius::VERSION}"
+      }
+    end
+
+    def initialize(response, text_format: Genius.text_format, resource: nil)
+      @raw_response = response
+      @resource = resource || response.parsed_response["response"][resource_name]
+      @text_format = text_format
+
+      parse_resource!
+    end
+
+    def self.from_hash(attributes, text_format: Genius.text_format)
+      return nil unless attributes
+      new(nil, text_format: text_format, resource: attributes)
+    end
+
+    private
+
+    attr_reader :text_format
+
+    def resource_name
+      self.class.resource_name
+    end
+
+    # Fetches an attribute that uses the API's Text Formatting feature, which means that
+    # the attribute will be nested inside a key naming the format (plain/html/dom)
+    def formatted_attribute(attribute)
+      return nil unless resource[attribute]
+      resource[attribute][text_format]
+    end
+  end
+end

data/lib/genius/song.rb

@@ -0,0 +1,67 @@
+module Genius
+  class Song < Resource
+    attr_reader :id, :url, :title, :media, :description_annotation, :annotation_count,
+                :tracking_paths, :description, :bop_url, :header_image_url,
+                :updated_by_human_at, :lyrics_updated_at, :pyongs_count, :stats,
+                :current_user_metadata, :verified_annotations_by
+
+    def self.search(query, params: {}, headers: {})
+      headers = default_headers.merge(headers)
+      params = default_params.merge(q: query).merge(params)
+
+      response = http_get("/search", query: params, headers: headers)
+
+      response["response"]["hits"].map do |hit|
+        self.from_hash(hit["result"], text_format: params[:text_format])
+      end
+    end
+
+    def parse_resource!
+      @id = resource["id"]
+      @url = resource["url"]
+      @title = resource["title"]
+      @media = resource["media"]
+      @description_annotation = resource["description_annotation"]
+      @annotation_count = resource["annotation_count"]
+      @tracking_paths = resource["tracking_paths"]
+      @description = formatted_attribute("description")
+      @bop_url = resource["bop_url"]
+      @header_image_url = resource["header_image_url"]
+
+      if resource["updated_by_human_at"]
+        @updated_by_human_at = Time.at(resource["updated_by_human_at"])
+      end
+
+      if resource["lyrics_updated_at"]
+        @lyrics_updated_at = Time.at(resource["lyrics_updated_at"])
+      end
+
+      @pyongs_count = resource["pyongs_count"]
+      @stats = resource["stats"]
+      @current_user_metadata = resource["current_user_metadata"]
+      @verified_annotations_by = resource["verified_annotations_by"]
+    end
+
+    def featured_artists
+      @featured_artists ||= resource["featured_artists"].map do |artist|
+        Artist.from_hash(artist)
+      end
+    end
+
+    def producer_artists
+      @featured_artists ||= resource["producer_artists"].map do |artist|
+        Artist.from_hash(artist)
+      end
+    end
+
+    def writer_artists
+      @featured_artists ||= resource["writer_artists"].map do |artist|
+        Artist.from_hash(artist)
+      end
+    end
+
+    def primary_artist
+      @primary_artist ||= Artist.from_hash(resource["primary_artist"])
+    end
+  end
+end

data/lib/genius/version.rb

@@ -0,0 +1,3 @@
+module Genius
+  VERSION = "0.1.2"
+end

data/lib/genius/web_page.rb

@@ -0,0 +1,35 @@
+module Genius
+  class WebPage < Resource
+    resource_name "web_page"
+
+    attr_reader :id, :url, :title, :normalized_url, :domain, :share_url, :annotation_count
+
+    def parse_resource!
+      @id = resource["id"]
+      @url = resource["url"]
+      @title = resource["title"]
+      @normalized_url = resource["normalized_url"]
+      @domain = resource["domain"]
+      @share_url = resource["share_url"]
+      @annotation_count = resource["annotation_count"]
+    end
+
+    def self.find(*)
+      raise NotImplementedError, "A Web Page cannot be loaded by its ID in the public API"
+    end
+
+    def reload
+      raise NotReloadableError, "A Web Page cannot be reloaded"
+    end
+
+    def self.lookup(params = {})
+      headers = default_headers.merge(params.delete(:headers) || {})
+      params = default_params.merge(params)
+
+      new(http_get("/#{resource_name}s/lookup",
+                   query: params,
+                   headers: headers),
+          text_format: params[:text_format])
+    end
+  end
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: genius_fixed
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Tim Rogers
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-06-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !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.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.31.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.31.0
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+description: A Ruby client for the Genius API (<http://genius.com/developers>). [Forked
+  version, from https://github.com/Homologist/genius.git — none of the credit goes
+  to me (jltml)!]
+email:
+- tim@gocardless.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- genius.gemspec
+- lib/genius.rb
+- lib/genius/account.rb
+- lib/genius/annotation.rb
+- lib/genius/artist.rb
+- lib/genius/errors.rb
+- lib/genius/referent.rb
+- lib/genius/resource.rb
+- lib/genius/song.rb
+- lib/genius/version.rb
+- lib/genius/web_page.rb
+homepage: https://github.com/Homologist/genius
+licenses:
+- MIT
+metadata: {}
+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: []
+rubygems_version: 3.2.17
+signing_key:
+specification_version: 4
+summary: A Ruby client for the Genius API (<http://genius.com/developers>).
+test_files: []