semmy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ea4c24f886e54232fcab730802a1856eea3dc465
+  data.tar.gz: f188adf4a9d562ff9ab8554d5c1c1e71e3b25454
+SHA512:
+  metadata.gz: cad40bf070fe5fb65a8cc060ee34d0144935ea405d82828d5befc7f58b2ca9009ee9529575d92d671fc8426587b2d34741303e5900235c4724c888f70b8b1c1d
+  data.tar.gz: edd2e7e8c779b77ba615c6e7d50b1ef80bea8cd99989d9914a34caff12e0dc87af67c0f733aee6a38ced1a6c5469c1fdfb4cdf09cc30d27f24a5006de7ff897d

data/.gitignore

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

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+before_install: gem install bundler -v 1.10.5

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# CHANGELOG
+
+### Version 0.1.0
+
+2016-06-09
+
+- Initial release

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, ethnicity, 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,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in semmy.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tim Fischbach
+
+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,108 @@
+# Semmy
+
+An opinionated set of rake tasks to maintain gems following semantic
+versioning principles.
+
+## Installation
+
+Add development dependency to your gemspec:
+
+    # your.gemspec
+    s.add_development_dependency "semmy", "~> 1.0"
+
+Install gems:
+
+    $ bundle
+
+Add the tasks to your Rakefile:
+
+    # Rakefile
+    require 'semmy'
+
+    Semmy::Tasks.install
+
+## Usage
+
+Semmy defines a new task to prepare a release:
+
+    $ rake release:prepare
+
+This task:
+
+* Removes the `dev` version suffix from the version file
+* Rewrites doc tags
+* Closes the section of the new version in the changelog.
+* Commits the changes
+
+It is expected that a `release` task exists. Normally this tasks is
+provided by Bundler.
+
+    $ rake release
+
+Semmy registers additional actions which shall be
+executed right after the release:
+
+* Creates a stable branch
+* Bumps the version to the next minor version with `alpha` version
+  suffix.
+* Inserts an "Changes on master" section in the changelog.
+
+## Assumptions
+
+### Git Branches and Tags
+
+Development happens directly on `master` or by merging pull
+requests. When a release is made, a stable branch called `x-y-stable`
+is created. Semmy relies on Bundler's `release` task to create version
+tags.
+
+Patch level versions are released via backports to the stable
+branches.
+
+### Version Suffix
+
+The version in the gem's version file is increased in a separate
+commit right after release. The version always has an `alpha` suffix
+(i.e. `1.1.0.alpha`), which is only removed in the last commit
+preparing the release. That way it is easy to see in a project's
+`Gemfile.lock` whether an unreleased version is used.
+
+Patch level versions are expected to be released immediately after
+backporting bug fixes. So there are never commits with a version
+suffix on stable branches.
+
+### Doc Tags
+
+Pull requests introducing new features, are expected to markup new
+code elements with a `@since edge` doc tag. When a release is
+prepared, `edge` is replaced with the current version string. That way
+pull request authors do not have to guess, which version will merge
+their commits.
+
+### Changelog
+
+Unreleased changes are listed in a section at the top. When preparing
+a release this section is closed by placing a version heading above it
+and inserting a compare link. Changelog entries for patch level
+versions are only committed on the stable branches since they only
+backport bug fixes from master.
+
+## Example Life Cycle
+
+### Releasing a Minor Version
+
+     1:  * (master) Other important bug fix
+     2:  * Minor bug fix
+     3:  * First new feature
+     4:  * Important bug fix
+     5:  * Begin work on 1.1
+     6:  | * (1-0-stable, v1.0.2) Prepare 1.0.2 release
+     7:  | * Backport of other bug fix
+     8:  | * (v1.0.1) Prepare 1.0.1 release
+     9:  | * Backport of important bug fix
+    10:  |/
+    11:  * (v1.0.0) Prepare 1.0.0 release
+
+### Releasing a Patch Level Version
+
+

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'semmy'
+
+RSpec::Core::RakeTask.new(:spec)
+
+Semmy::Tasks.install
+
+task :default => :spec

