newman 0.0.1 → 0.1.0

data/README.md

@@ -1,6 +1,7 @@
-## Newman: A microframework for mail-centric applications
+## Newman: Because the mail never stops!
 
 This is going to be an experiment in building a simple framework for developing
 email-based applications. It is based on ideas from an exercise in 
 Mendicant University's January 2012 core skills course, and also serves as a
 demo application for an article in the Practicing Ruby Journal.
+

data/examples/acid_tests.rb

@@ -0,0 +1,59 @@
+require_relative "ping_pong"
+require_relative "simple_mailing_list"
+
+require "minitest/autorun"
+
+server = Newman::Server
+server.test_mode("config/test.rb")
+
+mailer = server.mailer
+
+describe "Ping Pong" do
+  it "responds to an email sent to test+ping@test.com" do
+    mailer.deliver_message(:to => "test+ping@test.com")
+    server.tick(Newman::Examples::PingPong)
+    mailer.messages.first.subject.must_equal("pong")
+  end
+
+  it "responds to an email sent to test+bad@test.com" do
+    mailer.deliver_message(:to => "test+bad@test.com")
+    server.tick(Newman::Examples::PingPong)
+    mailer.messages.first.subject.must_equal("unknown command")
+  end
+end
+
+describe "SimpleList" do
+  it "emulates a simple mailing list" do
+    mailer.deliver_message(:from => "tester@test.com",
+                           :to   => "test@test.com")
+
+    server.tick(Newman::Examples::SimpleList)
+    mailer.messages.first.subject.must_equal("You are not subscribed")
+
+    mailer.deliver_message(:from => "tester@test.com",
+                           :to   => "test+subscribe@test.com")
+
+    server.tick(Newman::Examples::SimpleList)
+    mailer.messages.first.subject.must_equal("SUBSCRIBED!")
+
+
+    mailer.deliver_message(:from    => "tester@test.com",
+                           :to      => "test@test.com",
+                           :subject => "WIN!")
+
+    server.tick(Newman::Examples::SimpleList)
+    mailer.messages.first.subject.must_equal("WIN!")
+
+    mailer.deliver_message(:from => "tester@test.com",
+                           :to   => "test+unsubscribe@test.com")
+
+    server.tick(Newman::Examples::SimpleList)
+    mailer.messages.first.subject.must_equal("UNSUBSCRIBED!")
+  end
+
+  after do
+    if File.exist?(server.settings.application.simplelist_db) 
+      File.unlink(server.settings.application.simplelist_db) 
+    end
+  end
+end

data/examples/config/dreamhost.rb.example

@@ -0,0 +1,17 @@
+imap.address   = "mail.<<DOMAIN>>"
+imap.user      = "<<USERNAME>>@<<DOMAIN>>"
+imap.password  = "<<PASSWORD>>"
+
+smtp.address   = "mail.<<DOMAIN>>"
+smtp.user      = "<<USER>>@<<DOMAIN>>"
+smtp.password  = "<<PASSWORD>>" 
+
+service.domain           = "<<DOMAIN>>"
+service.templates_dir    = "views"
+service.default_sender   = "<<USERNAME>>@<<DOMAIN>>"
+service.polling_interval = 10
+
+application.simplelist_db   = "db/lists/simple_mailing_list.store"
+application.librelist_db    = "db/lists/libre.store"
+application.ping_email      = "<<USERNAME>>+ping@<<DOMAIN>>"
+application.live_test_delay = 5

data/examples/config/gmail.rb.example

@@ -0,0 +1,21 @@
+imap.address     = "imap.gmail.com"
+imap.user        = "<<USERNAME>>@gmail.com"
+imap.password    = "<<PASSWORD>>"
+imap.ssl_enabled = true
+imap.port        = 993
+
+smtp.address           = "smtp.gmail.com"
+smtp.user              = "<<USERNAME>>@gmail.com"
+smtp.password          = "<<PASSWORD>>" 
+smtp.starttls_enabled  = true
+smtp.port              = 587
+ 
+service.domain           = "gmail.com"
+service.templates_dir    = "views"
+service.default_sender   = "<<USERNAME>>@gmail.com"
+service.polling_interval = 10
+
+application.simplelist_db   = "db/lists/simple_mailing_list.store"
+application.librelist_db    = "db/lists/libre.store"
+application.ping_email      = "<<USERNAME>>+ping@gmail.com"
+application.live_test_delay = 5

