podcast_index 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1364632f70ac0a7504a90e90c5b6bd53d978697ecba73dc85bbbcddebe92706e
-  data.tar.gz: d495e5fdce0ce3baedb5ada68f4876f7e906c0dbfee655dc49df0681aad45601
+  metadata.gz: 6401b33a024231d7afb4bea6585557e56c0d2d9d40d078a9f289c9e1d5df5382
+  data.tar.gz: 537b4f2c7df6efbf29595198b8a8edc014204173b900147f19504dcd328ad926
 SHA512:
-  metadata.gz: f3b68defbe2c3640ac0ac63317a4838590304a296dabb786c43ebeb8b3eca4eba2aa90745e5857cc0b916e22c2e025a43dd4f991b0915185261c03b33f445aeb
-  data.tar.gz: dbd7f74e52c4e2f5c40d1ccdfad1bfb498b28d6ce3e14b8c32cb38cd1bc014bf21083ad3db05c0167979974a5c14be8889552fbb94c7bd168b324c327fcad7cf
+  metadata.gz: 69eafb7f3827dc2ae609db437bef45c62010fbd3c4b580925cb4a26ab4b1ca579b6aac3d8c997469c0df772b9b99b6fb985cc0d143e3c736a11f2848f4076144
+  data.tar.gz: 47b8106313bc2d25004358b902a50be8f3536288ecaad330113f0f952e7eb84c20d0b9c943059494a11a3b78b6e977076fe9f33b963c579b7966d22413297bb5

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.4.0] - 2024-01-21
+
+* Add Categories to API (thanks @lbrito1)
+* Add Category domain model
+* Add stats API and domain model
+
 ## [0.3.0] - 2023-09-22
 
 * Add `max` parameter to search requests (thanks @lbrito1)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    podcast_index (0.3.0)
+    podcast_index (0.4.0)
       activesupport (>= 6.0, < 8)
       addressable (~> 2)
 

data/README.md