data/bin/console

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

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rake", "rake")

data/bin/rspec

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

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/lib/semmy.rb

@@ -0,0 +1,18 @@
+require 'semmy/error'
+
+require 'semmy/changelog'
+require 'semmy/configuration'
+require 'semmy/doc_tags'
+require 'semmy/files'
+require 'semmy/gemspec'
+require 'semmy/project'
+require 'semmy/scm'
+require 'semmy/shell'
+require 'semmy/tasks'
+require 'semmy/version'
+require 'semmy/version_file'
+require 'semmy/version_string'
+
+module Semmy
+  # Your code goes here...
+end

data/lib/semmy/changelog.rb

@@ -0,0 +1,140 @@
+require 'unindent'
+
+module Semmy
+  module Changelog
+    extend self
+
+    class InsertPointNotFound < Error; end
+
+    CloseSection = Struct.new(:config, :options) do
+      def call(contents)
+        contents.dup.tap do |result|
+          result.gsub!(unreleased_section_matcher,
+                       version_header) ||
+            fail(InsertPointNotFound, <<-END.unindent)
+              Could not find insert point for section heading in:
+
+              #{contents}
+            END
+        end
+      end
+
+      private
+
+      def unreleased_section_matcher
+        /#{config.changelog_unrelased_section_heading}(\s*#{compare_link_matcher})?/
+      end
+
+      def compare_link_matcher
+        # match markdown link of the form [...](...)
+        /\[[^\]]+\]\([^)]+\)/
+      end
+
+      def version_header
+        <<-END.unindent.chomp
+          #{version_heading}
+
+          #{current_date}
+
+          #{compare_link_for_versions}
+        END
+      end
+
+      def version_heading
+        config.changelog_version_section_heading % {
+          version: options[:new_version]
+        }
+      end
+
+      def current_date
+        options[:date].strftime('%Y-%m-%d')
+      end
+
+      def compare_link_for_versions
+        Changelog.compare_link(config,
+                               homepage: options[:homepage],
+                               old_version_tag: old_version_tag,
+                               new_version_tag: new_version_tag)
+      end
+
+      def old_version_tag
+        Changelog.version_tag(options[:old_version])
+      end
+
+      def new_version_tag
+        Changelog.version_tag(options[:new_version])
+      end
+    end
+
+    InsertUnreleasedSection = Struct.new(:config, :options) do
+      def call(contents)
+        insert_before(version_line_matcher,
+                      contents,
+                      unreleased_section(contents))
+      end
+
+      private
+
+      def unreleased_section(contents)
+        <<-END.unindent
+          #{config.changelog_unrelased_section_heading}
+
+          #{compare_link_for_master(contents)}
+
+          #{config.changelog_unrelased_section_blank_slate}
+        END
+      end
+
+      def compare_link_for_master(contents)
+        Changelog.compare_link(config,
+                               homepage: options[:homepage],
+                               old_version_tag: last_version_tag(contents),
+                               new_version_tag: 'master')
+      end
+
+      def last_version_tag(contents)
+        match = contents.match(version_line_matcher)
+        match && Changelog.version_tag(match[1])
+      end
+
+      def version_line_matcher
+        Regexp.new(config.changelog_version_section_heading % {
+                     version: '([0-9.]+)'
+                   })
+      end
+
+      def insert_before(line_matcher, text, inserted_text)
+        text.dup.tap do |result|
+          unless (result.sub!(line_matcher, inserted_text + "\n\\0"))
+            fail(InsertPointNotFound,
+                 "Insert point not found.")
+          end
+        end
+      end
+    end
+
+    def version_tag(version)
+      "v#{version}"
+    end
+
+    def compare_link(config, interpolations)
+      "[Compare changes](#{compare_url(config, interpolations)})"
+    end
+
+    def compare_url(config, interpolations)
+      config.changelog_compare_url % interpolations
+        .merge(repository: repository_url(config,
+                                          interpolations[:homepage]))
+    end
+
+    private
+
+    def repository_url(config, homepage)
+      if config.github_repository
+        "https://github.com/#{config.github_repository}"
+      else
+        homepage
+      end
+    end
+  end
+end