data/examples/config/test.rb

@@ -0,0 +1,7 @@
+service.domain           = "test.com"
+service.templates_dir    = "views"
+service.default_sender   = "test@test.com"
+service.polling_interval = 10
+
+application.simplelist_db = "db/lists/simple_mailing_list-test.store"
+application.librelist_db  = "db/lists/libre-test.store"

data/examples/example_helper.rb

@@ -0,0 +1 @@
+require_relative "../lib/newman"

data/examples/jester_clone.rb

@@ -0,0 +1,43 @@
+require_relative "example_helper"
+
+module Newman
+  module Examples
+    Jester = Newman::Application.new do
+      match :genre, '\S+'
+      match :title, '.*'
+      match :email, '[\w\d\._-]+@[\w\d\._-]+' #not legit, I'm sure
+
+      subject(:match, "a {genre} story '{title}'") do
+        respond :subject => "No one would consider '#{params[:title]}' to be #{params[:genre]}"
+      end
+
+      subject(:match, "what stories do you know?") do
+        respond :subject => "What stories do YOU know?"
+      end
+
+      subject(:match, "tell something {genre} to {email}") do
+        respond :subject => "Why don't you tell something #{params[:genre]} to #{params[:email]}?"
+      end
+
+      subject(:match, "tell me something {genre}") do
+        respond :subject => "Your face is #{params[:genre]}"
+      end
+
+      subject(:match, "tell me '{title}'") do
+        respond :subject => "Once upon a time there was a #{params[:title]}. THE END."
+      end
+
+      subject(:match, "help") do
+        respond :subject => "Please deposit $10, and then try again"
+      end
+
+      default do
+        respond :subject => "FAIL"
+      end
+    end
+  end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Newman::Server.simple(Newman::Examples::Jester, "config/environment.rb")
+end

data/examples/libre_list_clone.rb

@@ -0,0 +1,71 @@
+# This is a cheap and possibly buggy clone of librelist.org's automatic
+# mailing list creation
+
+require_relative "example_helper"
+
+module Newman
+  module Examples
+    LibreList = Newman::Application.new do
+      helpers do
+        def load_list(name)
+          store = Newman::Store.new(settings.application.librelist_db)
+          Newman::MailingList.new(name, store)
+        end
+      end
+
+      match :list_id, "[^.]+"
+
+      to(:tag, "{list_id}.subscribe") do
+        list = load_list(params[:list_id])
+
+        if list.subscriber?(sender)
+          respond :subject  => "ERROR: Already subscribed",
+                  :body     => template("subscribe-error"),
+                  :reply_to => "test+#{params[:list_id]}@#{domain}"
+        else
+          list.subscribe(sender)
+
+          respond :subject => "SUBSCRIBED!",
+                  :body    => template("subscribe-success"),
+                  :reply_to => "test+#{params[:list_id]}@#{domain}"
+        end
+      end
+
+      to(:tag, "{list_id}.unsubscribe") do
+        list = load_list(params[:list_id])
+
+        if list.subscriber?(sender)
+          list.unsubscribe(sender)
+
+          respond :subject => "UNSUBSCRIBED!",
+                  :body    => template("unsubscribe-success")
+        else
+          respond :subject => "ERROR: Not on subscriber list",
+                  :body    => template("unsubscribe-error"),
+                  :reply_to => "test+#{params[:list_id]}@#{domain}"
+        end
+      end
+
+      to(:tag, "{list_id}") do
+        list = load_list(params[:list_id])
+
+        if list.subscriber?(sender)
+          forward_message :bcc      => list.subscribers.join(", "),
+                          :reply_to => "test+#{params[:list_id]}@#{domain}"
+        else
+          respond :subject => "You are not subscribed",
+                  :body    => template("non-subscriber-error"),
+                  :reply_to => "test+#{params[:list_id]}@#{domain}"
+        end
+      end
+
+      default do
+        respond :subject => "FAIL"
+      end
+    end
+  end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Newman::Server.simple(Newman::Examples::LibreList, "config/environment.rb")
+end

