podcast_finder 0.1.14

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 99be2bb4a670ee66d6067cde58d75b45ed7edcd6
+  data.tar.gz: b3d6e25fcbaad3781761a703a7c866edcdec5aac
+SHA512:
+  metadata.gz: b080f2533785256cfb497f5ab1e28299cfebad74298c18a3ea6d9af3e14e792ff4ea43063fd1ec749350f3ec4155824522ff139eec0ac553ecb5586e1c308796
+  data.tar.gz: a085a82fc54f3afa698a53682d5cf906aa8bcbb0c954ee3e81f82878590575fd7212f5138aa8660194ba2bf6beaabbc1936ba188c04a7657f426c589527a4cbf

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.12.5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, 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, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or 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, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at elyse.klova@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in podcast_finder.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Elyse Klova
+
+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,38 @@
+# PodcastFinder
+
+Podcast Finder is a CLI gem that displays ongoing podcasts by NPR and NPR-affiliated stations. Browse by category, view podcast descriptions and episodes, and get links to listen online.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'podcast_finder'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install podcast_finder
+
+## Usage
+
+Run using the command 'podcast_finder', then follow the command-line prompts to browse podcasts by category, view descriptions and recent episode lists, and get links to download and listen.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/podcast_finder. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

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

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "podcast_finder"
+
+# 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/podcast_finder

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/podcast_finder'
+
+PodcastFinder::CLI.new.call

data/bin/setup

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

data/lib/podcast_finder.rb

@@ -0,0 +1,13 @@
+require_relative 'podcast_finder/version'
+require 'date'
+require 'open-uri'
+require 'nokogiri'
+require 'colorize'
+
+require_relative 'podcast_finder/category'
+require_relative 'podcast_finder/commandline'
+require_relative 'podcast_finder/episode'
+require_relative 'podcast_finder/importer'
+require_relative 'podcast_finder/podcast'
+require_relative 'podcast_finder/scraper'
+require_relative 'podcast_finder/station'

data/lib/podcast_finder/category.rb

@@ -0,0 +1,52 @@
+class PodcastFinder::Category
+
+  attr_accessor :name, :url, :podcasts
+
+  @@all = []
+
+  def initialize(category_hash)
+    category_hash.each {|key, value| self.send("#{key}=", value)}
+    @podcasts = []
+    self.save
+  end
+
+  def save
+    @@all << self
+  end
+
+  def self.all
+    @@all
+  end
+
+  def add_podcast(podcast)
+    self.podcasts << podcast
+    podcast.add_category(self)
+  end
+
+  def self.create_from_collection(category_array)
+    category_array.each {|category_hash| self.new(category_hash)}
+  end
+
+  def self.list_categories
+    self.all.each_with_index do |category, index|
+      puts "(#{index + 1}) #{category.name}"
+    end
+  end
+
+  def list_podcasts(number)
+    counter = 1 + number
+    podcast_list_count = 0
+    until counter > (number + 10) do
+      if counter <= self.podcasts.size
+        podcast = self.podcasts[counter - 1]
+        puts "(#{counter}) #{podcast.name}"
+        counter += 1
+        podcast_list_count += 1
+      else
+        counter += 10
+      end
+    end
+    podcast_list_count
+  end
+
+end

data/lib/podcast_finder/commandline.rb