data/lib/semmy/configuration.rb

@@ -0,0 +1,41 @@
+module Semmy
+  class Configuration
+    attr_accessor :development_version_suffix
+
+    attr_accessor :stable_branch_name
+
+    attr_accessor :prepare_commit_message
+    attr_accessor :bump_commit_message
+
+    attr_accessor :github_repository
+
+    attr_accessor :changelog_path
+    attr_accessor :changelog_version_section_heading
+    attr_accessor :changelog_compare_url
+    attr_accessor :changelog_unrelased_section_heading
+    attr_accessor :changelog_unrelased_section_blank_slate
+
+    attr_accessor :source_files_with_docs_tags
+    attr_accessor :rewritten_since_doc_tag
+
+    def initialize
+      @development_version_suffix = 'dev'
+
+      @stable_branch_name = '%{major}-%{minor}-stable'
+
+      @prepare_commit_message = 'Prepare %{version} Release'
+      @bump_commit_message = 'Bump Version to %{version}'
+
+      @changelog_path = 'CHANGELOG.md'
+      @changelog_version_section_heading = '### Version %{version}'
+      @changelog_compare_url = '%{repository}/compare/%{old_version_tag}..%{new_version_tag}'
+      @changelog_unrelased_section_heading = '### Changes on `master`'
+      @changelog_unrelased_section_blank_slate = 'None so far.'
+
+      @source_files_with_docs_tags = '{app,lib}/**/*.{js,rb,scss}'
+      @rewritten_since_doc_tag = 'edge'
+
+      yield self if block_given?
+    end
+  end
+end

data/lib/semmy/doc_tags.rb

@@ -0,0 +1,10 @@
+module Semmy
+  module DocTags
+    UpdateSinceTags = Struct.new(:placeholder, :version) do
+      def call(contents)
+        contents.gsub("@since #{placeholder}",
+                      "@since #{VersionString.minor_only(version)}")
+      end
+    end
+  end
+end

data/lib/semmy/error.rb

@@ -0,0 +1,4 @@
+module Semmy
+  class Error < StandardError
+  end
+end

data/lib/semmy/files.rb

@@ -0,0 +1,19 @@
+module Semmy
+  module Files
+    module_function
+
+    def rewrite(path, update)
+      content = File.binread(path)
+
+      File.open(path, 'wb') do |file|
+        file.write(update.call(content))
+      end
+    end
+
+    def rewrite_all(glob, update)
+      Dir.glob(glob) do |path|
+        rewrite(path, update)
+      end
+    end
+  end
+end

data/lib/semmy/gemspec.rb

@@ -0,0 +1,26 @@
+module Semmy
+  module Gemspec
+    extend self
+
+    class NotFound < Error; end
+
+    def gem_name
+      specification.name
+    end
+
+    def homepage
+      specification.homepage
+    end
+
+    private
+
+    def specification
+      Gem::Specification.load(path)
+    end
+
+    def path
+      Dir.glob('*.gemspec').first ||
+        fail(NotFound, 'Gemspec not found.')
+    end
+  end
+end

data/lib/semmy/project.rb

@@ -0,0 +1,15 @@
+module Semmy
+  module Project
+    extend self
+
+    def version
+      VersionFile.parse_version(File.read(version_file))
+    end
+
+    private
+
+    def version_file
+      VersionFile.find(Gemspec.gem_name)
+    end
+  end
+end

data/lib/semmy/scm.rb