data/examples/live_test.rb

@@ -0,0 +1,47 @@
+require_relative "ping_pong"
+
+
+settings = Newman::Settings.from_file("config/environment.rb")
+
+mailer = Newman::Mailer
+mailer.configure(settings)
+
+server = Newman::Server
+server.settings = settings
+server.mailer   = mailer
+
+mailer.deliver_message(:to   => settings.application.ping_email,
+                       :from => settings.service.default_sender)
+
+puts "Checking in..."
+settings.application.live_test_delay.downto(1) do |i|
+  print "#{i}. "
+  sleep(1)
+end
+puts
+
+Newman::Server.tick(Newman::Examples::PingPong)
+
+remaining_attempts = 3
+loop do
+  if remaining_attempts == 0
+    abort "FAIL: Did not receive mail yet"
+  else
+    incoming = mailer.messages
+    case
+    when incoming.empty?
+      sleep settings.service.polling_interval
+    when incoming.length > 1
+      abort "FAIL: More than one message in inbox"
+    else
+      if incoming.first.subject == "pong"
+        puts "OK"
+        exit
+      else
+        abort "FAIL: Expected 'pong', got #{incoming.first.subject}"
+      end
+    end
+
+    remaining_attempts -= 1
+  end
+end

data/examples/ping_pong.rb

@@ -0,0 +1,19 @@
+require_relative "example_helper"
+
+module Newman
+  module Examples
+    PingPong = Newman::Application.new do
+      to(:tag, "ping") do
+        respond(:subject => "pong")
+      end
+
+      default do
+        respond(:subject => "unknown command")
+      end
+    end
+  end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Newman::Server.simple(Newman::Examples::PingPong, "config/environment.rb")
+end

data/examples/simple_mailing_list.rb

@@ -0,0 +1,53 @@
+require_relative "example_helper"
+
+module Newman
+  module Examples
+
+    SimpleList = Newman::Application.new do
+      helpers do
+        def list
+          store = Newman::Store.new(settings.application.simplelist_db)
+          
+          Newman::MailingList.new("simple_list", store)
+        end
+      end
+
+      to(:tag, "subscribe") do
+        if list.subscriber?(sender)
+          respond :subject => "ERROR: Already subscribed",
+                  :body    => template("subscribe-error")
+        else
+          list.subscribe(sender)
+
+          respond :subject => "SUBSCRIBED!",
+                  :body    => template("subscribe-success")
+        end
+      end
+
+      to(:tag, "unsubscribe") do
+        if list.subscriber?(sender)
+          list.unsubscribe(sender)
+
+          respond :subject => "UNSUBSCRIBED!",
+                  :body    => template("unsubscribe-success")
+        else
+          respond :subject => "ERROR: Not on subscriber list",
+                  :body    => template("unsubscribe-error")
+        end
+      end
+
+      default do
+        if list.subscriber?(sender)
+          forward_message :bcc => list.subscribers.join(", ")
+        else
+          respond :subject => "You are not subscribed",
+                  :body    => template("non-subscriber-error")
+        end
+      end
+    end
+  end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  Newman::Server.simple(Newman::Examples::SimpleList, "config/environment.rb")
+end

data/examples/views/non-subscriber-error.erb

@@ -0,0 +1 @@
+Sorry, we don't have <%= sender %> on our list of subscribers. Your message was dropped.

data/examples/views/subscribe-error.erb

@@ -0,0 +1 @@
+<%= sender %> is already a subscriber of this mailing list.

data/examples/views/subscribe-success.erb

@@ -0,0 +1 @@
+Welcome to the club, pal! We've added <%= sender %> to our list of people to spam.

data/examples/views/unsubscribe-error.erb

@@ -0,0 +1,2 @@
+Goose egg! Looks like <%= sender %> isn't on our mailing list. Are you sure you
+entered the right address?