@@ -0,0 +1,334 @@
+class PodcastFinder::CLI
+
+  attr_accessor :quit, :podcast_counter, :category_choice, :input, :podcast_choice, :episode_choice
+
+  def initialize(quit = "NO")
+    @quit = quit
+  end
+
+  def call
+    self.startup_sequence
+    until @quit == "YES"
+      self.browse_all_categories
+    end
+    puts "Thanks for using the Command Line Podcast Finder!"
+  end
+
+  #methods needed for startup
+
+  def startup_sequence
+    puts "Setting up your command line podcast finder...".colorize(:light_red)
+    self.start_import
+    sleep(0.5)
+    puts ".".colorize(:light_red)
+    sleep(0.5)
+    puts ".".colorize(:light_yellow)
+    sleep(0.5)
+    puts ".".colorize(:light_green)
+    sleep(0.5)
+    puts "Setup complete.".colorize(:light_green)
+    sleep(0.5)
+    puts ""
+    puts "Welcome to the Command Line Podcast Finder!"
+    puts "You can use this command line gem to find and listen to interesting podcasts produced by NPR and affiliated stations."
+    sleep(0.5)
+  end
+
+  def start_import
+    PodcastFinder::DataImporter.import_categories('http://www.npr.org/podcasts')
+  end
+
+  #basic menu display methods
+
+  def help
+    puts ""
+    puts "Help: Commands".colorize(:light_blue)
+    puts "--To access any numbered menu, simply type the number of the item you're selecting and press Enter to confirm."
+    puts "  Example Menu: All Categories"
+    puts "   (1) Arts"
+    puts "   (2) Business"
+    puts "   (3) Comedy"
+    puts "  For example: if you want to view the Comedy category, just type '3' (without the quotes) and press Enter"
+    puts "--Type 'exit' at any time to quit the browser"
+    puts "--Type 'menu' at any time to go back to the main category menu"
+    puts "--Type 'help' if you need a quick reminder about the commands"
+    puts "To proceed, enter a command from above or type 'back' to return to what you were doing".colorize(:light_blue)
+    self.choose_after_help
+  end
+
+  def choose_after_help
+    self.get_input
+    if @input == "MENU" || @input == "EXIT" || @input == "HELP" || @input == "BACK"
+      self.proceed_based_on_input
+    else
+      puts "Sorry, that's not an option. Please type a command from the help menu or type 'back' to return to what you were doing".colorize(:light_blue)
+      self.choose_after_help
+    end
+  end
+
+  #methods for gets-ing, parsing and acting based on user input
+
+  def get_input
+    input = gets.strip
+    self.parse_input(input)
+  end
+
+  def parse_input(input)
+    if input.match(/^\d+$/)
+      @input = input.to_i
+    elsif input.upcase == "HELP" || input.upcase == "MENU" || input.upcase == "EXIT" || input.upcase == "MORE" || input.upcase == "BACK" || input.upcase == "PODCASTS"
+      @input = input.upcase
+    else
+      @input = "STUCK"
+    end
+  end
+
+  def proceed_based_on_input
+    case @input
+    when "STUCK"
+      puts "Sorry, that's not an option. Please type a command from the options above. Stuck? Type 'help'.".colorize(:light_blue)
+    when "HELP"
+      self.help
+    when "MENU"
+      self.browse_all_categories
+    when "EXIT"
+      @quit = "YES"
+    when @input == "BACK" || @input == "MORE" || @input == "PODCASTS"
+      @input
+    when @input == Fixnum && @input >= 1
+      @input
+    end
+  end
+
+#methods for browsing categories and viewing podcasts
+
+  def browse_all_categories
+    @podcast_counter = 0
+    puts ""
+    puts "Main Menu: All Categories".colorize(:light_blue)
+    PodcastFinder::Category.list_categories
+    puts ""
+    puts "To get started, choose a category above (1-#{PodcastFinder::Category.all.size}) or type 'help' to see a list of commands.".colorize(:light_blue)
+    puts "You can also type 'exit' at any point to quit.".colorize(:light_blue)
+    self.choose_category
+  end
+
+  def choose_category
+    self.get_input
+    if @input.class == Fixnum && @input.between?(1, 16)
+      @category_choice = PodcastFinder::Category.all[@input - 1]
+      puts "Loading podcasts from #{@category_choice.name}, please wait..."
+      PodcastFinder::DataImporter.import_podcast_data(@category_choice)
+      self.browse_category
+    else
+      if @input.class == Fixnum && !@input.between?(1,16)
+        puts "Sorry, that's not a category. Please enter a number between 1 and 16"
+        self.choose_category
+      else
+        @input = "STUCK" unless @input == "EXIT" || @input == "HELP" || @input == "BACK"
+        if @input == "BACK"
+          @input = "MENU"
+        elsif @input == "HELP"
+          self.proceed_based_on_input
+          if @input == "BACK"
+            self.browse_all_categories
+          end
+        end
+        self.proceed_based_on_input
+        self.choose_category unless @quit == "YES"
+      end
+    end
+  end
+
+  def browse_category
+    puts ""
+    puts "Category: #{@category_choice.name}".colorize(:light_blue)
+    self.display_podcasts
+    self.choose_podcast
+  end
+
+  def display_podcasts
+    @listed_podcasts = @category_choice.list_podcasts(@podcast_counter)
+    if @listed_podcasts == 10 && @category_choice.podcasts.size > @podcast_counter + @listed_podcasts
+      puts ""
+      puts "Enter the number of the podcast you'd like to check out (1-#{@podcast_counter + @listed_podcasts})".colorize(:light_blue)
+      puts "Type 'menu' to return to the category list".colorize(:light_blue)
+      puts "Type 'more' to see the next 10 podcasts".colorize(:light_blue)
+    else
+      puts ""
+      puts "That's all the podcasts for this category!".colorize(:light_blue)
+      puts "Enter the number of the podcast you'd like to check out (1-#{@podcast_counter + @listed_podcasts})".colorize(:light_blue)
+      puts "Type 'menu' to return to the category list".colorize(:light_blue)
+    end
+  end
+
+  def choose_podcast
+    self.get_input
+    if @input.class == Fixnum && @input.between?(1, @podcast_counter + @listed_podcasts)
+      @podcast_choice = @category_choice.podcasts[@input - 1]
+      self.display_podcast_info
+    elsif @input.class == Fixnum && !@input.between?(1, @podcast_counter + @listed_podcasts)
+      puts "Sorry, that's not an option. Please choose a number that corresponds to a podcast.".colorize(:light_blue)
+      self.choose_podcast
+    elsif @input == "MENU"
+      @category_choice = nil
+      self.proceed_based_on_input
+    elsif @input == "MORE"
+      @podcast_counter += 10
+      self.browse_category
+    else
+      @input = "STUCK" unless @input == "EXIT" || @input == "HELP" || @input == "BACK"
+      if @input == "BACK"
+        @input = "MENU"
+      elsif @input == "HELP"
+        self.proceed_based_on_input
+        if @input == "BACK"
+          self.browse_category
+        end
+      end
+      self.proceed_based_on_input
+      self.choose_podcast unless @quit == "YES"
+    end
+  end
+
+#methods for getting details on a specific podcast
+  def display_podcast_info
+    puts "Loading details for #{@podcast_choice.name}..."
+    PodcastFinder::DataImporter.import_description(@podcast_choice)
+    puts ""
+    @podcast_choice.list_data
+    puts ""
+    puts "Choose an option below to proceed:".colorize(:light_blue)
+    puts "Type 'more' to get episode list".colorize(:light_blue)
+    puts "Type 'back' to return to podcast listing for #{@category_choice.name}".colorize(:light_blue)
+    puts "Type 'menu' to return to main category menu".colorize(:light_blue)
+    self.choose_podcast_action
+  end
+
+  def choose_podcast_action
+    self.get_input
+    if @input == "MORE"
+      self.display_episode_list
+    elsif @input == "BACK"
+      @podcast_counter = 0
+      self.browse_category
+    elsif @input == "MENU"
+      self.proceed_based_on_input
+    else
+      @input = "STUCK" unless @input == "EXIT" || @input == "HELP"
+      if @input == "HELP"
+        self.proceed_based_on_input
+        if @input == "BACK"
+          self.display_podcast_info
+        end
+      end
+      self.proceed_based_on_input
+      self.choose_podcast_action unless @quit == "YES"
+    end
+  end
+
+  def display_episode_list
+    puts "Getting episodes for #{@podcast_choice.name}..."
+    PodcastFinder::DataImporter.import_episodes(@podcast_choice)
+    if !@podcast_choice.episodes.empty?
+      puts ""
+      puts "#{@podcast_choice.name} Recent Episode List".colorize(:light_blue)
+      @podcast_choice.list_episodes
+      puts ""
+      puts "These are all the options currently available in Podcast Finder.".colorize(:light_blue)
+      puts "To see more, check out #{@podcast_choice.name} online at #{@podcast_choice.url}"
+      puts ""
+      puts "Options:".colorize(:light_blue)
+      puts "Select an episode (1-#{@podcast_choice.episodes.count}) to get a description and download link".colorize(:light_blue)
+      puts "Type 'back' to return to podcast listing for #{@category_choice.name}".colorize(:light_blue)
+      puts "Type 'menu' to see the category list".colorize(:light_blue)
+      self.choose_episode
+    else #for edge case where a podcast has no associated episodes but is listed as active by website
+      puts ""
+      puts "Looks like #{@podcast_choice.name} doesn't have episodes online.".colorize(:light_red)
+      puts ""
+      puts "Type 'back' to return to podcast listing for #{@category_choice.name}".colorize(:light_blue)
+      puts "Type 'menu' to see the category list".colorize(:light_blue)
+      self.choose_action_no_episodes
+    end
+  end
+
+  def choose_action_no_episodes
+    self.get_input
+    if @input == "BACK"
+      @podcast_counter = 0
+      self.browse_category
+    elsif @input == "MENU"
+      self.proceed_based_on_input
+    else
+      @input = "STUCK" unless @input == "EXIT" || @input == "HELP"
+      if @input == "HELP"
+        self.proceed_based_on_input
+        if @input == "BACK"
+          self.display_episode_list
+        end
+      end
+      self.proceed_based_on_input
+      self.choose_action_no_episodes unless @quit == "YES"
+    end
+  end
+
+  def choose_episode
+    self.get_input
+    if @input.class == Fixnum && @input.between?(1, @podcast_choice.episodes.count)
+      @episode_choice = @podcast_choice.episodes[@input-1]
+      self.display_episode_info
+    elsif @input.class == Fixnum && !@input.between?(1, @podcast_choice.episodes.count)
+      puts "Sorry, that's not an episode option. Please enter a number between 1 and #{@podcast_choice.episodes.count} to proceed."
+      self.choose_episode
+    elsif @input == "BACK"
+      @podcast_counter = 0
+      self.browse_category
+    else
+      @input = "STUCK" unless @input == "EXIT" || @input == "HELP"
+      if @input == "HELP"
+        self.proceed_based_on_input
+        if @input == "BACK"
+          self.display_episode_list
+        end
+      end
+      self.proceed_based_on_input
+      self.choose_episode unless @quit == "YES"
+    end
+  end
+
+  def display_episode_info
+    puts ""
+    @episode_choice.list_data
+    puts ""
+    puts "Options:".colorize(:light_blue)
+    puts "Type 'back' to return to episode listing for #{@podcast_choice.name}".colorize(:light_blue)
+    puts "Type 'podcasts' to return to the podcast list for #{@category_choice.name}".colorize(:light_blue)
+    puts "Type 'menu' to see the category list".colorize(:light_blue)
+    self.choose_action_episode_info
+  end
+
+  def choose_action_episode_info
+    self.get_input
+    if @input == "BACK"
+      @episode_choice = nil
+      self.display_episode_list
+    elsif @input == "PODCASTS"
+      @podcast_counter = 0
+      @podcast_choice = nil
+      @episode_choice = nil
+      self.browse_category
+    else
+      @input = "STUCK" unless @input == "EXIT" || @input == "HELP"
+      if @input == "HELP"
+        self.proceed_based_on_input
+        if @input == "BACK"
+          self.display_episode_info
+        end
+      end
+      self.proceed_based_on_input
+      self.choose_action_episode_info unless @quit == "YES"
+    end
+  end
+
+end