@@ -0,0 +1,23 @@
+module Semmy
+  module Scm
+    extend self
+
+    def on_master?
+      git.current_branch == 'master'
+    end
+
+    def on_stable?(stable_branch_name)
+      !!git.current_branch.match(stable_branch_matcher(stable_branch_name))
+    end
+
+    private
+
+    def stable_branch_matcher(stable_branch_name)
+      Regexp.new(p(stable_branch_name.gsub(/%\{\w+\}/, '[0-9]+')))
+    end
+
+    def git
+      Git.open('.')
+    end
+  end
+end

data/lib/semmy/shell.rb

@@ -0,0 +1,27 @@
+require 'rainbow'
+
+module Semmy
+  module Shell
+    extend self
+
+    attr_accessor :silence
+
+    def info(text)
+      say(text, :green)
+    end
+
+    def warn(text)
+      say(text, :yellow)
+    end
+
+    def error(text)
+      say(text, :red)
+    end
+
+    private
+
+    def say(text, color)
+      puts(Rainbow(text).color(color)) unless silence
+    end
+  end
+end

data/lib/semmy/tasks.rb

@@ -0,0 +1,69 @@
+require 'rake'
+
+require 'semmy/tasks/base'
+require 'semmy/tasks/branches'
+require 'semmy/tasks/changelog_sections'
+require 'semmy/tasks/commit'
+require 'semmy/tasks/docs'
+require 'semmy/tasks/versioning'
+
+module Semmy
+  module Tasks
+    include Rake::DSL
+    extend self
+
+    def install
+      config = Configuration.new
+      yield config if block_given?
+
+      namespace 'semmy' do
+        Versioning.new(config)
+        Docs.new(config)
+        ChangelogSections.new(config)
+        Commit.new(config)
+        Branches.new(config)
+      end
+
+      desc 'Prepare minor or major release'
+      task 'release:prepare:master' => [
+        'semmy:versioning:remove_development_version_suffix',
+        'semmy:docs:rewrite_since_tags',
+        'semmy:changelog:close_section',
+        'semmy:commit:prepare'
+      ]
+
+      desc 'Prepare patch level release'
+      task 'release:prepare:stable' => [
+        'semmy:changelog:close_section',
+        'semmy:commit:prepare'
+      ]
+
+      desc 'Prepare release'
+      task 'release:prepare' do
+        if Scm.on_master?
+          Rake.application['release:prepare:master'].invoke
+        elsif Scm.on_stable?(config.stable_branch_name)
+          Rake.application['release:prepare:stable'].invoke
+        end
+      end
+
+      task 'release:after:master' => [
+        'semmy:branches:create_stable',
+        'semmy:versioning:bump_minor',
+        'semmy:changelog:add_unreleased_section',
+        'semmy:commit:bump'
+      ]
+
+      desc 'Prepare repository for development of next verion'
+      task 'release:after' do
+        if Scm.on_master?
+          Rake.application['release:after:master'].invoke
+        end
+      end
+
+      task 'release' do
+        Rake.application['release:after'].invoke
+      end
+    end
+  end
+end

data/lib/semmy/tasks/base.rb

@@ -0,0 +1,19 @@
+module Semmy
+  module Tasks
+    class Base
+      include Rake::DSL
+
+      attr_reader :config
+
+      def initialize(config = nil)
+        @config = config || Configuration.new
+        yield(@config) if block_given?
+
+        define
+      end
+
+      def define
+      end
+    end
+  end
+end

data/lib/semmy/tasks/branches.rb

@@ -0,0 +1,24 @@
+require 'git'
+
+module Semmy
+  module Tasks
+    class Branches < Base
+      def define
+        namespace 'branches' do
+          task 'create_stable' do
+            name = config.stable_branch_name %
+              VersionString.components(Project.version)
+
+            Shell.info("Creating stable branch #{name}...")
+
+            git.branch(name).create
+          end
+        end
+
+        def git
+          Git.open('.')
+        end
+      end
+    end
+  end
+end

data/lib/semmy/tasks/changelog_sections.rb