data/examples/views/unsubscribe-success.erb

@@ -0,0 +1,2 @@
+Sorry for bothering you. We've removed <%= sender %> from our list of people to
+spam.

data/lib/newman.rb

@@ -0,0 +1,17 @@
+require "pstore"
+require "ostruct"
+require "fileutils"
+
+require "mail"
+require "tilt"
+
+require_relative "newman/server"
+require_relative "newman/commands"
+require_relative "newman/application"
+require_relative "newman/controller"
+require_relative "newman/mailing_list"
+require_relative "newman/settings"
+require_relative "newman/store"
+require_relative "newman/mailer"
+require_relative "newman/test_mailer"
+require_relative "newman/version"

data/lib/newman/application.rb

@@ -0,0 +1,23 @@
+module Newman 
+  class Application
+    include Commands
+
+    def initialize(&block)
+      self.callbacks  = []
+      self.matchers   = {}
+      self.extensions = []
+
+      instance_eval(&block) if block_given?
+    end
+
+    def call(params)
+      controller = Controller.new(params)      
+      extensions.each { |mod| controller.extend(mod) }
+      trigger_callbacks(controller)
+    end
+
+    private
+
+    attr_accessor :callbacks, :default_callback, :matchers, :extensions
+  end
+end

data/lib/newman/commands.rb