data/lib/podcast_finder/episode.rb

@@ -0,0 +1,48 @@
+class PodcastFinder::Episode
+
+  attr_accessor :date, :title, :description, :download_link, :length, :podcast
+
+  @@all = []
+
+  def initialize(episode_hash)
+    episode_hash.each {|key, value| self.send("#{key}=", value)}
+    self.format_date
+    self.save
+  end
+
+  def format_date
+    date_string = @date.to_s
+    @date = Date.parse(date_string, "%Y-%m-%d")
+  end
+
+  def display_date
+    @date.strftime('%B %-d, %Y')
+  end
+
+  def self.create_from_collection(episode_array)
+    episode_array.each {|episode_hash| self.new(episode_hash)}
+  end
+
+  def list_data
+    puts "Episode: #{self.title}".colorize(:light_blue)
+    puts "Podcast: ".colorize(:light_blue) + "#{self.podcast.name}"
+    puts "Date ".colorize(:light_blue) + "#{self.display_date}"
+    if self.length.nil?
+      puts "Length: ".colorize(:light_blue) + "Not Available"
+    else
+      puts "Length: ".colorize(:light_blue) + "#{self.length}"
+    end
+    puts "Description: ".colorize(:light_blue) + "#{self.description}"
+    puts "Link to download: ".colorize(:light_blue) + "#{self.download_link}"
+    puts "Link to listen:  ".colorize(:light_blue) + "#{self.podcast.url}"
+  end
+
+  def save
+    @@all << self
+  end
+
+  def self.all
+    @@all
+  end
+
+end