@@ -0,0 +1,34 @@
+module Semmy
+  module Tasks
+    class ChangelogSections < Base
+      def define
+        namespace 'changelog' do
+          task 'close_section' do
+            new_version = Project.version
+            old_version = VersionString.previous_minor(new_version)
+            homepage = Gemspec.homepage
+
+            Shell.info("Inserting #{new_version} section " \
+                       "in #{config.changelog_path}...")
+
+            Files.rewrite(config.changelog_path,
+                          Changelog::CloseSection.new(config,
+                                                      new_version: new_version,
+                                                      old_version: old_version,
+                                                      homepage: homepage,
+                                                      date: Date.today))
+          end
+
+          task 'add_unreleased_section' do
+            Shell.info('Inserting unreleased section ' \
+                       "in #{config.changelog_path}...")
+
+            Files.rewrite(config.changelog_path,
+                          Changelog::InsertUnreleasedSection.new(config,
+                                                                 homepage: Gemspec.homepage))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/semmy/tasks/commit.rb

@@ -0,0 +1,31 @@
+require 'git'
+
+module Semmy
+  module Tasks
+    class Commit < Base
+      def define
+        namespace 'commit' do
+          task 'prepare' do
+            Shell.info('Creating prepare commit...')
+
+            git.commit_all(config.prepare_commit_message % {
+                             version: Project.version
+                           })
+          end
+
+          task 'bump' do
+            Shell.info('Creating bump commit...')
+
+            git.commit_all(config.bump_commit_message % {
+                             version: Project.version
+                           })
+          end
+        end
+
+        def git
+          Git.open('.')
+        end
+      end
+    end
+  end
+end

data/lib/semmy/tasks/docs.rb

@@ -0,0 +1,20 @@
+require 'git'
+
+module Semmy
+  module Tasks
+    class Docs < Base
+      def define
+        namespace 'docs' do
+          task 'rewrite_since_tags' do
+            Shell.info("Rewriting @since #{config.rewritten_since_doc_tag} " \
+                       "doc tags in #{config.source_files_with_docs_tags}...")
+
+            Files.rewrite_all(config.source_files_with_docs_tags,
+                              DocTags::UpdateSinceTags.new(config.rewritten_since_doc_tag,
+                                                           Project.version))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/semmy/tasks/versioning.rb

@@ -0,0 +1,35 @@
+module Semmy
+  module Tasks
+    class Versioning < Base
+      def define
+        namespace 'versioning' do
+          task 'remove_development_version_suffix' do
+            new_version = VersionString
+              .remove_suffix(Project.version, config.development_version_suffix)
+
+            Shell.info("Removing #{config.development_version_suffix} suffix " \
+                       'from version.')
+
+            rewrite_gemspec_version(new_version)
+          end
+
+          task 'bump_minor' do
+            new_version = VersionString
+              .bump_minor(Project.version, config.development_version_suffix)
+
+            Shell.info("Bumping version to #{new_version}.")
+
+            rewrite_gemspec_version(new_version)
+          end
+        end
+      end
+
+      private
+
+      def rewrite_gemspec_version(new_version)
+        Files.rewrite(VersionFile.find(Gemspec.gem_name),
+                      VersionFile::Update.new(new_version))
+      end
+    end
+  end
+end

data/lib/semmy/version.rb

@@ -0,0 +1,3 @@
+module Semmy
+  VERSION = '0.1.0'
+end

data/lib/semmy/version_file.rb

