house.rb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 41dcd54282645a745f5b855f7111a3ddf949fd06
+  data.tar.gz: 4f6855032ffc21bf783bd4408e04ebc688374503
+SHA512:
+  metadata.gz: bb58d8eea06e28b155b1905f5c6cd233674ff3c74dea45ebe35b7db6ad1ebd95a4c84d795d96953850b40c227f8efd15b59a34501a7b3d7f30672e851c3a9814
+  data.tar.gz: 3e688830b4978ce290f94b73c0f00b1f8c2d5c239a2182456e4bb70d7fda942f04789a789765d9eaaf3aa5a15b6816c979efb64df8985839393732b894ed1fd6

data/.gitignore

@@ -0,0 +1,4 @@
+Gemfile.lock
+html/
+pkg/
+vendor/cache/*.gem

data/.rspec

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

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,190 @@
+                              Apache License
+                         Version 2.0, January 2004
+                      http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+        Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+        stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+        that You distribute, all copyright, patent, trademark, and
+        attribution notices from the Source form of the Work,
+        excluding those notices that do not pertain to any part of
+        the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+        distribution, then any Derivative Works that You distribute must
+        include a readable copy of the attribution notices contained
+        within such NOTICE file, excluding those notices that do not
+        pertain to any part of the Derivative Works, in at least one
+        of the following places: within a NOTICE text file distributed
+        as part of the Derivative Works; within the Source form or
+        documentation, if provided along with the Derivative Works; or,
+        within a display generated by the Derivative Works, if and
+        wherever such third-party notices normally appear. The contents
+        of the NOTICE file are for informational purposes only and
+        do not modify the License. You may add Your own attribution
+        notices within Derivative Works that You distribute, alongside
+        or as an addendum to the NOTICE text from the Work, provided
+        that such additional attribution notices cannot be construed
+        as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ Copyright 2017 Marcelo Boeira
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.

data/README.md

@@ -0,0 +1,74 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/feedcast/house/master/docs/logo.png" width="200">
+  <h1 align="center" style="margin-top: -50px">House</h1>
+  <p align="center">:pill: The Podcast RSS Reader and Diagnostician<p>
+</p>
+
+> :round_pushpin: This is a refactor/fork of [kule/podcast_reader](https://github.com/kule/podcast_reader), thanks [@kule](https://github.com/kule) for the efforts so far!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "house.rb"
+```
+
+And then execute:
+
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install house.rb
+```
+
+## Usage
+
+```ruby
+require "house.rb"
+
+podcast = House::Podcast.new("http://feeds.feedburner.com/developertea")
+
+pocast.title
+pocast.description
+pocast.title
+pocast.description
+pocast.language
+pocast.last_build_date
+pocast.site_link
+
+podcast.image_url
+podcast.image_title
+podcast.image_link
+
+podcast.author
+podcast.subtitle
+podcast.summary
+
+podcast.publish_date
+
+podcast.keywords
+podcast.explicit?
+podcast.download_image_to("./podcast_image.jpg")
+podcast.updated_since(Time.now)
+podcast.items.size
+
+episode = podcast.items.first
+
+episode.title
+episode.description
+episode.category
+episode.author
+episode.subtitle
+episode.summary
+episode.duration
+episode.url
+episode.content_type
+episode.file_size
+
+episodes.download_to("./podcast_track.mp3")
+```

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/house.rb.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "house/version"
+
+Gem::Specification.new do |gem|
+  gem.name          = "house.rb"
+  gem.version       = House::VERSION
+  gem.summary       = %q{The Podcast RSS Reader and Diagnostician}
+  gem.description   = %q{The Podcast RSS Reader and Diagnostician}
+  gem.license       = "Apache-2.0"
+  gem.authors       = ["Marcelo Boeira"]
+  gem.email         = "me@marceloboeira.com"
+  gem.homepage      = "https://github.com/feedcast/house"
+
+  gem.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec|features)/}) }
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "nokogiri", "~> 1"
+  gem.add_dependency "open_uri_redirections", "~> 0"
+
+  gem.add_development_dependency "bundler", "~> 1.0"
+  gem.add_development_dependency "rake", "~> 0.9.2"
+  gem.add_development_dependency "rspec", "~> 2.4"
+  gem.add_development_dependency "sham_rack", "~> 1.3"
+  gem.add_development_dependency "sinatra",  "~> 1"
+  gem.add_development_dependency "byebug", "~> 9"
+end

data/lib/house/episode.rb

@@ -0,0 +1,75 @@
+require "nokogiri"
+require "open-uri"
+
+module House
+  class Episode
+    def initialize(item_node)
+      @item_xml = item_node
+    end
+
+    def title;            item_attr("title");               end
+    def description;      item_attr("description");         end
+    def category;         item_attr("category");            end
+
+    def author;           item_attr("itunes:author");       end
+    def subtitle;         item_attr("itunes:subtitle");     end
+    def summary;          item_attr("itunes:summary");      end
+    def duration;         item_attr("itunes:duration");     end
+
+    def url;              item_attr("enclosure", "url");    end
+    def content_type;     item_attr("enclosure", "size");   end
+    def file_size;        item_attr("enclosure", "length"); end
+
+
+    def keywords
+      item_attr("itunes:keywords").to_s.split(",")
+    end
+
+    def explicit?
+      explicit = item_attr("itunes:explicit")
+      case explicit
+      when "yes" then true
+      when "no"  then false
+      else
+        nil
+      end
+    end
+
+    def block?
+      block = item_attr("itunes:block")
+      case block
+      when "yes" then true
+      when "no"  then false
+      else
+        nil
+      end
+    end
+
+    def publish_date
+      Time.parse(item_attr("pubDate")) if item_attr("pubDate")
+    end
+
+    def download_to(file_path)
+      dir_path = File.dirname(file_path)
+      FileUtils.mkdir_p(dir_path) unless File.exist?(dir_path)
+      File.open(file_path, "w") do |f|
+        f.write open(self.url).read
+      end
+    end
+
+    private
+
+    def item_attr(xpath, attribute = nil)
+      node = @item_xml.xpath(xpath)
+      if node.nil? || node.empty?
+        nil
+      else
+        if attribute.nil?
+          node.text
+        elsif node.attr(attribute)
+          node.attr(attribute).value
+        end
+      end
+    end
+  end
+end

data/lib/house/podcast.rb

@@ -0,0 +1,80 @@
+require "nokogiri"
+require "open-uri"
+require "open_uri_redirections"
+require "house/episode"
+
+module House
+  class Podcast
+    def initialize(url)
+      @url = url
+      @podcast = Nokogiri::XML(open(url, allow_redirections: :all))
+      @items = []
+      raise "The supplied url is not a valid podcast rss" if @podcast.at_xpath("/rss").nil?
+    end
+
+    def title;            attr("/rss/channel/title");           end
+    def description;      attr("/rss/channel/description");     end
+    def language;         attr("/rss/channel/language");        end
+    def last_build_date;  attr("/rss/channel/lastBuildDate");   end
+    def site_link;        attr("/rss/channel/link");            end
+
+    def image_url;        attr("/rss/channel/image/url");       end
+    def image_title;      attr("/rss/channel/image/title");     end
+    def image_link;       attr("/rss/channel/image/link");      end
+
+    def author;           attr("/rss/channel/itunes:author");   end
+    def subtitle;         attr("/rss/channel/itunes:subtitle"); end
+    def summary;          attr("/rss/channel/itunes:summary");  end
+
+    def keywords
+      attr("/rss/channel/itunes:keywords").to_s.split(",")
+    end
+
+    def explicit?
+      explicit = attr("/rss/channel/itunes:explicit")
+      case explicit
+      when "yes" then true
+      when "no"  then false
+      else
+        nil
+      end
+    end
+
+    def publish_date
+      pub_date = attr("/rss/channel/pubDate") || attr("/rss/channel/item[1]/pubDate")
+      Time.parse(pub_date)
+    end
+
+    def items
+      if @items.empty? && @podcast.xpath("/rss/channel/item")
+        @podcast.xpath("/rss/channel/item").each do |node|
+          @items << House::Episode.new(node)
+        end
+      end
+      @items
+    end
+
+    def download_image_to(file_path)
+      dir_path = File.dirname(file_path)
+      FileUtils.mkdir_p(dir_path) unless File.exist?(dir_path)
+      File.open(file_path, "w") do |f|
+        f.write open(self.image_url).read
+      end
+    end
+
+    def updated_since?(time)
+      publish_date > time
+    end
+
+    private
+
+    def attr(xpath)
+      node = @podcast.xpath(xpath)
+      if node.nil? || node.empty?
+        nil
+      else
+        node.text
+      end
+    end
+  end
+end

data/lib/house/version.rb

@@ -0,0 +1,3 @@
+module House
+  VERSION = "0.1.0"
+end

data/lib/house.rb

@@ -0,0 +1,5 @@
+require "house/version"
+require "house/podcast"
+require "house/episode"
+
+module House; end

metadata

@@ -0,0 +1,167 @@
+--- !ruby/object:Gem::Specification
+name: house.rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Marcelo Boeira
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: open_uri_redirections
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: sham_rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9'
+description: The Podcast RSS Reader and Diagnostician
+email: me@marceloboeira.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- docs/logo.png
+- house.rb.gemspec
+- lib/house.rb
+- lib/house/episode.rb
+- lib/house/podcast.rb
+- lib/house/version.rb
+homepage: https://github.com/feedcast/house
+licenses:
+- Apache-2.0
+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: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: The Podcast RSS Reader and Diagnostician
+test_files: []