data/lib/podcast_finder/importer.rb

@@ -0,0 +1,56 @@
+class PodcastFinder::DataImporter
+
+  def self.import_categories(index_url)
+    category_data = PodcastFinder::Scraper.new.scrape_category_list(index_url)
+    PodcastFinder::Category.create_from_collection(category_data)
+  end
+
+  def self.import_podcast_data(category)
+    podcast_array = PodcastFinder::Scraper.new.scrape_podcasts(category.url)
+    self.import_stations(podcast_array)
+    self.import_podcasts(podcast_array, category)
+  end
+
+  #helper methods for import_podcast_data
+
+  def self.import_stations(podcast_array)
+    podcast_array.each do |podcast_hash|
+      check_station = podcast_hash[:station]
+      if PodcastFinder::Station.find_by_name(check_station).nil?
+        station = PodcastFinder::Station.new(podcast_hash)
+      end
+    end
+  end
+
+  def self.import_podcasts(podcast_array, category)
+    podcast_array.each do |podcast_hash|
+      check_podcast = podcast_hash[:name]
+      if PodcastFinder::Podcast.find_by_name(check_podcast).nil?
+        podcast = PodcastFinder::Podcast.new(podcast_hash)
+        category.add_podcast(podcast)
+        station = PodcastFinder::Station.find_by_name(podcast_hash[:station])
+        station.add_podcast(podcast)
+      else
+        podcast = PodcastFinder::Podcast.find_by_name(check_podcast)
+        category.add_podcast(podcast)
+      end
+    end
+  end
+
+  def self.import_description(podcast)
+    if podcast.description.nil?
+      podcast.description = PodcastFinder::Scraper.new.get_podcast_description(podcast.url)
+    end
+  end
+
+  def self.import_episodes(podcast)
+    if podcast.episodes == []
+      episode_list = PodcastFinder::Scraper.new.scrape_episodes(podcast.url)
+      episode_list.each do |episode_hash|
+        episode = PodcastFinder::Episode.new(episode_hash)
+        podcast.add_episode(episode)
+      end
+    end
+  end
+
+end