@@ -0,0 +1,72 @@
+module Newman 
+  module Commands
+    def use(extension)
+      extensions << extension
+    end
+
+    def helpers(&block)
+      extensions << Module.new(&block)
+    end
+
+    def match(id, pattern)
+      matchers[id.to_s] = pattern
+    end
+
+    def to(pattern_type, pattern, &callback)
+      raise NotImplementedError unless pattern_type == :tag
+
+      pattern = compile_pattern(pattern)
+
+      matcher = lambda do
+        request.to.each do |e| 
+          md = e.match(/\+#{pattern}@#{Regexp.escape(domain)}/)
+          return md if md
+        end
+
+        false
+      end
+
+      callbacks << { :matcher  => matcher, :callback => callback }
+    end
+
+    def subject(pattern_type, pattern, &callback)
+      raise NotImplementedError unless pattern_type == :match
+
+      pattern = compile_pattern(pattern)
+
+      matcher = lambda do
+        md = request.subject.match(/#{pattern}/)
+
+        md || false
+      end
+
+      callbacks << { :matcher => matcher, :callback => callback }
+    end
+
+    def default(&callback)
+      self.default_callback = callback
+    end
+
+    def trigger_callbacks(controller)
+      matched_callbacks = callbacks.select do |e| 
+        matcher = e[:matcher]
+        e[:match_data] = controller.instance_exec(&matcher)
+      end
+
+      if matched_callbacks.empty?
+        controller.instance_exec(&default_callback) 
+      else
+        matched_callbacks.each do |e|
+          callback = e[:callback]
+          controller.params = e[:match_data] || {}
+          controller.instance_exec(&callback)
+        end
+      end
+    end
+
+    def compile_pattern(pattern)
+      pattern.gsub('.','\.')
+             .gsub(/\{(.*?)\}/) { |m| "(?<#{$1}>#{matchers[$1]})" } 
+    end
+  end
+end

data/lib/newman/controller.rb

@@ -0,0 +1,49 @@
+module Newman
+  class Controller
+    def initialize(params)
+      self.settings = params.fetch(:settings)
+      self.request  = params.fetch(:request)
+      self.response = params.fetch(:response)
+    end
+
+    attr_accessor :params
+
+    def respond(params)
+      params.each { |k,v| response.send("#{k}=", v) }
+    end
+
+    def template(name)
+      Tilt.new(Dir.glob("#{settings.service.templates_dir}/#{name}.*").first)
+          .render(self)
+    end
+
+    def sender
+      request.from.first.to_s
+    end
+
+    def domain
+      settings.service.domain 
+    end
+
+    def forward_message(params={})
+      response.from      = request.from
+      response.reply_to  = settings.service.default_sender 
+      response.subject   = request.subject
+
+      params.each do |k,v|
+        response.send("#{k}=", v)
+      end
+
+      if request.multipart?
+        response.text_part = request.text_part
+        response.html_part = request.html_part
+      else
+        response.body = request.body.to_s
+      end
+    end
+
+    private
+
+    attr_accessor :settings, :request, :response
+  end
+end

data/lib/newman/mailer.rb

@@ -0,0 +1,41 @@
+module Newman
+  Mailer = Object.new
+
+  class << Mailer
+    def configure(settings)
+      imap = settings.imap
+      smtp = settings.smtp
+
+      Mail.defaults do
+         retriever_method :imap, 
+           :address    => imap.address,
+           :user_name  => imap.user,
+           :password   => imap.password,
+           :enable_ssl => imap.ssl_enabled || false,
+           :port       => imap.port
+
+         delivery_method :smtp,
+           :address              => smtp.address,
+           :user_name            => smtp.user,
+           :password             => smtp.password,
+           :authentication       => :plain,
+           :enable_starttls_auto => smtp.starttls_enabled || false,
+           :port                 => smtp.port
+      end
+
+      def messages
+        Mail.all(:delete_after_find => true)
+      end
+
+      def new_message(*a, &b)
+        Mail.new(*a, &b)
+      end
+
+      def deliver_message(*a, &b)
+        new_message(*a, &b).deliver
+      end
+    end
+
+    attr_accessor :settings
+  end
+end

data/lib/newman/mailing_list.rb

@@ -0,0 +1,29 @@
+module Newman
+  class MailingList
+    def initialize(name, store)
+      self.name  = name
+      self.store = store
+    end
+
+    def subscribe(email)
+      store[name].create(email)
+    end
+
+    def unsubscribe(email)
+      record = store[name].find { |e| e.contents == email } 
+      store[name].destroy(record.id)
+    end
+
+    def subscriber?(email)
+      store[name].any? { |r| r.contents == email }
+    end
+
+    def subscribers
+      store[name].map { |r| r.contents } 
+    end
+
+    private
+
+    attr_accessor :name, :store
+  end
+end

data/lib/newman/server.rb

@@ -0,0 +1,45 @@
+module Newman
+  Server = Object.new  
+  
+  class << Server
+    attr_accessor :settings, :mailer
+
+    def test_mode(settings_file)
+      self.settings = Newman::Settings.from_file(settings_file)
+      self.mailer   = Newman::TestMailer
+
+      mailer.configure(settings)
+    end
+
+    def simple(apps, settings_file)
+      self.settings = Newman::Settings.from_file(settings_file)
+      self.mailer   = Newman::Mailer
+      
+      mailer.configure(settings)
+
+      run(apps)
+    end
+
+    def run(apps)
+      loop do
+        tick(apps)
+        sleep settings.service.polling_interval
+      end
+    end
+
+    def tick(apps)           
+      mailer.messages.each do |request|
+        response = mailer.new_message(:to   => request.from, 
+                                      :from => settings.service.default_sender)
+
+        Array(apps).each do |a| 
+          a.call(:request  => request, 
+                 :response => response, 
+                 :settings => settings)
+        end
+
+        response.deliver
+      end
+    end
+  end
+end

data/lib/newman/settings.rb

@@ -0,0 +1,21 @@
+module Newman 
+  class Settings
+    def self.from_file(filename)
+      new.tap { |o| o.load_config(filename) }
+    end
+  
+    def initialize
+      self.imap        = OpenStruct.new
+      self.smtp        = OpenStruct.new
+      self.service     = OpenStruct.new
+      self.application = OpenStruct.new
+    end
+
+    def load_config(filename)
+      eval(File.read(filename), binding)
+    end
+
+
+    attr_accessor :imap, :smtp, :service, :application
+  end
+end

data/lib/newman/store.rb

@@ -0,0 +1,34 @@
+require_relative "store/recorder"
+
+module Newman
+  class Store 
+    def initialize(filename)
+      FileUtils.mkdir_p(File.dirname(filename))
+
+      self.data = PStore.new(filename)
+
+      write do
+        data[:identifiers] ||= {} 
+        data[:columns]     ||= {}
+      end
+    end
+
+    attr_reader :identifiers
+
+    def [](column)
+      Recorder.new(column, self) 
+    end
+
+    def read
+      data.transaction(:read_only) { yield(data) }
+    end
+
+    def write
+      data.transaction { yield(data) }
+    end
+
+    private
+
+    attr_accessor :data
+  end
+end

data/lib/newman/store/recorder.rb

@@ -0,0 +1,63 @@
+module Newman
+  class Store
+    Record = Struct.new(:column, :id, :contents)
+
+    class Recorder
+      include Enumerable
+
+      def initialize(column, store)
+        self.column = column
+        self.store  = store
+
+        store.write do |data|
+          data[:identifiers][column] ||= 0
+          data[:columns][column]     ||= {}
+        end
+      end
+
+      def each
+        store.read do |data|
+          data[:columns][column].each do |id, contents| 
+            yield(Record.new(column, id,contents)) 
+          end
+        end
+      end
+
+      def create(contents)
+        store.write do |data| 
+          id = (data[:identifiers][column] += 1)
+          
+          data[:columns][column][id] = contents 
+
+          Record.new(column, id, contents)
+        end
+      end
+
+      def read(id)
+        store.read do |data|
+          Record.new(column, id, data[:columns][column][id])
+        end
+      end
+
+      def update(id)
+        store.write do |data|
+          data[:columns][column][id] = yield(data[:columns][column][id])
+
+          Record.new(column, id, data[:columns][column][id])
+        end
+      end
+
+      def destroy(id)
+        store.write do |data|
+          data[:columns][column].delete(id)
+        end
+
+        true
+      end
+
+      private
+
+      attr_accessor :column, :store
+    end
+  end
+end

data/lib/newman/test_mailer.rb

@@ -0,0 +1,27 @@
+module Newman
+  TestMailer = Object.new
+
+  class << TestMailer
+    def configure(settings)
+      Mail.defaults do
+        retriever_method :test
+        delivery_method  :test      
+      end
+    end
+
+    def messages
+      msgs = Marshal.load(Marshal.dump(Mail::TestMailer.deliveries))
+      Mail::TestMailer.deliveries.clear
+
+      msgs
+    end
+
+    def new_message(*a, &b)
+      Mail.new(*a, &b)
+    end
+
+    def deliver_message(*a, &b)
+      new_message(*a, &b).deliver
+    end
+  end
+end

data/lib/newman/version.rb

@@ -0,0 +1,8 @@
+module Newman
+  module Version
+    MAJOR  = 0
+    MINOR  = 1
+    TINY   = 0
+    STRING = "#{MAJOR}.#{MINOR}.#{TINY}"
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: newman
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,29 @@ autorequire:
 bindir: bin
 cert_chain: []
 date: 2012-02-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mail
+  requirement: &2171081700 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *2171081700
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: &2171081200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *2171081200
 description: A microframework for mail-centric applications
 email:
 - gregory.t.brown@gmail.com
@@ -18,6 +40,33 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/newman/application.rb
+- lib/newman/commands.rb
+- lib/newman/controller.rb
+- lib/newman/mailer.rb
+- lib/newman/mailing_list.rb
+- lib/newman/server.rb
+- lib/newman/settings.rb
+- lib/newman/store/recorder.rb
+- lib/newman/store.rb
+- lib/newman/test_mailer.rb
+- lib/newman/version.rb
+- lib/newman.rb
+- examples/acid_tests.rb
+- examples/config/dreamhost.rb.example
+- examples/config/gmail.rb.example
+- examples/config/test.rb
+- examples/example_helper.rb
+- examples/jester_clone.rb
+- examples/libre_list_clone.rb
+- examples/live_test.rb
+- examples/ping_pong.rb
+- examples/simple_mailing_list.rb
+- examples/views/non-subscriber-error.erb
+- examples/views/subscribe-error.erb
+- examples/views/subscribe-success.erb
+- examples/views/unsubscribe-error.erb
+- examples/views/unsubscribe-success.erb
 - README.md
 homepage: http://github.com/mendicant-university/newman
 licenses: []