amanuensis 1.0.0

data/lib/amanuensis/cli.rb

@@ -0,0 +1,54 @@
+module Amanuensis
+  class CLI < Thor
+
+    desc "generate", "Generate a changelog"
+    option :push,         type: :array,   aliases: :p, default: [:file]
+    option :tracker,      type: :string,  aliases: :t, default: :github
+    option :code_manager, type: :string,  aliases: :c, default: :github
+    option :version,      type: :string,  aliases: :u, default: :patch
+    option :verbose,      type: :boolean, aliases: :v, default: false
+    option :github,       type: :hash,    aliases: :g
+    option :trello,       type: :hash,    aliases: :c
+    option :pivotal,      type: :hash,    aliases: :i
+    option :mail,         type: :hash,    aliases: :m
+    option :file,         type: :hash,    aliases: :f
+    def generate
+      Amanuensis.push         = options.push
+      Amanuensis.tracker      = options.tracker
+      Amanuensis.code_manager = options.code_manager
+      Amanuensis.version      = options.version
+      Amanuensis.verbose      = options.verbose
+
+      if options.github.present?
+        options.github.each do |key, value|
+          Amanuensis::Github.send "#{key}=", value
+        end
+      end
+
+      if options.file.present?
+        options.file.each do |key, value|
+          Amanuensis::File.send "#{key}=", value
+        end
+      end
+
+      if options.trello.present?
+        options.trello.each do |key, value|
+          Amanuensis::Trello.send "#{key}=", value
+        end
+      end
+
+      if options.pivotal.present?
+        options.pivotal.each do |key, value|
+          Amanuensis::Pivotal.send "#{key}=", value
+        end
+      end
+
+      Amanuensis::Mail.pony  = options.mail
+
+      Amanuensis.generate
+    rescue ValidationError => e
+      puts e.message
+    end
+
+  end
+end

data/lib/amanuensis/code_manager.rb

@@ -0,0 +1,6 @@
+module Amanuensis
+  class CodeManager
+    extend Interchange.new(:latest_release, :create_release, :pulls)
+
+  end
+end

data/lib/amanuensis/fake.rb

@@ -0,0 +1,15 @@
+require_relative 'fake/code_manager'
+require_relative 'fake/tracker'
+require_relative 'fake/push'
+
+module Amanuensis
+  module Fake
+    include Validatable
+  end
+
+  Push.register        :fake, Fake::Push.new
+  CodeManager.register :fake, Fake::CodeManager.new
+  Tracker.register     :fake, Fake::Tracker.new
+end
+
+

data/lib/amanuensis/fake/code_manager.rb

@@ -0,0 +1,18 @@
+module Amanuensis
+  module Fake
+    class CodeManager
+
+      def latest_release
+        Release.new(Date.new(2015), '1.0.0')
+      end
+
+      def create_release(_)
+      end
+
+      def pulls(_)
+        []
+      end
+
+    end
+  end
+end

data/lib/amanuensis/fake/push.rb

@@ -0,0 +1,10 @@
+module Amanuensis
+  module Fake
+    class Push
+
+      def run(_)
+      end
+
+    end
+  end
+end

data/lib/amanuensis/fake/tracker.rb

@@ -0,0 +1,11 @@
+module Amanuensis
+  module Fake
+    class Tracker
+
+      def issues(_)
+        [Issue.new(1, 'https://www.google.com', 'Issue')]
+      end
+
+    end
+  end
+end

data/lib/amanuensis/file.rb

@@ -0,0 +1,14 @@
+require_relative 'file/push'
+
+module Amanuensis
+  module File
+    include ActiveSupport::Configurable
+    include Validatable
+
+    config_accessor(:file_name) { 'Changelog.md' }
+  end
+
+  Push.register :file, File::Push.new
+end
+
+

data/lib/amanuensis/file/push.rb

@@ -0,0 +1,37 @@
+module Amanuensis
+  module File
+    class Push
+
+      def run(changelog)
+        if ::File.exists?(file_name)
+          prepend(changelog)
+        else
+          create(changelog)
+        end
+      end
+
+      private
+
+      def file_name
+        @file_name ||= File.file_name
+      end
+
+      def create(changelog)
+        f = ::File.new(file_name, 'w')
+        f.write changelog
+        f.close
+      end
+
+      def prepend(changelog)
+        ::File.open(file_name, 'r') do |orig|
+          ::File.unlink(file_name)
+          ::File.open(file_name, 'w') do |new|
+            new.write changelog
+            new.write orig.read
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/amanuensis/generator.rb

@@ -0,0 +1,87 @@
+module Amanuensis
+  class Generator
+
+    def run!
+      valid_configurations!
+
+      CodeManager.use Amanuensis.code_manager.to_sym
+      Tracker.use     Amanuensis.tracker.to_sym
+
+      changelog = build_changelog
+      result    = push_changelog(changelog)
+
+      create_release if result.all?
+    end
+
+    private
+
+    def verbose(message, &block)
+      if Amanuensis.verbose
+        logger.call message, block
+      else
+        block.call
+      end
+    end
+
+    def logger
+      @logger ||= Logger.new
+    end
+
+    def build_changelog
+      verbose "Build changelog for #{version}" do
+        Builder.new(version, latest_release.created_at).build
+      end
+    end
+
+    def push_changelog(changelog)
+      Amanuensis.push.map do |type|
+        Push.use type.to_sym
+
+        verbose "Push on #{type}" do
+          Push.run changelog
+        end
+      end
+    end
+
+    def latest_release
+      @latest_release ||= CodeManager.latest_release
+    end
+
+    def create_release
+      verbose 'Create release' do
+        CodeManager.create_release version
+      end
+    end
+
+    def valid_configurations!
+      verbose 'Valid configuration' do
+        Amanuensis.valid!
+
+        push.map(&:valid!)
+        tracker.valid!
+        code_manager.valid!
+      end
+    end
+
+    def version
+      @version = Version.new(latest_release.tag).get
+    end
+
+    def push
+      @push ||= Amanuensis.push.map(&method(:classify))
+    end
+
+    def tracker
+      @tracker ||= classify Amanuensis.tracker
+    end
+
+    def code_manager
+      @code_manager ||= classify Amanuensis.code_manager
+    end
+
+    def classify(integration)
+      "Amanuensis::#{integration.to_s.classify}".constantize
+    end
+
+  end
+end