data/lib/podcast_finder/podcast.rb

@@ -0,0 +1,63 @@
+class PodcastFinder::Podcast
+
+  attr_accessor :name, :url
+  attr_reader :station, :categories, :description, :episodes
+
+  @@all = []
+
+  def initialize(podcast_hash)
+    @name = podcast_hash[:name]
+    @url = podcast_hash[:url]
+    @description = nil
+    @categories = []
+    @episodes = []
+    self.save
+  end
+
+  def add_category(category)
+    if category.class == PodcastFinder::Category && !self.categories.include?(category)
+      @categories << category
+    end
+  end
+
+  def add_episode(episode)
+    self.episodes << episode
+    episode.podcast = self
+  end
+
+  def station=(station)
+    if station.class == PodcastFinder::Station
+      @station = station
+    end
+  end
+
+  def list_episodes
+    self.episodes.each_with_index do |episode, index|
+      puts "(#{index + 1}) #{episode.title} - #{episode.display_date}" + "#{" - " + episode.length unless episode.length.nil?}"
+    end
+  end
+
+  def description=(description)
+    @description = description
+  end
+
+  def list_data
+    puts "Podcast: #{self.name}".colorize(:light_blue)
+    puts "Station:".colorize(:light_blue) + "#{self.station.name}"
+    puts "Description:".colorize(:light_blue) + " #{self.description}"
+  end
+
+
+  def save
+    @@all << self
+  end
+
+  def self.all
+    @@all
+  end
+
+  def self.find_by_name(name)
+    self.all.detect {|item| item.name == name}
+  end
+
+end