@@ -0,0 +1,37 @@
+module Semmy
+  module VersionFile
+    extend self
+
+    class NotFound < Error; end
+
+    class ConstantNotFound < Error; end
+
+    class UpdateFailed < Error; end
+
+    def find(gem_name)
+      gem_name_matcher = gem_name.gsub(/[_-]/, '[/_-]')
+
+      Dir.glob('lib/**/version.rb').detect do |file_name|
+        file_name =~ %r{lib/#{gem_name_matcher}/version.rb}
+      end || fail(NotFound, 'No version file found.')
+    end
+
+    def parse_version(contents)
+      match = contents.match(/VERSION\s*=\s*['"]([^'"]+)['"]/) ||
+        fail(ConstantNotFound, 'Could not find version constant')
+
+      match[1]
+    end
+
+    Update = Struct.new(:new_version) do
+      def call(contents)
+        contents.dup.tap do |result|
+          result.gsub!(/VERSION\s*=\s*(['"])[^']+['"]/,
+                       "VERSION = \\1#{new_version}\\1") ||
+            fail(UpdateFailed,
+                 "Could not update version to #{new_version} in\n\n#{contents}\n\n")
+        end
+      end
+    end
+  end
+end

data/lib/semmy/version_string.rb

@@ -0,0 +1,60 @@
+module Semmy
+  module VersionString
+    extend self
+
+    class SuffixNotFound < Error; end
+
+    class UnexpectedSuffix < Error; end
+
+    class NoPreviousMinor < Error; end
+
+    def remove_suffix(version, suffix)
+      new_version = version.dup
+
+      unless new_version.gsub!(/.#{suffix}$/, '')
+        fail(SuffixNotFound, "Suffix #{suffix} not found in #{version}")
+      end
+
+      new_version
+    end
+
+    def bump_minor(version, suffix)
+      components = version.split('.')
+
+      unless components.last =~ /^[0-9]+$/
+        fail(UnexpectedSuffix, "Expected a version without suffix, found #{version}.")
+      end
+
+      components.map!(&:to_i)
+      components[1] += 1
+      components << suffix
+
+      components.join('.')
+    end
+
+    def previous_minor(version)
+      components = version.split('.').map(&:to_i)
+
+      if components[1] == 0
+        fail(NoPreviousMinor, "Cannot get previous minor of #{version}.")
+      end
+
+      components[1] -= 1
+      components.join('.')
+    end
+
+    def minor_only(version)
+      version.split('.')[0..1].join('.')
+    end
+
+    def components(version)
+      components = version.split('.')
+
+      {
+        major: components[0],
+        minor: components[1],
+        patch: components[2]
+      }
+    end
+  end
+end

data/semmy.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'semmy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "semmy"
+  spec.version       = Semmy::VERSION
+  spec.authors       = ["Tim Fischbach"]
+  spec.email         = ["mail@timfischbach.de"]
+
+  spec.summary       = 'Rake tasks for a semantic versioning of gems'
+  spec.homepage      = 'https://github.com/tf/semmy'
+  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_dependency 'git', '~> 1.3'
+  spec.add_dependency 'unindent', '~> 1.0'
+  spec.add_dependency 'rainbow', '~> 2.1'
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: semmy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tim Fischbach
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-06-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: unindent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- mail@timfischbach.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/rake
+- bin/rspec
+- bin/setup
+- lib/semmy.rb
+- lib/semmy/changelog.rb
+- lib/semmy/configuration.rb
+- lib/semmy/doc_tags.rb
+- lib/semmy/error.rb
+- lib/semmy/files.rb
+- lib/semmy/gemspec.rb
+- lib/semmy/project.rb
+- lib/semmy/scm.rb
+- lib/semmy/shell.rb
+- lib/semmy/tasks.rb
+- lib/semmy/tasks/base.rb
+- lib/semmy/tasks/branches.rb
+- lib/semmy/tasks/changelog_sections.rb
+- lib/semmy/tasks/commit.rb
+- lib/semmy/tasks/docs.rb
+- lib/semmy/tasks/versioning.rb
+- lib/semmy/version.rb
+- lib/semmy/version_file.rb
+- lib/semmy/version_string.rb
+- semmy.gemspec
+homepage: https://github.com/tf/semmy
+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.2.5
+signing_key: 
+specification_version: 4
+summary: Rake tasks for a semantic versioning of gems
+test_files: []