data/lib/amanuensis/github.rb

@@ -0,0 +1,24 @@
+require 'octokit'
+
+require_relative 'github/code_manager'
+require_relative 'github/tracker'
+require_relative 'github/push'
+
+module Amanuensis
+  module Github
+    include ActiveSupport::Configurable
+    include Validatable
+
+    config_accessor(:oauth_token)
+    config_accessor(:repo)
+    config_accessor(:file_name)   { 'Changelog.md' }
+
+    validate_presence_of :oauth_token, :repo
+  end
+
+  Push.register        :github, Github::Push.new
+  CodeManager.register :github, Github::CodeManager.new
+  Tracker.register     :github, Github::Tracker.new
+end
+
+

data/lib/amanuensis/github/code_manager.rb

@@ -0,0 +1,42 @@
+module Amanuensis
+  module Github
+    class CodeManager
+
+      def latest_release
+        hash = client.latest_release(Github.repo)
+        Release.new hash.created_at, hash.tag_name
+      rescue
+        Release.new Date.new(1900), '0.0.0'
+      end
+
+      def create_release(version)
+        client.create_release(Github.repo, version, {
+          body:       "Release generated by amanuensis.",
+          draft:      false,
+          prerelease: false
+        })
+      end
+
+      def pulls(from)
+        filter(closed_pulls, from).map do |pull|
+          Pull.new pull['number'], pull['html_url'], pull['title']
+        end
+      end
+
+      private
+
+      def filter(list, from)
+        list.select { |object| object.closed_at > from.to_time }
+      end
+
+      def closed_pulls
+        client.pull_requests(Github.repo, state: 'closed')
+      end
+
+      def client
+        @client ||= Octokit::Client.new(access_token: Github.oauth_token, auto_paginate: true)
+      end
+
+    end
+  end
+end

data/lib/amanuensis/github/push.rb

@@ -0,0 +1,27 @@
+module Amanuensis
+  module Github
+    class Push
+
+      def run(changelog)
+        client = Octokit::Client.new(access_token: Github.oauth_token, auto_paginate: true)
+
+        repo_name      = Github.repo
+        default_branch = client.repo(repo_name)[:default_branch]
+        ref            = "heads/#{default_branch}"
+
+        content = (client.contents repo_name, path: Github.file_name, ref: ref, accept: 'application/vnd.github.V3.raw' rescue '')
+
+        if content.empty?
+          client.create_content(repo_name, Github.file_name, 'Creating changelog', changelog, branch: default_branch)
+        else
+          content.prepend(changelog)
+          content_object = client.contents repo_name, path: Github.file_name, ref: ref
+
+          client.update_content(repo_name, Github.file_name, 'Updating changelog', content_object.sha, content, branch: default_branch)
+        end
+      end
+
+    end
+
+  end
+end

data/lib/amanuensis/github/tracker.rb

@@ -0,0 +1,33 @@
+module Amanuensis
+  module Github
+    class Tracker
+
+      def issues(from)
+        filter(closed_issues, from).map do |issue|
+          Issue.new issue['number'], issue['html_url'], issue['title']
+        end
+      end
+
+      private
+
+      def filter(list, from)
+        list.select { |object| object.closed_at > from.to_time }
+      end
+
+      def closed_issues
+        client.list_issues(Github.repo, state: 'closed').select do |issue|
+          !issue['html_url'].include?('pull')
+        end
+      end
+
+      def closed_pulls
+        client.pull_requests(Github.repo, state: 'closed')
+      end
+
+      def client
+        Octokit::Client.new(access_token: Github.oauth_token, auto_paginate: true)
+      end
+
+    end
+  end
+end

data/lib/amanuensis/issue.rb

@@ -0,0 +1,4 @@
+module Amanuensis
+  class Issue < Struct.new(:number, :html_url, :title)
+  end
+end

data/lib/amanuensis/logger.rb

@@ -0,0 +1,26 @@
+require 'benchmark'
+
+module Amanuensis
+  class Logger
+
+    def call(message, block)
+      formatter.info "#{message}"
+      result = nil
+
+      duration = Benchmark.realtime do
+        result = block.call
+      end
+
+      formatter.info "#{message} ends after #{duration}s"
+
+      result
+    end
+
+    private
+
+    def formatter
+      @formatter ||= ::Logger.new(STDOUT)
+    end
+
+  end
+end

data/lib/amanuensis/mail.rb

@@ -0,0 +1,18 @@
+require 'pony'
+
+require_relative 'mail/push'
+
+module Amanuensis
+  module Mail
+    include ActiveSupport::Configurable
+    include Validatable
+
+    config_accessor(:pony) {{}}
+
+    validate_presence_of :pony
+  end
+
+  Push.register :mail, Mail::Push.new
+end
+
+