renogen 1.0.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 169e26c4cd97a2fb31a22eada063fca3a25a57cf
-  data.tar.gz: 5200eff043775217ae1cc7d5e91ec704570346a7
+SHA256:
+  metadata.gz: 0d53b818e9ebb6f258fd39cfbe9c83acd9e9818fb49a288c11c86afe38e0f387
+  data.tar.gz: 1960bf0af875ef179e1f34826caf9ef56e7dec676c5bd7db44f9c05151448e53
 SHA512:
-  metadata.gz: 3b52c38810a2b055fa83fe9ece7203b3ba9fd9360c0fefd49ca4e7fdd89d7691b899a7bb652367368ff6086974dc0e4b2038405923878a736c9e5b448519c87e
-  data.tar.gz: a5e624d7fffa82c23fd4413ae76a1053133034e2c0b837664b71f2c5e3d0ce0972865ada62346885be4c23183050c12fd923d0f5d1228ed3c7a482c56d79037d
+  metadata.gz: 579845fd96294be9ef4a70ac58f7c9b6097951b8343013a7fa98f1ffc7ef42758ffa8ce7bd7b3adfb5eea23530f237032c792e887d0296f7a72e98fac2dc1203
+  data.tar.gz: aaa2da2cdaaa0c7ac48e3d7f8dcfbbdc82230d643c6d660a4d8453c5d8aa5eb03e84546afd7e1f154440dadabf588b14e9c9d17f1fff651f1a41cf2a047c78bf

data/README.md

@@ -2,35 +2,76 @@
 
 Renogen or Re(lease) No(tes) Gen(erator) is a development tool to separate feature notes from product versions.
 