@@ -38,12 +38,16 @@ This client currently implements the following sections of the API:
 * [Episodes](https://podcastindex-org.github.io/docs-api/#tag--Episodes)
 * [Recent](https://podcastindex-org.github.io/docs-api/#tag--Recent)
 * [Value](https://podcastindex-org.github.io/docs-api/#tag--Value)
+* [Categories](https://podcastindex-org.github.io/docs-api/#tag--Categories)
+* [Stats](https://podcastindex-org.github.io/docs-api/#tag--Stats)
 
 These are exposed through the following domain models:
 * [Episode](lib/podcast_index/episode.rb)
 * [Podcast](lib/podcast_index/podcast.rb)
 * [Soundbite](lib/podcast_index/soundbite.rb)
 * [Value](lib/podcast_index/value.rb)
+* [Category](lib/podcast_index/category.rb)
+* [Stats](lib/podcast_index/stats.rb)
 
 The intent is to follow ActiveRecord conventions as reasonably possible.  Therefore, most of the requests are accessed through the model's `.find_by` and `.where` methods.
 
@@ -93,8 +97,6 @@ soundbite = PodcastIndex::Soundbite.where(recent: true)
 soundbite.first.episode_id # => 15082076307
 ```
 
-
-
 ### Supported Methods
 
 ```ruby
@@ -133,6 +135,13 @@ Soundbite.where(recent: true, max: nil)
 # Value
 Value.find_by(feed_id)
 Value.find_by(feed_url)
+
+# Category
+Category.all
+Category.find(category_id)
+
+# Stats
+Stats.current.feed_count_total # => 4316919
 ```
 
 The attributes of the models mirror the names in the API, but have been translated to "underscore" format to more closely follow Ruby conventions.  For example, the `lastUpdateTime` attribute for a `Podcast` is exposed as `last_update_time`.
@@ -149,6 +158,10 @@ rescue PodcastIndex::Error => e
 end
 ```
 
+## Performance
+
+Be aware that this client currently does not cache responses.  So for example, multiple calls to `Category.find()` or `Stats.current` will make multiple API requests.  This may change in the future.
+
 ## 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.

data/lib/podcast_index/api/categories.rb

@@ -0,0 +1,14 @@
+module PodcastIndex
+  module Api
+    class Categories
+      extend Request
+
+      class << self
+        def list
+          response = get("/categories/list", pretty: false)
+          JSON.parse(response.body)
+        end
+      end
+    end
+  end
+end

data/lib/podcast_index/api/stats.rb

@@ -0,0 +1,14 @@
+module PodcastIndex
+  module Api
+    class Stats
+      extend Request
+
+      class << self
+        def current
+          response = get("/stats/current", pretty: false)
+          JSON.parse(response.body)
+        end
+      end
+    end
+  end
+end

data/lib/podcast_index/category.rb

@@ -0,0 +1,29 @@
+require "ostruct"
+require "delegate"
+
+module PodcastIndex
+  class Category < SimpleDelegator
+    class << self
+      def find(id)
+        category = all.detect { |element| element.id == id }
+        raise PodcastIndex::CategoryNotFound if category.nil?
+
+        category
+      end
+
+      def all
+        response = Api::Categories.list
+        from_response_collection(response)
+      end
+
+    private
+
+      def from_response_collection(response, collection_key = "feeds")
+        response[collection_key].map do |item|
+          category = item.transform_keys(&:underscore)
+          new(JSON.parse(category.to_json, object_class: OpenStruct)) # rubocop:disable Style/OpenStructUse
+        end
+      end
+    end
+  end
+end

data/lib/podcast_index/stats.rb

@@ -0,0 +1,20 @@
+require "ostruct"
+require "delegate"
+
+module PodcastIndex
+  class Stats < SimpleDelegator
+    class << self
+      def current
+        response = Api::Stats.current
+        from_response(response)
+      end
+
+    private
+
+      def from_response(response)
+        value = response["stats"].transform_keys(&:underscore)
+        new(JSON.parse(value.to_json, object_class: OpenStruct)) # rubocop:disable Style/OpenStructUse
+      end
+    end
+  end
+end

data/lib/podcast_index/version.rb

@@ -1,3 +1,3 @@
 module PodcastIndex
-  VERSION = "0.3.0".freeze
+  VERSION = "0.4.0".freeze
 end

data/lib/podcast_index.rb

@@ -4,14 +4,19 @@ require "active_support/core_ext/string/inflections"
 require "json"
 
 require_relative "podcast_index/api/request"
-require_relative "podcast_index/api/podcasts"
+
+require_relative "podcast_index/api/categories"
 require_relative "podcast_index/api/episodes"
-require_relative "podcast_index/api/search"
+require_relative "podcast_index/api/podcasts"
 require_relative "podcast_index/api/recent"
+require_relative "podcast_index/api/search"
+require_relative "podcast_index/api/stats"
 require_relative "podcast_index/api/value"
-require_relative "podcast_index/podcast"
+require_relative "podcast_index/category"
 require_relative "podcast_index/episode"
+require_relative "podcast_index/podcast"
 require_relative "podcast_index/soundbite"
+require_relative "podcast_index/stats"
 require_relative "podcast_index/value"
 
 module PodcastIndex
@@ -21,6 +26,7 @@ module PodcastIndex
 
   class Error < StandardError; end
   class PodcastNotFound < Error; end
+  class CategoryNotFound < Error; end
 
   def self.configure
     self.base_url = "https://api.podcastindex.org/api/1.0".freeze

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: podcast_index
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jason York
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-23 00:00:00.000000000 Z
+date: 2024-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -171,15 +171,19 @@ files:
 - README.md
 - Rakefile
 - lib/podcast_index.rb
+- lib/podcast_index/api/categories.rb
 - lib/podcast_index/api/episodes.rb
 - lib/podcast_index/api/podcasts.rb
 - lib/podcast_index/api/recent.rb
 - lib/podcast_index/api/request.rb
 - lib/podcast_index/api/search.rb
+- lib/podcast_index/api/stats.rb
 - lib/podcast_index/api/value.rb
+- lib/podcast_index/category.rb
 - lib/podcast_index/episode.rb
 - lib/podcast_index/podcast.rb
 - lib/podcast_index/soundbite.rb
+- lib/podcast_index/stats.rb
 - lib/podcast_index/value.rb
 - lib/podcast_index/version.rb
 homepage: https://github.com/jasonyork/podcast-index