songstats-api 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: abef0db83768f11fbe5b7b4065be17b37314ba7ae09838218fb679e1ed6ce609
-  data.tar.gz: e727fe9aa96d85f7cbeca6340453f931c214c3654b0ced5be3ce378f29e4017b
+  metadata.gz: 4435e46748e62f3669e038f19ea0f03205f601de6bec3563b0a5ec909843151b
+  data.tar.gz: 258b58b810715353304066ac1ab2b6d34946eed0d2571d81ebd27d77d2ff540a
 SHA512:
-  metadata.gz: '0058d84c8f6b1af15782760e7d97ecf9e2afbc58735c07c4950902d51abbb470056068016b7a9ec6edf2338635af3eebe150599ae7ece7c7b245d01db365df16'
-  data.tar.gz: 0a8e2720669bd876f5b5572146aef63d9a9e041fbc04e77b4875b09b095aa38502992da63611bec54eaf00e1762cab1cfa3a0786988771d9d7bde329c6da9af2
+  metadata.gz: 457df44f7cdc558acc43684787b70034c1f90576e8e0c1471a69b1f1b1f6b6b7e43cb5527d17c67a42a5db9ba09817bdb7937bad544343b3c0bf3bf421c3535d
+  data.tar.gz: 676eabfa8b92ba961877b68a1a9bbca39c10314cd721681215b7b84eab4f3a7abe25d2e756ca2c89c02a5b44f1caa85cfc38cb2faf0cd54d1dcc30cd1e780783

data/.env.example

@@ -1 +1,2 @@
 SONGSTATS_API_KEY=
+SONGSTATS_CHARTS_API_KEY=

data/.env.test

@@ -1 +1,2 @@
 SONGSTATS_API_KEY=test-1234-5678-9012-3456
+SONGSTATS_CHARTS_API_KEY=test-1234-5678-9012-3456

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    songstats-api (1.3.0)
+    songstats-api (1.4.0)
       httparty
 
 GEM

data/README.md

@@ -26,6 +26,8 @@ Or install it yourself as:
 
 To use this gem ensure that `SONGSTATS_API_KEY` is set as an env variarble.
 
+To use `Songstats:Api::Charts` ensure `SONGSTATS_CHARTS_API_KEY` is set as an env variable. This is billed differently than other endpoints so it needs its own api key.
+
 This is a wrapper around Song Stats API - [you can find their docs here](https://docs.songstats.com/docs/api/e80265bb8b01b-songstats-api).
 
 

data/lib/songstats/api/base.rb

@@ -16,7 +16,7 @@ module Songstats
       def initialize
         @api_key = ENV.fetch "SONGSTATS_API_KEY", nil
 
-        raise "Missing SongStats API key" if @api_key.nil?
+        raise Songstats::Api::Error, "Missing SongStats API key" if @api_key.nil?
       end
 
       private
@@ -54,21 +54,21 @@ module Songstats
         response = self.class.get path, headers: { "apiKey" => @api_key }
         return response.parsed_response if response.success?
 
-        raise response.parsed_response
+        raise Songstats::Api::Error, response.parsed_response
       end
 
       def post(path, body)
         response = self.class.post path, body: body, headers: { "apiKey" => @api_key }
         return response.parsed_response if response.success?
 
-        raise response.parsed_response
+        raise Songstats::Api::Error, response.parsed_response
       end
 
       def delete(path)
         response = self.class.delete path, headers: { "apiKey" => @api_key }
         return response.parsed_response if response.success?
 
-        raise response.parsed_response
+        raise Songstats::Api::Error, response.parsed_response
       end
     end
   end

data/lib/songstats/api/chart.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "httparty"
+
+module Songstats
+  module Api
+    # Chart class for the Songstats API
+    class Chart < Base
+      include HTTParty
+
+      base_uri "https://api.songstats.com/enterprise/v1"
+
+      def initialize
+        @api_key = ENV.fetch "SONGSTATS_CHARTS_API_KEY", nil
+
+        raise Songstats::Api::Error, "Missing SongStats Charts API key" if @api_key.nil?
+      end
+
+      def tracks(options = {})
+        options[:source] = "all" unless options.key? :source
+        options[:country_code] = "US" unless options.key? :country_code
+
+        fetch path("/charts/tracks", options)
+      end
+
+      private
+
+      def path(path, options = {})
+        query_params = options.map { |key, value| "#{key}=#{value}" }.join("&")
+        return "#{path}?#{query_params}" unless query_params.empty?
+
+        path
+      end
+
+      def fetch(path)
+        response = self.class.get path, headers: { "apiKey" => @api_key }
+        return response.parsed_response if response.success?
+
+        raise Songstats::Api::Error, response.parsed_response
+      end
+    end
+  end
+end

data/lib/songstats/api/version.rb

@@ -2,6 +2,6 @@
 
 module Songstats
   module Api
-    VERSION = "1.3.0"
+    VERSION = "1.4.0"
   end
 end

data/lib/songstats/api.rb

@@ -11,5 +11,6 @@ module Songstats
     autoload :Artist, "songstats/api/artist"
     autoload :Track, "songstats/api/track"
     autoload :Label, "songstats/api/label"
+    autoload :Chart, "songstats/api/chart"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: songstats-api
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Daryl Findlay
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-23 00:00:00.000000000 Z
+date: 2024-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -49,6 +49,7 @@ files:
 - lib/songstats/api.rb
 - lib/songstats/api/artist.rb
 - lib/songstats/api/base.rb
+- lib/songstats/api/chart.rb
 - lib/songstats/api/label.rb
 - lib/songstats/api/track.rb
 - lib/songstats/api/version.rb