mailtojekyll 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 614b720ae92b14999a17de7d36b60f156fc6b3ca
+  data.tar.gz: 0620950a2eb3e4dbd411c49152cddf60be8d8538
+SHA512:
+  metadata.gz: 6d2bacc9591d037f65110752e6fe4cd017d34a91120ccd3daef2216f2186fd1d984a61298a6c178f2708bd41f65714b89a6fcfad767285ed5ab9d554e0686d84
+  data.tar.gz: 632aca57334fb086b72ddf270e11647976947a8a1836f0ad3f9114bf5d72a10787c699a9eadeb0022b79858435db3c92db3d8668905c024e6e0e82beb000d031

data/.gitignore

@@ -0,0 +1,3 @@
+coverage
+_config.yml
+lib/pullemails.rb

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.ruby-gemset

@@ -0,0 +1 @@
+mailtojekyll

data/.ruby-version

@@ -0,0 +1 @@
+2.2.0

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, 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, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other 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. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+gem 'mail'
+gem 'nokogiri'
+gem 'reverse_markdown'
+gem 'rinku'
+
+group :test do
+  gem 'rspec', '~> 3.0'
+  gem 'simplecov', :require => false
+end

data/Gemfile.lock

@@ -0,0 +1,44 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    json (1.8.3)
+    mail (2.6.3)
+      mime-types (>= 1.16, < 3)
+    mime-types (2.6.1)
+    mini_portile (0.6.2)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    reverse_markdown (0.8.2)
+      nokogiri
+    rinku (1.7.3)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.0)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  mail
+  nokogiri
+  reverse_markdown
+  rinku
+  rspec (~> 3.0)
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Kate Klemp
+
+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,121 @@
+# mailtojekyll
+
+TODO: Update rspec tests
+
+## Motivation
+
+`mailtojekyll` was written in order to allow clients to post to `jekyll` blogs via email, rather than manually creating markdown files, running `jekyll`, and uploading the generated static files themselves.
+
+## What it does
+
+Converts emailed blog posts into markdown and saves them inside a jekyll structure
+
+## How it works
+
+`mailtojekyll` connects to a dedicated email account using POP3; downloads all the emails; validates for content, secret word, and subject line; processes the emails into markdown; saves the attachments; and replaces image references with markdown-safe image links.
+
+## How to use it
+
+Users email a post to their dedicated email account for their `jekyll` blog.  Most formatting will be stripped out.  If the user wants to include images in the post, they should use the following syntax:
+
+```
+#image-filename.png#
+```
+
+`mailtojekyll` will replace that tag with the correct markdown image tag, including a reference to the relative image path so `jekyll` processes it correctly
+
+### External Dependencies
+- `jekyll` [http://www.jekyllrb.com/](http://www.jekyllrb.com)
+- `mail` gem
+- `nokogiri` gem
+- `reverse_markdown` gem
+- `rinku` gem
+
+## Reference implementation
+One option:
+- `jekyll` installed locally
+- `mailtojekyll` installed locally as an executable gem
+- cron job to run `mailtojekyll`
+- cron job to build `jekyll` site
+- cron job to transfer `_site/` directory to server (i.e. FTP or sync)
+- cron job to update and push `git` branches
+
+### Managing services
+
+#### [OS]
+
+Ubuntu/Linux
+
+#### [Libraries/Apps]
+
+- `ruby`
+- `rvm`
+- `git`
+
+#### [Web Server]
+
+Hosting (dedicated or shared)
+
+### Production Implementation
+
+#### Where is this thing?
+
+**TODO: Update this with our production stack (AWS, etc.)**
+
+## For developers
+
+Best practices  
+1. Set up a dedicated email account only for this purpose
+2. Clone `mailtojekyll` to your local machine
+3. 
+```
+cd mailtojekyll
+```
+(this should create a new gemset if you're using `rvm`)
+
+4. `rake install` to install gem executable
+5. Install jekyll and create a new blog: [http://jekyllrb.com/docs/quickstart/](http://jekyllrb.com/docs/quickstart/)
+6. Send a few emails to your dedicated email account
+7. ```
+mailtojekyll -j /home/user/repo -s pop.example.com -u example@example.com -p x123456789x -S secretword -i imgdir -P postdir
+```
+8. View your repo to see the created files.
+
+### CRON JOB SETUP
+
+Add required `rvm` path variables to the top of your crontab file:
+```
+rvm cron setup
+```
+Set up cron job
+```
+crontab -e
+```
+
+##### CRON JOB W/ POP
+```
+* * * * * /home/user/.rvm/gems/ruby-2.2.0@mailtojekyll/bin/mailtojekyll -j /home/user/repo -s pop.example.com -u example@example.com -p x123456789x -S secretword -i imgdir -P postdir >> /tmp/cron_debug_log.log 2>&1
+```
+
+##### CRON JOB W/ TEST EMAILS
+```
+* * * * * /home/user/.rvm/gems/ruby-2.2.0@mailtojekyll/bin/mailtojekyll -t /path/to/emails -j /home/user/repo -S secretword -i imgdir -P postdir >> /tmp/cron_debug_log.log 2>&1
+```
+
+### Deployment
+
+Run `mailtojekyll` on your own machine with cron, or on a server with cron to gather emails.  Manually build and upload your site, Deploy `jekyll` according to recommendations: [http://jekyllrb.com/docs/deployment-methods/](http://jekyllrb.com/docs/deployment-methods/)
+
+## Contributors
+
+ * **M**anager: Ian Reynolds
+ * **O**wner: Kate Klemp
+ * **C**onsulted: Sunil Chopra
+ * **H**elper: Sunil Chopra
+ * **A**pprover: Sunil Chopra
+
+## ATTRIBUTION
+
+mailtojekyll is based heavily on the concepts of [JekyllMail](https://github.com/masukomi/JekyllMail), and is essentially a ground-up refactor of that existing app.  It has been gemified for ease of use, and updated to work with the most recent versions of `mail`, `nokogiri`, `reverse_markdown`, and `rinku`
+
+I developed this as a standalone because development on JekyllMail is 4 years old, so I wanted to make sure it was available as an app/gem

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/console

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

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

data/exe/mailtojekyll

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+# Run mailtojekyll with options
+
+require_relative '../lib/mailtojekyll'

data/lib/jekyllemail.rb

@@ -0,0 +1,137 @@
+#!/usr/bin/env ruby
+
+require 'mail'
+require 'nokogiri'
+require 'reverse_markdown'
+require 'rinku'
+
+class JekyllEmail
+  
+  include Mail
+  include Rinku
+
+  attr_reader :atts, :title, :body
+  
+  def initialize(thismail)
+    # empties
+    @atts = {}
+    body = ""
+    
+    # process w/ mail gem
+    # thismail = Mail.read(thismail)    
+    
+    # get the subject for validation & split to get title/secret
+    @subject = thismail.subject
+    (@title, @secret) = (@subject.split((/\|\|/))).collect { |x| x.strip } unless @subject.nil?
+
+    save_attachments(thismail)
+
+    # process the body with markdown and blanktest
+    if thismail.multipart?
+      body = thismail.text_part.decoded.gsub(/\n{2}/,"<br><br>").gsub(/\n{1}/,"<br>")
+    else
+      body = thismail.body.to_s.gsub(/\n{2}/,"<br><br>").gsub(/\n{1}/,"<br>")
+    end
+    body = find_links(body)
+    body = find_images(body)
+    body = auto_link(body)
+    body = markdown(body)
+    body = body.gsub(/\[\?\]/,"")
+    body = body.gsub(/[\u{00A9}\u{00AE}\u{203C}\u{2049}\u{2122}\u{2139}\u{2194}-\u{2199}\u{21A9}-\u{21AA}\u{231A}-\u{231B}\u{2328}\u{23CF}\u{23E9}-\u{23F3}\u{23F8}-\u{23FA}\u{24C2}\u{25AA}-\u{25AB}\u{25B6}\u{25C0}\u{25FB}-\u{25FE}\u{2600}-\u{2604}\u{260E}\u{2611}\u{2614}-\u{2615}\u{2618}\u{261D}\u{2620}\u{2622}-\u{2623}\u{2626}\u{262A}\u{262E}-\u{262F}\u{2638}-\u{263A}\u{2648}-\u{2653}\u{2660}\u{2663}\u{2665}-\u{2666}\u{2668}\u{267B}\u{267F}\u{2692}-\u{2694}\u{2696}-\u{2697}\u{2699}\u{269B}-\u{269C}\u{26A0}-\u{26A1}\u{26AA}-\u{26AB}\u{26B0}-\u{26B1}\u{26BD}-\u{26BE}\u{26C4}-\u{26C5}\u{26C8}\u{26CE}-\u{26CF}\u{26D1}\u{26D3}-\u{26D4}\u{26E9}-\u{26EA}\u{26F0}-\u{26F5}\u{26F7}-\u{26FA}\u{26FD}\u{2702}\u{2705}\u{2708}-\u{270D}\u{270F}\u{2712}\u{2714}\u{2716}\u{271D}\u{2721}\u{2728}\u{2733}-\u{2734}\u{2744}\u{2747}\u{274C}\u{274E}\u{2753}-\u{2755}\u{2757}\u{2763}-\u{2764}\u{2795}-\u{2797}\u{27A1}\u{27B0}\u{27BF}\u{2934}-\u{2935}\u{2B05}-\u{2B07}\u{2B1B}-\u{2B1C}\u{2B50}\u{2B55}\u{3030}\u{303D}\u{3297}\u{3299}\u{1F004}\u{1F0CF}\u{1F170}-\u{1F171}\u{1F17E}-\u{1F17F}\u{1F18E}\u{1F191}-\u{1F19A}\u{1F201}-\u{1F202}\u{1F21A}\u{1F22F}\u{1F232}-\u{1F23A}\u{1F250}-\u{1F251}\u{1F300}-\u{1F321}\u{1F324}-\u{1F393}\u{1F396}-\u{1F397}\u{1F399}-\u{1F39B}\u{1F39E}-\u{1F3F0}\u{1F3F3}-\u{1F3F5}\u{1F3F7}-\u{1F4FD}\u{1F4FF}-\u{1F53D}\u{1F549}-\u{1F54E}\u{1F550}-\u{1F567}\u{1F56F}-\u{1F570}\u{1F573}-\u{1F579}\u{1F587}\u{1F58A}-\u{1F58D}\u{1F590}\u{1F595}-\u{1F596}\u{1F5A5}\u{1F5A8}\u{1F5B1}-\u{1F5B2}\u{1F5BC}\u{1F5C2}-\u{1F5C4}\u{1F5D1}-\u{1F5D3}\u{1F5DC}-\u{1F5DE}\u{1F5E1}\u{1F5E3}\u{1F5EF}\u{1F5F3}\u{1F5FA}-\u{1F64F}\u{1F680}-\u{1F6C5}\u{1F6CB}-\u{1F6D0}\u{1F6E0}-\u{1F6E5}\u{1F6E9}\u{1F6EB}-\u{1F6EC}\u{1F6F0}\u{1F6F3}\u{1F910}-\u{1F918}\u{1F980}-\u{1F984}\u{1F9C0}]/,"")
+    unless body.nil?
+      if blanktest(body)
+        thismail.has_attachments? ? body = " " : body = ""
+      end
+    end
+    @body = body
+  end
+  
+  # validate the subject; if valid, return title
+  def validate_subject
+    if @subject.nil?
+      puts "No subject, skipping"
+      raise StandardError, "No subject"
+    else
+      @title.strip
+    end
+  end
+  
+  # validate the secret; no return
+  def validate_secret(opt) # parse the title for the secret
+    unless @secret.nil?
+      (key, @secret) = @secret.split(/:\s?/)
+      @secret.strip!
+    end
+    if (@secret.nil? || @secret != opt)
+      puts "#{@subject}: Secret incorrect, skipping"
+      raise StandardError, "Secret incorrect or missing"
+    end
+  end
+  
+  # validate the body
+  def validate_body
+    if @body == ""
+      puts "#{@subject}: No body text, skipping"
+      raise StandardError, "No body text"
+    end
+  end
+  
+  def find_images(body)
+    find = body.scan(/\[cid:.*?\]/)
+    find.each do |cid|
+      body = body.gsub(cid,"")
+    end
+    find = body.scan(/\#.*?\#/)
+    find.each do |img|
+      body = body.gsub(img,"<img src='#{img[1...-1]}' />")
+    end
+    body.to_s
+  end
+  
+  def find_links(body)
+    find = body.scan(/\<http:.*?\>/)
+    find.each do |link|
+      body = body.gsub(link,"")
+    end
+    body.to_s
+  end
+  
+  # convert body to markdown
+  def markdown(doc)
+    doc = Nokogiri::HTML(doc)
+    if doc.at("body").nil?
+      doc = ""
+    else
+      doc = ReverseMarkdown.convert(doc.at("body").inner_html)
+    end
+  end
+  
+  # test body to see if it's empty
+  def blanktest(doc)
+    #strip out unicode character that gives us false blanks
+    badspc = Nokogiri::HTML("&#8203;").text
+    nbsp = Nokogiri::HTML("&nbsp;").text
+    isblank = doc.gsub(badspc,"").gsub(nbsp,"").gsub("\&nbsp;","").gsub(/\n/,"").gsub(/\s+/,"")
+    if isblank == ""
+      blank = true
+    else
+      blank = false
+    end
+  end
+
+  # find and save attachments
+  def save_attachments(thismail)
+    if thismail.has_attachments?
+      # list the attachments & save them
+      thismail.attachments.each_with_index do |att,idx|
+        if att.content_type.start_with?("image/")
+          filename = att.filename.gsub(/[^0-9a-z. ]/i, ' ')
+          filename = filename.split(" ").join("-")
+          cid = att.content_id.to_s.delete("<>")
+          @atts["image#{idx}".to_sym] = {filename: filename, cid: cid, content: att.body.decoded, type: att.content_type}
+        end
+      end
+    end
+  end
+  
+end

data/lib/jekyllpost.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+
+class JekyllPost
+
+  def initialize(title, body, atts, repo, imgdir, pstdir, meta)
+    time = Time.now
+    postday = time.strftime("%Y-%m-%d")
+    posttime = time.strftime("%H:%M:%S")
+    daydir = time.strftime("%Y/%m/%d")
+    imgdir = "#{imgdir}/#{daydir}"
+    path = make_slug(title,postday)
+    post_filename = "#{repo}/#{pstdir}/#{path}"
+    
+    content = replace_images(body, atts, imgdir)
+    create_imgdir(repo,imgdir)
+    save_attachments(repo, imgdir, atts)
+    create_post(post_filename, meta, title, postday, posttime, atts, imgdir, content)
+  end
+  
+  def create_post(post_filename, meta, title, postday, posttime, atts, imgdir, content)
+    open(post_filename, 'w') do |post|
+      post << "---\n"
+      post << "layout: #{meta[:layout]}\n"
+      post << "title: #{title}\n"
+      post << "date: #{postday} #{posttime}\n"
+      post << "categories: #{meta[:categories]}\n"
+      unless atts.empty?
+        key,val = atts[:image0][:filename]
+        post << "image: /#{imgdir}/#{key}\n"
+      end
+      post << "---\n"
+      post << "#{content}"
+    end
+  end
+  
+  def save_attachments(repo, imgdir, atts)
+    atts.each do |img,att|
+      if (att[:type].start_with?('image/'))
+        # extracting images for example...
+        filename = att[:filename]
+        begin
+          File.open("#{repo}/#{imgdir}/#{filename}", "w+b", 0644) {|f| f.write att[:content]}
+        rescue => e
+          puts "Unable to save data for #{filename} because #{e.message}"
+        end
+      end
+    end
+  end  
+  
+  def replace_images(post, atts, imgdir)
+    atts.each do |img,vals|
+      srchimg = "![](#{vals[:filename]})"
+      unless post.nil?
+        post = post.gsub(srchimg,"![](/#{imgdir}/#{vals[:filename]})")
+        # if vals[:cid] == ""
+        #   newimg = "![](/#{imgdir}/#{vals[:filename]})\n\n"
+        #   post << newimg
+        # end
+      end
+    end
+    post
+  end
+  
+  def make_slug(title,time)
+    title = title.downcase.gsub(/\W+/, ' ')
+    title = title.split(" ").join("-")
+    title += ".md"
+    path = "#{time}-#{title}"
+  end
+  
+  def create_imgdir(repo,imgdir)
+    
+    fullpath = "#{repo}/#{imgdir}"
+    
+    unless Dir.exists?(fullpath)
+      FileUtils.mkdir_p(fullpath)
+    end
+  end
+  
+end

data/lib/mailtojekyll.rb

@@ -0,0 +1,170 @@
+#!/usr/bin/env ruby
+
+require_relative "mailtojekyll/version"
+require 'mail'
+require 'fileutils'
+require 'optparse'
+require_relative 'jekyllemail'
+require_relative 'jekyllpost'
+
+module Mailtojekyll
+  
+  # create image and post directories if they don't exist
+  def self.create_dirs(images,posts)
+    unless Dir.exists?(images)
+      FileUtils.mkdir_p(images)
+    end
+    unless Dir.exists?(posts)
+      FileUtils.mkdir_p(posts)
+    end
+  end
+  
+  # empties and initializers
+  home = Dir.pwd
+  options = {jekyll_repo: nil, retrieve: nil, test_source: nil, pop_server: nil, pop_user: nil, pop_password: nil, secret: nil, images_dir: nil, posts_dir: nil, layout: nil, categories: nil}
+
+  # command line options for cron job settings
+  parser = OptionParser.new do|opts|
+  	opts.banner = "\nRequired flags are marked with an asterisk(*)\n\nUsage: mailtojekyll.rb [options]\n\n\n"
+    
+    opts.on('-t','--test /path/to/emails', "Retrieves saved emails from this directory (local absolute path to test emails)\n\t\t\t\t     When using the test flag, the POP flags are not required\n\n") do |param|
+      options[:retrieve] = "file"
+      options[:test_source] = param
+    end
+
+    opts.on('-j','--jekyll /path/to/repo', '*Local absolute path to the git repo for your jekyll installation') do |param|
+      options[:jekyll_repo] = param
+    end
+    
+    opts.on('-s','--server pop.example.com', '*POP server for mail retrieval') do |param|
+      options[:pop_server] = param
+    end
+    
+    opts.on('-u','--user example@example.com', '*POP username (may be a full email address)') do |param|
+      options[:pop_user] = param
+    end
+    
+    opts.on('-p','--pass examplepassword', '*POP password') do |param|
+      options[:pop_password] = param
+    end
+    
+    opts.on('-S','--secret secretword', '*Secret word mailtojekyll should look for in the subject line') do |param|
+      options[:secret] = param
+    end
+    
+    opts.on('-i','--imgdir path/to/imgs', '*Image directory (path is relative to your jekyll repo root)') do |param|
+      options[:images_dir] = param
+    end
+    
+    opts.on('-P','--postdir path/to/posts', '*Posts directory (path is relative to your jekyll repo root)') do |param|
+      options[:posts_dir] = param
+    end
+
+    opts.on('-l','--layout layout', 'Jekyll template layout (default is "post")') do |param|
+      options[:layout] = param
+    end
+
+    opts.on('-c','--cats "cat 1, cat 2, cat 3"', 'Jekyll post categories (default is "latest")') do |param|
+      options[:categories] = param.split(",")
+    end
+
+  	opts.on('-h', '--help', "Displays Help\n\n") do
+  		puts opts
+  		exit
+  	end
+  end
+  
+  ARGV.push('-h') if ARGV.empty?
+
+  parser.parse!
+
+  # default to pop method unless test is set by flag
+  if options[:retrieve].to_s.empty?
+    options[:retrieve] = "pop"
+  end
+
+  if options[:retrieve] == "pop"
+    if options[:pop_server].to_s.empty? || options[:pop_user].to_s.empty? || options[:pop_password].to_s.empty?
+      raise "All POP flags are required"
+      exit
+    end
+  end
+
+  options.each_pair do |k,v|
+    if k == :layout && options[k].to_s.empty?
+      options[k] = "post"
+    elsif k == :categories && options[k].to_s.empty?
+      options[k] = "latest"
+    elsif k == :test_source && options[:retrieve] == "pop"
+      next      
+    else
+      if options[k].to_s.empty?
+        unless options[:retrieve] == "file" && (k == :pop_server || k == :pop_user || k == :pop_password)
+          raise "#{k} flag is required"
+          exit
+        end
+      end
+    end
+  end
+
+  # get files or emails from pop server
+  puts "Checking for emails..."
+  if options[:retrieve] == "file"
+    Mail.defaults do
+      retriever_method :test
+    end
+    puts File.expand_path(options[:test_source])
+    Dir["#{options[:test_source]}/*.eml"].each do |mail|
+      Mail::TestRetriever.emails << Mail.read(mail)
+    end
+  elsif options[:retrieve] == "pop"
+    # set pop retrieval defaults for the Mail gem
+    Mail.defaults do
+      mail_settings = {
+        address: options[:pop_server],
+        port: 995,
+        user_name: options[:pop_user],
+        password: options[:pop_password],
+        enable_ssl: true
+      }
+      retriever_method :pop3, mail_settings
+    end
+  end
+
+  emails = Mail.all
+  
+  if emails.empty?
+    puts "No new mails to process via #{options[:retrieve]} method" 
+    exit
+  else
+    puts "Setting up directories..."
+    # empties, initializers & setup
+    create_dirs("#{options[:jekyll_repo]}/#{options[:images_dir]}","#{options[:jekyll_repo]}/#{options[:posts_dir]}")
+    meta = { layout: options[:layout], categories: options[:categories] }
+
+    puts "Fetching mails via #{options[:retrieve]} method..."
+
+    # test for validity and create posts
+    emails.each do |email|
+    
+      # make a new email
+      email = JekyllEmail.new(email)
+      
+      # validity tests
+      begin
+        email.validate_subject
+        email.validate_secret(options[:secret])
+        email.validate_body
+      rescue
+        next
+      end
+      
+      puts "Creating post..."
+      # make a new post
+      post = JekyllPost.new(email.title, email.body, email.atts, options[:jekyll_repo], options[:images_dir], options[:posts_dir], meta)
+      
+    end
+    
+    puts "Finished!"
+  end
+end

data/lib/mailtojekyll/version.rb

@@ -0,0 +1,3 @@
+module Mailtojekyll
+  VERSION = "0.2.0"
+end

data/mailtojekyll.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mailtojekyll/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mailtojekyll"
+  spec.version       = Mailtojekyll::VERSION
+  spec.authors       = ["Kate Klemp"]
+  spec.email         = ["kklemp@misdepartment.com"]
+
+  spec.summary       = %q{Allows users to send emails to post to a jekyll blog}
+  spec.description   = %q{Uses POP3 to connect to a dedicated email address, fetch emails, and parse them into markdown posts for Jekyll to process}
+  spec.homepage      = "https://github.com/kateklemp/mailtojekyll"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: mailtojekyll
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Kate Klemp
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-07-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !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: Uses POP3 to connect to a dedicated email address, fetch emails, and
+  parse them into markdown posts for Jekyll to process
+email:
+- kklemp@misdepartment.com
+executables:
+- mailtojekyll
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/mailtojekyll
+- lib/jekyllemail.rb
+- lib/jekyllpost.rb
+- lib/mailtojekyll.rb
+- lib/mailtojekyll/version.rb
+- mailtojekyll.gemspec
+- pkg/mailtojekyll-0.1.0.gem
+- pkg/mailtojekyll-0.2.0.gem
+homepage: https://github.com/kateklemp/mailtojekyll
+licenses:
+- MIT
+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.4.6
+signing_key: 
+specification_version: 4
+summary: Allows users to send emails to post to a jekyll blog
+test_files: []