data/lib/podcast_finder/scraper.rb

@@ -0,0 +1,105 @@
+class PodcastFinder::Scraper
+
+	attr_accessor :index, :categories
+
+	def scrape_page(url)
+		html = open(url)
+		@index = Nokogiri::HTML(html)
+	end
+
+	def scrape_category_list(url)
+		self.scrape_page(url)
+		@categories = []
+		groups = @index.css('nav.global-navigation div.subnav.subnav-podcast-categories div.group')
+		categories = groups.each do |group|
+			category_info = group.css('ul li')
+			category_info.each do |category_data|
+				category = {
+					:name => category_data.css('a').text,
+					:url => "http://www.npr.org" + category_data.css('a').attribute('href').value
+				}
+				@categories << category
+			end
+		end
+		@categories
+	end
+
+	# podcasts scraping
+
+	def scrape_podcasts(category_url)
+		counter = 1
+		podcasts = []
+		until counter == "done" do
+			scrape_url = category_url + "/partials?start=#{counter}"
+			self.scrape_page(scrape_url)
+			if !@index.css('article').first.nil?
+				active_podcasts = @index.css('article.podcast-active')
+				active_podcasts.each {|podcast| podcasts << self.get_podcast_data(podcast)}
+				counter += @index.css('article').size
+			else
+				counter = "done"
+			end
+		end
+		podcasts
+	end
+
+	def get_podcast_data(podcast)
+		data = {
+			:name => podcast.css('h1.title a').text,
+			:url => podcast.css('h1.title a').attribute('href').value,
+			:station => podcast.css('h3.org a').text,
+			:station_url => "http://www.npr.org" + podcast.css('h3.org a').attribute('href').value
+		}
+	end
+
+	def get_podcast_description(podcast_url)
+		self.scrape_page(podcast_url)
+		if @index.css('div.detail-overview-content.col2 p').size == 1
+			text = @index.css('div.detail-overview-content.col2 p').text
+		elsif @indext.css('div.detail-overview-content.col2 p') > 1
+			text = @index.css('div.detail-overview-content.col2 p').first.text
+		end
+			description = text.gsub(@index.css('div.detail-overview-content.col2 p a.more').text, "").gsub("\"", "'")
+	end
+
+	#individual episode methods
+
+	def scrape_episodes(podcast_url)
+		episode_list = []
+		self.scrape_page(podcast_url)
+		episodes = @index.css('section.podcast-section.episode-list article.item.podcast-episode')
+		episodes.each do |episode|
+			episode_data = self.get_episode_data(episode)
+			episode_list << episode_data unless episode_data[:download_link].nil? #unless is for edge case
+		end
+		episode_list
+	end
+
+	def get_episode_data(episode)
+		#for an edge case where sometimes the first podcast has no file associated with it
+		if !episode.css('div.audio-module-tools').empty?
+			link = episode.css('div.audio-module-tools ul li a').attribute('href').value
+			length = episode.css('div.audio-module-controls b.audio-module-listen-duration').text[/(\d*:?\d{1,2}:\d\d)/]
+		else
+			link = nil
+			length = nil
+		end
+		if episode.css('p').count > 1
+			paragraphs = episode.css('p')
+			p1 = paragraphs[0].text.gsub(episode.css('p.teaser time').text, "").gsub(/\n+\s*/, "").gsub("\"", "'")
+			p2 = paragraphs[1].text.gsub(/\n+\s*/, "").gsub("\"", "'")
+			description = p1 + p2 + " Read more online >>"
+		else
+			description = episode.css('p.teaser').text.gsub(episode.css('p.teaser time').text, "").gsub(/\n+\s*/, "").gsub("\"", "'")
+		end
+		#end edge case
+		episode_data = {
+			:date => episode.css('time').attribute('datetime').value,
+			:title => episode.css('h2.title').text.gsub(/\n+\s*/, "").gsub("\"", "'"),
+			:length => length,
+			:description => description,
+			:download_link => link
+		}
+	end
+
+end

data/lib/podcast_finder/station.rb

