tinyletter 0.0.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3360309e0cfa8ceaada75812e814e3419432aaff
+  data.tar.gz: dd43cd9db03c595a81cc09b5a2ac66aef9ff380e
+SHA512:
+  metadata.gz: f108d124288f2c8f2ee458f3d99109f5fbf2a145e75fd8f4408507d5677b0dad1b5528b832958767e7c21bed629747479bb032eaa4209432fa4b67589c9eabac
+  data.tar.gz: 40664228495431b803d36c8d0d4d3007d4282267fdd9fb46e0818b6a4074c2ecc109636e8a97212e28c238da8a0daa4ab6a1e3d994e07ad9b8133ab0ed20084d

data/README.md

@@ -0,0 +1,59 @@
+Ruby gem that retrieves the metadata of a given tinyletter newsletter.
+
+### Installation
+
+```gem install tinyletter```
+
+### Usage
+
+```ruby
+require 'rubygems'
+require 'tinyletter'
+
+newsletter = Tinyletter::Newsletter.new('metafoundry')
+puts newsletter.metadata 
+```
+
+That will output:
+
+```ruby
+{
+  :title => "Metafoundry",
+  :by => "Deb Chachra",
+  :description => "Ingredients include: technology, systems, design, language, social justice, and geography. Less than 0.1% cats by volume. Manufactured in a facility that contains personality, emotions and a worldview.", 
+  :archive_url => "http://tinyletter.com/metafoundry/archive"
+}
+```
+
+#### Requesting the newsletter archive
+
+```ruby
+require 'rubygems'
+require 'tinyletter'
+
+newsletter = Tinyletter::Newsletter.new('vruba', { with_archive: true })
+puts newsletter.metadata
+```
+
+If the newsletter has enabled its archives, that will output:
+
+```ruby
+{
+  :title => "6",
+  :by => "Charlie Loyd",
+  :description => "Notes on things I’m thinking about, most weekends. Strictly a personal project, representing my own views alone. Recurring themes include psychogeography, space shuttles, food, and complaining.", 
+  :archive_url => "http://tinyletter.com/vruba/archive",
+  :archive => [
+   {
+     :date => "2016-07-25",
+     :title => "6, 84: Antennapedia",
+     :url => "http://tinyletter.com/vruba/letters/6-84-antennapedia", 
+     :description => "Of course everyone is talking about the Martha Nussbaum profile in *The New Yorker*  (via @equartey"
+    }, {
+     :date => "2016-07-11",
+     :title => "6, 83: Build a ray",
+     :url => "http://tinyletter.com/vruba/letters/6-83-build-a-ray", 
+     :description => "Hi! I think it’s time to re-introduce myself. This is an irregular newsletter on mixed topics. It comes from wanting to stay in loose touch with more people than I can personally. What I put here is..."
+    }
+}
+```

data/bin/tinyletter

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift(File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')))
+
+require 'tinyletter'
+Tinyletter::CLI.start(ARGV)

data/lib/tinyletter/newsletter.rb

@@ -0,0 +1,80 @@
+require 'mechanize'
+require 'logger'
+
+WEB_USER_AGENT = 'Mozilla/5.0 (Linux; Android 4.2.1; en-us; Nexus 4 Build/JOP40D) AppleWebKit/535.19 (KHTML, ' \
+  'like Gecko) Chrome/18.0.1025.166 Mobile Safari/535.19'.freeze
+
+module Tinyletter
+  class Newsletter
+    BASE_ENDPOINT = 'http://tinyletter.com/'.freeze
+
+    def initialize(username, params = {})
+      @username = username
+      @with_archive = params[:with_archive] || false
+      initialize_http_client
+    end
+
+    def metadata
+      return @metadata unless @metadata.nil?
+
+      begin
+        page = get(BASE_ENDPOINT + @username)
+        @metadata = extract_metadata(page)
+      rescue Mechanize::ResponseCodeError => e
+        { error: e }
+      end
+    end
+
+    private
+
+    def extract_metadata(page)
+      archive = page.at('#view-messages-link')
+
+      metadata = { title: page.at('h1.title').text.strip,
+                   by: page.at('.byline').text.strip.gsub(/^by /, ''),
+                   description: page.at('.description').text.strip,
+                   archive_url: archive ? archive['href'] : nil
+      }
+
+      if archive && @with_archive
+        metadata[:archive] = extract_archive_metadata(archive)
+      end
+
+      metadata
+    end
+
+    def extract_archive_metadata(archive)
+      get(archive['href']).search('.message-item').map do |item|
+        extract_archive_item_metadata(item)
+      end
+    end
+
+    def extract_archive_item_metadata(item)
+      date = Date.parse(item.at('.message-date').text.strip).to_s
+      {
+        date: date,
+        title: item.at('.message-link').text.strip,
+        url: item.at('.message-link')['href'],
+        description: item.at('.message-snippet').text.strip
+      }
+    end
+
+    def get(url, params: [], referer: nil)
+      @http.get(url, params, referer, @headers)
+    end
+
+    def initialize_http_client
+      @http = Mechanize.new do |mechanize|
+        mechanize.user_agent = WEB_USER_AGENT
+        mechanize.agent.http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        mechanize.log = Logger.new(STDOUT) if Tinyletter.debug
+      end
+
+      @headers = {}
+    end
+
+    def log(msg)
+      puts msg if Tinyletter.log
+    end
+  end
+end

data/lib/tinyletter/version.rb

@@ -0,0 +1,3 @@
+module Tinyletter
+  VERSION = '0.0.6'.freeze
+end

data/lib/tinyletter.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require_relative 'tinyletter/version'
+require_relative 'tinyletter/newsletter'
+
+module Tinyletter
+  class << self
+    attr_accessor :log
+    attr_accessor :debug
+  end
+
+  self.log = false
+  self.debug = false
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: tinyletter
+version: !ruby/object:Gem::Version
+  version: 0.0.6
+platform: ruby
+authors:
+- Javier Arce
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !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: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.0
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+description: Retrieves the metadata of a given tinyletter.
+email: javierarce@gmail.com
+executables:
+- tinyletter
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/tinyletter
+- lib/tinyletter.rb
+- lib/tinyletter/newsletter.rb
+- lib/tinyletter/version.rb
+homepage: https://github.com/javierarce/tinyletter
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.6
+signing_key: 
+specification_version: 4
+summary: Retrieves the metadata of a given tinyletter.
+test_files: []