-### Installation
+This renogen can not do and will have to be reviewed manually
+
+- Order the notes in the orrect order (e.g. if a task has to be run before/after something else)
+- Remove Duplicate notes that might be added (e.g. 2 tickets might want to run the same task)
+
+## Contents
+
+- [Installation](#Installation)
+- [Usage](#Usage)
+- [Configuration](#Configuration)
+- [Frequently Asked Questions](#FAQ)
+- [License](#License)
+
+<a name="Installation"></a>
+## Installation
 
 To install Renogen, use the following command:
 
-`$ gem install renogen`
+```
+$ gem install renogen
+```
+
+or add the following to your Gemfile when using Bundler
+
+```
+gem 'renogen', require: false, group: :development
+```
+
+and run
+
+```
+bundle install
+```
+
+If you would prefer you can use a prebuild docker image.
+
+Example:
 
-or add the following to your Gemfile
+```bash
+$ docker run --rm -v `pwd`/.renogen:/.renogen:ro -v `pwd`/change_log:/change_log/ ddazza/renogen <CMD>
+```
 
-`gem 'renogen', :require => false, :group => :development`
+Now, you may initialize your repository with a `change_log` directory and a basic `.renogen` config file:
 
-`$ renogen init # optional  Creates directory for notes`
-`$ renogen --help # List available options
+```
+$ renogen init` # optional  Creates directory for notes
+```
 
-### Usage
+<a name="Usage"></a>
+## Usage
 
 To generate your notes run the following command
 
-`$ renogen <VERSION> # e.g v1.2.1`
+```
+$ renogen <VERSION> # e.g v1.2.1
+```
 
 Unfortunatly renogen cant write documentation for your change.
 By default renogen uses the yaml file stratagy to extract your notes
 
-`$ renogen --help # list available command options`
+```
+$ renogen --help # list available command options
+```
+
+### Adding YAML feature notes
 
-#### Adding YAML feature notes
+You can create a new file within the 'next' version folder (default: `change_log/next/`) manually:
 
-Create a new file within the 'next' version folder(default:'change_log/next/')
+Example feature note:
 
-Example feature note
 ```yaml
 # change_log/next/example.yml
 my_formatted_single_line:
@@ -52,31 +93,129 @@ my_list:
   - e.g. run this as well
 ```
 
-#### Usage Examples
+You can also use the `new` command to create a feature note YAML file in the 'next' version folder:
 
-Prepend your notes to a changelog file(TODO make command simple)
+```
+$ renogen new TICKET_NAME # creates ./change_log/next/TICKET_NAME.yml`
+```
+
+### Usage Examples
+
+Prepend your notes to a changelog file (TODO make command simple)
 
-`$ renogen --format markdown v1.2.1 > CHANGELOG.md | cat - CHANGELOG > CHANGELOG.tmp && mv CHANGELOG.tmp CHANGELOG`
+```
+$ renogen --format markdown v1.2.1 > CHANGELOG.md | cat - CHANGELOG > CHANGELOG.tmp && mv CHANGELOG.tmp CHANGELOG
+```
 
 Writes notes to html file
 
-`$ renogen --format html v1.2.1 > v1_2_1.html`
+```
+$ renogen --format html v1.2.1 > v1_2_1.html
+```
+
+Writes note to csv file
+
+`$ renogen --format csv v1.2.1 > v1_2_1.csv`
 
 Print all notes since v1.0.0 as text
 
-`$ renogen --format text -l v1.0.0 v1.2.1`
+```
+$ renogen --format text -l v1.0.0 v1.2.1
+```
+
+<a name="Configuration"></a>
+## Configuration
+
+Renogen tries to read the file `.renogen` in the working directory to load its configuration. The file is in YAML format
+with the following keys:
+
+|       key            | meaning | default value | configuration example |
+|----------------------|----------|---------------|-----------------------|
+| `single_line_format` | A template for generating a single line of text from a YAML dictionary in a feature note file. Each dictionary key in the template gets replaced by the value for that key. | `summary (see link)` | `[#ticket](https://github.com/renogen/issue/ticket): summary` |
+| `supported_keys`     | YAML dictionary keys allowed in dictionary feature notes. Ignored for dictionaries where rules apply. | `%w[identifier summary link]` | |
+| `input_source`       | The format of the feature note files. Currently, only `yaml` is supported. | `yaml` | |
+| `output_format`      | The default output format when generating release notes. | `markdown` | `html` |
+| `changelog_path`     | The directory where the feature note files are stored. | `./change_log` | `./doc/src/changes` |
+| `default_headings`   | The headings/group names that will be printed into a feature note file created by the `new` command. Ignored when there is a rule defined for the given file name. | `%w[Summary Detailed Tasks]` | `%w[Title Description Deployment]` |
+| `allowed_values`     | Allowed values for default headings.  See [Allowed Values](#AllowedValues). | `{}` (none) |  |
+
+<a name="AllowedValues"></a>
+## Allowed Values
+
+Allowed values enables you to specify a range of allowed values for any default heading. This can be an array, string or
+regular expression:
+
+```yaml
+default_headings:
+  - Products
+  - Countries
+  - User Facing
+Products: !ruby/regexp '/\b(Foo|Bar)\b/'
+Countries: [UK, AUS, FR]
+User Facing: Yes
+```
+
+<a name="FAQ"></a>
+## Frequently Asked Questions
+
+### Custom formatter
+
+You can use your own formatter quite easily.
+
+For example, put this in `lib/my_project/renogen_formatter.rb`:
 
-### Configuration
+```ruby
+require 'renogen/formatters'
 
-TODO
-* How to set configuration with `.renogen` file
-* How to change formatted single line
+class MyProject::RenogenFormatter < Renogen::Formatters::Base
+  register :xml
+
+  def write_header(header)
+    "<release><header>#{header}</header>"
+  end
+
+  def write_group(group)
+    "<group><title>#{group}</title>"
+  end
+
+  def write_group_end
+    "</group>"
+  end
+
+  def write_change(change)
+    "<change>#{change}</change>"
+  end
+
+  def write_footer(*)
+    "</release>"
+  end
+end
+```
+
+You have to include that file when running renogen:
+
+```
+$ renogen -I. -Rlib/my_project/renogen_formatter 1.2.3
+```
+
+### Why does renogen not use renogen
+
+The amount of activity and contributes for this project is small and so it is more practical to use a text file.
+
+### How can I run from source
+
+```
+$ git clone git@github.com:DDAZZA/renogen.git
+$ cd ./renogen/
+$ bundle install
+$ bundle exec ./bin/renogen test
+```
 
-### License
+## License
 
 Renogen is a programming tool to generate a log of source code changes
 
-Copyright (C) 2015 David Elliott
+Copyright (C) 2015-2020 David Elliott
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by

data/lib/renogen/change_log.rb

@@ -5,5 +5,6 @@ module Renogen
     require_relative 'change_log/group'
     require_relative 'change_log/writer'
     require_relative 'change_log/model'
+    require_relative 'change_log/validator'
   end
 end

data/lib/renogen/change_log/item.rb

@@ -3,9 +3,10 @@ module Renogen
     # Object to represent single change item
     class Item
       attr_accessor :change
-      attr_reader :group_name
+      attr_reader :group_name, :ticket_id
 
-      def initialize(group_name, change, options={})
+      def initialize(ticket_id, group_name, change, options={})
+        @ticket_id = ticket_id
         @group_name = group_name
         @change = change
       end
@@ -14,12 +15,14 @@ module Renogen
       #
       # @return [String]
       def to_s
+        return '' unless change
+
         case change.class.to_s
-        when String.to_s
+        when 'String'
           format_multiline(change)
-        when Hash.to_s
+        when 'Hash'
           format_oneline(change)
-        when Array.to_s
+        when 'Array'
           format_array(change)
         else
           raise TypeError
@@ -45,12 +48,12 @@ module Renogen
       end
 
       def format_array(change)
-        # TODO should return a string
+        # TODO: should return a string
         change
       end
 
       def format_oneline(change)
-        # TODO Refactor
+        # TODO: Refactor
         string = config.single_line_format.downcase.gsub('\n', '\n  ')
         config.supported_keys.each do |key|
           string = string.gsub(key, '#{change[\'' + key + '\']}')

data/lib/renogen/change_log/model.rb

@@ -5,20 +5,14 @@ module Renogen
     # Object to represent a Changelog/release notes
     class Model
       attr_reader :items
-      attr_accessor :version
+      attr_accessor :version, :date
 
       def initialize(options={})
         @version = options[:version]
+        @date = options[:date] || Date.today
         @items = []
       end
 
-      # The title for the change log output
-      #
-      # @return [String]
-      def header
-        "#{version} (#{Date.today})"
-      end
-
       # @return [Hash<group_name: change>]
       def groups
         items.inject({}) do |hash, change|
@@ -28,6 +22,15 @@ module Renogen
         end
       end
 
+      # @return [Hash<ticket id: string>]
+      def tickets
+        items.inject({}) do |hash, change|
+          hash[change.ticket_id] ||= {}
+          hash[change.ticket_id][change.group_name] = change.to_s
+          hash
+        end
+      end
+
       # Adds a change to the changelog
       #
       # @param change [Renogen::ChangeLog::Item]

data/lib/renogen/change_log/validator.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Renogen
+  module ChangeLog
+    # Validates the change log
+    class Validator
+      def initialize(formatter)
+        @formatter = formatter
+        @validations = formatter.options['allowed_values']
+      end
+
+      # Validates the change log
+      #
+      # @param changelog [ChangeLog::Model]
+      def validate!(changelog)
+        validate_headings(changelog)
+      end
+
+      protected
+
+      attr_reader :formatter, :validations
+
+      def validate_headings(changelog)
+        return if validations.nil?
+        return if changelog.items.none? { |item| validations.key?(item.group_name) }
+
+        validate_properties(changelog)
+      end
+
+      private
+
+      def validate_properties(changelog)
+        invalid_items = []
+        validations.each do |heading, values|
+          items_to_select = changelog.items.select { |log| log.group_name == heading }
+          invalid_values = items_to_select.map do |i|
+            changes = changes_to_validate(i.change)
+            next changes - values if values.is_a?(Array)
+            next unless values.is_a?(Regexp)
+
+            changes.detect { |c| c !~ values } # return anything that does not match the regexp.
+          end
+
+          invalid_values = invalid_values.flatten.compact.uniq # remove duplicates and nils
+          next if invalid_values.empty?
+
+          invalid_items << { invalid_value: invalid_values, valid_values: values, group_name: heading }
+        end
+
+        invalid_items = invalid_items.flatten
+        raise(Renogen::Exceptions::InvalidItemFound, invalid_items) unless invalid_items.empty?
+      end
+
+      def changes_to_validate(change)
+        return [change] if change.is_a? String
+
+        change
+      end
+    end
+  end
+end

data/lib/renogen/change_log/writer.rb

@@ -10,9 +10,29 @@ module Renogen
       #
       # @param changelog [ChangeLog::Model]
       def write!(changelog)
-        puts formatter.write_header(changelog.header)
+        puts formatter.write_header(formatter.header(changelog)) unless formatter.write_header(formatter.header(changelog)).nil?
+        if formatter.table_formatter?
+          write_by_table!(changelog)
+        else
+          write_by_group!(changelog)
+        end
+        puts formatter.write_footer(changelog) unless formatter.write_footer(changelog).nil?
+      end
+
+      # Writes out the change log by group
+      #
+      # @param changelog [ChangeLog::Model]
+      def write_by_group!(changelog)
         output_groups(changelog.groups)
-        puts formatter.write_footer(changelog)
+      end
+
+      # Writes out the change log by item
+      #
+      # @param changelog [ChangeLog::Model]
+      def write_by_table!(changelog)
+        changelog.tickets.each do |_, ticket|
+          puts formatter.write_change(ticket)
+        end
       end
 
       protected
@@ -23,7 +43,7 @@ module Renogen
         if change.list?
           change.each { |item| puts formatter.write_change(item) }
         else
-          puts formatter.write_change(change.to_s)
+          puts formatter.write_change(change.to_s) if change.to_s.size > 0
         end
       end
 

data/lib/renogen/cli.rb

@@ -10,32 +10,38 @@ module Renogen
     # @param args [Array]
     def self.run(args)
       return init if args.first == 'init'
+      return new_ticket(args[1]) if args.first == 'new'
+
       param_parser = ParamParser.new(args)
       version, options = param_parser.parse
+      config_instance = Config.instance
 
-      format = options['format'] || Config.instance.output_format
-      source = options['source'] || Config.instance.input_source
-      options['changelog_path'] ||= Config.instance.changelog_path
-      options['old_version'] ||= Config.instance.changelog_path
+      format = options['format'] || config_instance.output_format
+      source = options['source'] || config_instance.input_source
+      options['changelog_path'] ||= config_instance.changelog_path
+      options['old_version'] ||= config_instance.changelog_path
+      options['release_date'] ||= Date.today
+      options['allowed_values'] ||= config_instance.validations
 
       begin
         generator = Renogen::Generator.new(version, source, format, options)
         generator.generate!
       rescue Renogen::Exceptions::Base => e
         puts e.message
-        exit -1
+        exit 1
       end
     end
 
     # Initialize the current working directory with an example change
     def self.init
+      # TODO: Refactor to use Config.instance.changelog_path
       Dir.mkdir('./change_log')
       puts "Created './change_log/'"
 
       Dir.mkdir('./change_log/next')
       puts "Created './change_log/next/'"
 
-      File.open("./change_log/next/added_renogen_gem.yml", 'w') do |f|
+      File.open('./change_log/next/added_renogen_gem.yml', 'w') do |f|
         f.write("Summary:\n")
         f.write("  identifier: renogen\n")
         f.write("  link: https://github.com/DDAZZA/renogen\n")
@@ -52,10 +58,25 @@ module Renogen
 
       puts "Created './change_log/next/added_renogen_gem.yml'"
 
-      File.open(".renogen", 'w') do |f|
+      File.open('.renogen', 'w') do |f|
         f.write("changelog_path: './change_log/'\n")
       end
       puts "Created '.renogen'"
     end
+
+    # Creates a new template file
+    #
+    # @param ticket_name [String]
+    def self.new_ticket(ticket_name)
+      raise 'You need to provide a ticket_name' if ticket_name.nil?
+
+      file_path = File.join(Config.instance.changelog_path, 'next', "#{ticket_name}.yml")
+      File.open(file_path, 'w') do |f|
+        Config.instance.default_headings.each do |h|
+          f.write("#{h}:\n")
+        end
+      end
+      puts "Created '#{file_path}'"
+    end
   end
 end