@@ -0,0 +1,34 @@
+class PodcastFinder::Station
+
+  attr_accessor :name, :url
+  attr_reader :podcasts
+
+  @@all = []
+
+  def initialize(podcast_hash)
+    @name = podcast_hash[:station]
+    @url = podcast_hash[:station_url]
+    @podcasts = []
+    self.save
+  end
+
+  def add_podcast(podcast)
+    if podcast.class == PodcastFinder::Podcast
+      @podcasts << podcast
+      podcast.station = self
+    end
+  end
+
+  def save
+    @@all << self
+  end
+
+  def self.all
+    @@all
+  end
+
+  def self.find_by_name(name)
+    self.all.detect {|item| item.name == name}
+  end
+
+end

data/lib/podcast_finder/version.rb

@@ -0,0 +1,3 @@
+class PodcastFinder
+  VERSION = "0.1.14"
+end

data/podcast_finder.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'podcast_finder/version'
+
+Gem::Specification.new do |spec|
+  spec.name           = 'podcast_finder'
+  spec.version        = PodcastFinder::VERSION
+  spec.license        = 'MIT'
+
+  spec.summary        = "CLI gem for finding NPR podcasts"
+  spec.description    =
+    "Podcast Finder is a CLI gem that displays ongoing podcasts by NPR and NPR-affiliated stations. Browse by category, view podcast descriptions and episodes, and get links to listen online."
+  spec.authors        = ["Elyse Klova"]
+  spec.email          = 'elyse.klova@gmail.com'
+
+  spec.homepage       = 'https://github.com/klovae/podcast-finder-gem'
+
+  spec.files          = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.executables    = ['podcast_finder']
+  spec.require_paths  = ['lib']
+
+  spec.post_install_message = "Thanks for installing! Happy listening."
+
+  spec.add_runtime_dependency 'nokogiri', '>= 0'
+  spec.add_runtime_dependency 'colorize', '~> 0.8', '>= 0.8.1'
+
+  spec.add_development_dependency 'rspec', '~> 3.5'
+  spec.add_development_dependency 'pry', '>= 0'
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/spec.md

@@ -0,0 +1,17 @@
+# Specifications for the CLI Assessment
+
+Specs:
+- [x] Have a CLI for interfacing with the application
+Created a user-friendly CLI with a main menu and help menu, that allows the user to go back and forth between levels of data and exit at any time from any point in the program.
+- [x] Pull data from an external source
+Uses Nokogiri to scrape content from NPR's Podcast Directory
+  - Pulls category data from http://www.npr.org/podcasts
+  - Pulls podcast data from individual category pages
+  - Pulls episode data from individual podcast pages
+- [x] Implement both list and detail views
+  - Uses OO to associate podcasts with categories and episodes with podcasts, so that the user can view any of the following:
+    - list of categories
+    - lists of podcasts by category
+    - descriptions of podcasts
+    - lists of episodes for podcasts
+    - descriptions of individual episodes, their runtimes, and links to listen and download when available

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: podcast_finder
+version: !ruby/object:Gem::Version
+  version: 0.1.14
+platform: ruby
+authors:
+- Elyse Klova
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-09-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  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: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  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.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !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'
+description: Podcast Finder is a CLI gem that displays ongoing podcasts by NPR and
+  NPR-affiliated stations. Browse by category, view podcast descriptions and episodes,
+  and get links to listen online.
+email: elyse.klova@gmail.com
+executables:
+- podcast_finder
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/podcast_finder
+- bin/setup
+- lib/podcast_finder.rb
+- lib/podcast_finder/category.rb
+- lib/podcast_finder/commandline.rb
+- lib/podcast_finder/episode.rb
+- lib/podcast_finder/importer.rb
+- lib/podcast_finder/podcast.rb
+- lib/podcast_finder/scraper.rb
+- lib/podcast_finder/station.rb
+- lib/podcast_finder/version.rb
+- podcast_finder.gemspec
+- spec.md
+homepage: https://github.com/klovae/podcast-finder-gem
+licenses:
+- MIT
+metadata: {}
+post_install_message: Thanks for installing! Happy listening.
+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.6.4
+signing_key: 
+specification_version: 4
+summary: CLI gem for finding NPR podcasts
+test_files: []