milestoner 17.0.0 → 17.1.0

data/lib/milestoner/configuration/transformers/citations/label.rb

@@ -3,6 +3,7 @@
 require "cff"
 require "dry/monads"
 require "pathname"
+require "refinements/hash"
 
 module Milestoner
   module Configuration
@@ -12,6 +13,8 @@ module Milestoner
         class Label
           include Dry::Monads[:result]
 
+          using Refinements::Hash
+
           def initialize key = :project_label,
                          path: Pathname.pwd.join("CITATION.cff"),
                          citation: CFF::File
@@ -20,16 +23,15 @@ module Milestoner
             @citation = citation
           end
 
-          def call(content) = Success process(content)
+          def call content
+            content.fetch_value(key) { citation.open(path).title }
+                   .then { |value| value unless String(value).empty? }
+                   .then { |value| Success content.merge!(key => value) }
+          end
 
           private
 
           attr_reader :key, :path, :citation
-
-          def process content
-            content.fetch(key) { citation.open(path).title }
-                   .then { |value| String(value).empty? ? content : content.merge!(key => value) }
-          end
         end
       end
     end

data/lib/milestoner/configuration/transformers/gems/description.rb

@@ -19,16 +19,14 @@ module Milestoner
             super(**)
           end
 
-          def call(content) = Success process(content)
+          def call content
+            content.fetch(key) { spec_loader.call(path).summary }
+                   .then { |value| Success content.merge!(key => value) }
+          end
 
           private
 
           attr_reader :key, :path
-
-          def process content
-            content.fetch(key) { spec_loader.call(path).summary }
-                   .then { |value| String(value).empty? ? content : content.merge!(key => value) }
-          end
         end
       end
     end

data/lib/milestoner/configuration/transformers/gems/label.rb

@@ -19,16 +19,15 @@ module Milestoner
             super(**)
           end
 
-          def call(content) = Success process(content)
+          def call content
+            content.fetch(key) { spec_loader.call(path).label }
+                   .then { |value| value unless value == "Undefined" }
+                   .then { |value| Success content.merge!(key => value) }
+          end
 
           private
 
           attr_reader :key, :path
-
-          def process content
-            content.fetch(key) { spec_loader.call(path).label }
-                   .then { |value| value == "Undefined" ? content : content.merge!(key => value) }
-          end
         end
       end
     end

data/lib/milestoner/configuration/transformers/gems/name.rb

@@ -19,16 +19,14 @@ module Milestoner
             super(**)
           end
 
-          def call(content) = Success process(content)
+          def call content
+            content.fetch(key) { spec_loader.call(path).name }
+                   .then { |value| Success content.merge!(key => value) }
+          end
 
           private
 
           attr_reader :key, :path
-
-          def process content
-            content.fetch(key) { spec_loader.call(path).name }
-                   .then { |value| String(value).empty? ? content : content.merge!(key => value) }
-          end
         end
       end
     end

data/lib/milestoner/configuration/transformers/gems/uri.rb

@@ -19,16 +19,15 @@ module Milestoner
             super(**)
           end
 
-          def call(content) = Success process(content)
+          def call content
+            content.fetch(key) { spec_loader.call(path).homepage_url }
+                   .then { |value| value unless String(value).empty? }
+                   .then { |value| Success content.merge!(key => value) }
+          end
 
           private
 
           attr_reader :key, :path
-
-          def process content
-            content.fetch(key) { spec_loader.call(path).homepage_url }
-                   .then { |value| String(value).empty? ? content : content.merge!(key => value) }
-          end
         end
       end
     end

data/lib/milestoner/configuration/transformers/generator/label.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "dry/monads"
+
+module Milestoner
+  module Configuration
+    module Transformers
+      module Generator
+        # Conditionally updates generator label based on gem specification.
+        class Label
+          include Import[:specification]
+          include Dry::Monads[:result]
+
+          def initialize(key = :generator_label, **)
+            @key = key
+            super(**)
+          end
+
+          def call content
+            content.fetch(key) { specification.labeled_version }
+                   .then { |value| Success content.merge!(key => value) }
+          end
+
+          private
+
+          attr_reader :key
+        end
+      end
+    end
+  end
+end

data/lib/milestoner/configuration/transformers/generator/uri.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "dry/monads"
+
+module Milestoner
+  module Configuration
+    module Transformers
+      module Generator
+        # Conditionally updates generator URI based on gem specification.
+        class URI
+          include Import[:specification]
+          include Dry::Monads[:result]
+
+          def initialize(key = :generator_uri, **)
+            @key = key
+            super(**)
+          end
+
+          def call content
+            content.fetch(key) { specification.homepage_url }
+                   .then { |value| Success content.merge!(key => value) }
+          end
+
+          private
+
+          attr_reader :key
+        end
+      end
+    end
+  end
+end

data/lib/milestoner/configuration/transformers/project/author.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "dry/monads"
+require "refinements/hash"
 
 module Milestoner
   module Configuration
@@ -11,16 +12,16 @@ module Milestoner
           include Import[:git]
           include Dry::Monads[:result]
 
+          using Refinements::Hash
+
           def initialize(key = :project_author, **)
             @key = key
             super(**)
           end
 
           def call content
-            content.fetch(key) { git.get("user.name", nil).value_or(nil) }
-                   .tap { |value| content[key] = value if value }
-
-            Success content
+            content.fetch_value(key) { git.get("user.name", nil).value_or(nil) }
+                   .then { |value| Success content.merge!(key => value) }
           end
 
           private

data/lib/milestoner/configuration/transformers/project/generator.rb

@@ -16,7 +16,14 @@ module Milestoner
             super(**)
           end
 
-          def call(content) = Success({key => specification.labeled_version}.merge!(content))
+          def call content
+            warn "`#{self.class}##{__method__}` is deprecated, use " \
+                 "`Milestoner::Configuration::Transformers::Generator::Label` or " \
+                 "`Milestoner::Configuration::Transformers::Generator::URI` instead.",
+                 category: :deprecated
+
+            Success({key => specification.labeled_version}.merge!(content))
+          end
 
           private
 

data/lib/milestoner/configuration/transformers/project/label.rb

@@ -2,6 +2,7 @@
 
 require "dry/monads"
 require "pathname"
+require "refinements/hash"
 require "refinements/string"
 
 module Milestoner
@@ -10,12 +11,11 @@ module Milestoner
       # Conditionally updates label based on current directory.
       module Project
         using Refinements::String
+        using Refinements::Hash
 
         Label = lambda do |content, key = :project_label, default: Pathname.pwd.basename.to_s|
-          content.fetch(key) { default }
-                 .tap { |value| content[key] = value.titleize }
-
-          Dry::Monads::Success content
+          content.fetch_value(key) { default }
+                 .then { |value| Dry::Monads::Success content.merge!(key => value.titleize) }
         end
       end
     end

data/lib/milestoner/configuration/transformers/project/name.rb

@@ -2,16 +2,18 @@
 
 require "dry/monads"
 require "pathname"
+require "refinements/hash"
 
 module Milestoner
   module Configuration
     module Transformers
+      # Conditionally updates name based on current directory.
       module Project
-        Name = lambda do |content, key = :project_name, default: Pathname.pwd.basename.to_s|
-          content.fetch(key) { default }
-                 .tap { |value| content[key] = value }
+        using Refinements::Hash
 
-          Dry::Monads::Success content
+        Name = lambda do |content, key = :project_name, default: Pathname.pwd.basename.to_s|
+          content.fetch_value(key) { default }
+                 .then { |value| Dry::Monads::Success content.merge!(key => value) }
         end
       end
     end

data/lib/milestoner/configuration/transformers/project/version.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "dry/monads"
+require "refinements/hash"
 
 module Milestoner
   module Configuration
@@ -10,15 +11,16 @@ module Milestoner
         class Version
           include Dry::Monads[:result]
 
+          using Refinements::Hash
+
           def initialize key = :project_version, versioner: Commits::Versioner.new
             @key = key
             @versioner = versioner
           end
 
           def call content
-            content.fetch(key) { versioner.call }
-                   .then { |value| content.merge! key => value }
-                   .then { |update| Success update }
+            content.fetch_value(key) { versioner.call }
+                   .then { |value| Success content.merge!(key => value) }
           end
 
           private

data/lib/milestoner/container.rb

@@ -45,10 +45,11 @@ module Milestoner
                       .add_transformer(Configuration::Transformers::Citations::Label.new)
                       .add_transformer(Configuration::Transformers::Citations::Description.new)
                       .add_transformer(Configuration::Transformers::Project::Author.new)
-                      .add_transformer(Configuration::Transformers::Project::Generator.new)
                       .add_transformer(Configuration::Transformers::Project::Label)
                       .add_transformer(Configuration::Transformers::Project::Name)
                       .add_transformer(Configuration::Transformers::Project::Version.new)
+                      .add_transformer(Configuration::Transformers::Generator::Label.new)
+                      .add_transformer(Configuration::Transformers::Generator::URI.new)
                       .add_transformer(Configuration::Transformers::URI::Avatar)
                       .add_transformer(Configuration::Transformers::URI::Commit)
                       .add_transformer(Configuration::Transformers::URI::Profile)

data/lib/milestoner/templates/layouts/page.adoc.erb

@@ -0,0 +1,2 @@
+<%= yield %>
+_Generated by link:<%= generator_uri %>[<%= generator_label %>]._

data/lib/milestoner/templates/layouts/page.html.erb

@@ -8,7 +8,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
     <meta name="description" content="<%= project_description %>">
     <meta name="author" content="<%= project_author %>">
-    <meta name="generator" content="<%= project_generator %>">
+    <meta name="generator" content="<%= generator_label %>">
 
     <link title="<%= project_label %>: Favorite Icon"
           rel="icon"
@@ -24,6 +24,14 @@
   </head>
 
   <body>
-    <%= yield %>
+    <main>
+      <%= yield %>
+    </main>
+
+    <footer class="footer">
+      <p class="generator">
+        Generated by <a href="<%= generator_uri %>" class="link"><%= generator_label %></a>.
+      </p>
+    </footer>
   </body>
 </html>

data/lib/milestoner/templates/layouts/page.md.erb

@@ -0,0 +1,2 @@
+<%= yield %>
+*Generated by [<%= generator_label %>](<%= generator_uri %>).*

data/lib/milestoner/templates/layouts/page.stream.erb

@@ -1 +1,2 @@
 <%= yield %>
+Generated by <%= generator_label %>.

data/lib/milestoner/templates/milestones/_commit.adoc.erb

@@ -0,0 +1 @@
+* <%= commit.emoji %> <%= commit.subject %> - _<%= commit.author.name %>_

data/lib/milestoner/templates/milestones/_commit.md.erb

@@ -0,0 +1 @@
+- <%= commit.emoji %> <%= commit.subject %> - *<%= commit.author.name %>*

data/lib/milestoner/templates/milestones/show.adoc.erb

@@ -0,0 +1,9 @@
+= <%= project_label %> <%= project_version %> (<%= date %>)
+
+<% if commits.empty? %>
+*<%= total_commits %>. <%= total_files %>. <%= total_deletions %>. <%= total_insertions %>.*
+<% else %>
+<% commits.each do |commit| %><%= commit.render :commit %><% end %>
+
+*<%= total_commits %>. <%= total_files %>. <%= total_deletions %>. <%= total_insertions %>.*
+<% end %>

data/lib/milestoner/templates/milestones/show.html.erb

@@ -5,11 +5,11 @@
       <span class="version"><%= project_version %></span>
     </h1>
 
-    <time datetime="<%= at %>" class="date"><%= date %></time>
+    <time datetime="<%= datetime %>" class="date"><%= date %></time>
   </header>
 
   <% if commits.empty? %>
-    <p class="quiet"></p>
+    <p class="dormant"></p>
   <% else %>
     <section class="body" x-data="{open: false}">
       <div class="actions">

data/lib/milestoner/templates/milestones/show.md.erb

@@ -0,0 +1,9 @@
+# <%= project_label %> <%= project_version %> (<%= date %>)
+
+<% if commits.empty? %>
+**<%= total_commits %>. <%= total_files %>. <%= total_deletions %>. <%= total_insertions %>.**
+<% else %>
+<% commits.each do |commit| %><%= commit.render :commit %><% end %>
+
+**<%= total_commits %>. <%= total_files %>. <%= total_deletions %>. <%= total_insertions %>.**
+<% end %>

data/lib/milestoner/templates/milestones/show.stream.erb

@@ -1,5 +1,9 @@
 <%= project_label %> <%= project_version %> (<%= date %>)
 
+<% if commits.empty? %>
+<%= total_commits %>. <%= total_files %>. <%= total_deletions %>. <%= total_insertions %>.
+<% else %>
 <% commits.each do |commit| %><%= commit.render :commit %><% end %>
 
 <%= total_commits %>. <%= total_files %>. <%= total_deletions %>. <%= total_insertions %>.
+<% end %>

data/lib/milestoner/templates/public/page.css.erb

@@ -1,3 +1,7 @@
+:root {
+  --font-family: Verdana;
+}
+
 .milestone {
   --border-width: 0.15rem;
   --color-black: hsl(0, 0%, 0%);
@@ -19,7 +23,6 @@
   --color-slate: hsl(211, 23%, 41%);
   --color-smoke: hsl(229, 31%, 93%);
   --color-white: hsl(0, 0%, 100%);
-  --font-family: Verdana;
 
   display: flex;
   flex-direction: column;
@@ -323,7 +326,7 @@
     }
   }
 
-  .quiet {
+  .dormant {
     align-items: center;
     display: flex;
     justify-content: center;
@@ -354,3 +357,17 @@
     }
   }
 }
+
+.footer {
+  .generator {
+    display: flex;
+    font-family: var(--font-family);
+    font-style: italic;
+    justify-content: center;
+    margin-top: 2rem;
+  }
+
+  .link {
+    padding-left: 0.3rem;
+  }
+}

data/lib/milestoner/views/context.rb

@@ -12,6 +12,8 @@ module Milestoner
       include Import[:input]
 
       delegate %i[
+        generator_label
+        generator_uri
         project_author
         project_description
         project_generator

data/lib/milestoner/views/milestones/show.rb

@@ -16,10 +16,11 @@ module Milestoner
         config.paths = Container[:configuration].build_template_paths
         config.template = "milestones/show"
 
-        expose :at, default: Time.now.utc.strftime("%Y-%m-%dT%H:%M:%S%z")
-        expose :date, default: Time.now.utc.strftime("%Y-%m-%d")
         expose :commits
         expose :uri, default: Container[:configuration].project_uri
+        expose :at, default: Time.now.utc
+        expose(:date) { |at| at.strftime "%Y-%m-%d" }
+        expose(:datetime) { |at| at.strftime "%Y-%m-%dT%H:%M:%S%z" }
 
         expose :total_commits do |commits|
           total = commits.size

data/lib/milestoner.rb

@@ -3,7 +3,7 @@
 require "zeitwerk"
 
 Zeitwerk::Loader.new.then do |loader|
-  loader.inflector.inflect "cli" => "CLI", "uri" => "URI"
+  loader.inflector.inflect "ascii_doc" => "ASCIIDoc", "cli" => "CLI", "uri" => "URI"
   loader.tag = File.basename __FILE__, ".rb"
   loader.push_dir __dir__
   loader.setup

data/milestoner.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "milestoner"
-  spec.version = "17.0.0"
+  spec.version = "17.1.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/milestoner"
@@ -25,14 +25,14 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = "~> 3.3"
   spec.add_dependency "asciidoctor", "~> 2.0"
   spec.add_dependency "cff", "~> 1.1"
-  spec.add_dependency "cogger", "~> 0.15"
+  spec.add_dependency "cogger", "~> 0.16"
   spec.add_dependency "dry-container", "~> 0.11"
   spec.add_dependency "dry-monads", "~> 1.6"
   spec.add_dependency "dry-schema", "~> 1.13"
   spec.add_dependency "etcher", "~> 1.0"
   spec.add_dependency "gitt", "~> 3.0"
   spec.add_dependency "hanami-view", "~> 2.1.0.rc2"
-  spec.add_dependency "infusible", "~> 3.0"
+  spec.add_dependency "infusible", "~> 3.1"
   spec.add_dependency "lode", "~> 1.0"
   spec.add_dependency "redcarpet", "~> 3.6"
   spec.add_dependency "refinements", "~> 12.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: milestoner
 version: !ruby/object:Gem::Version
-  version: 17.0.0
+  version: 17.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-01-06 00:00:00.000000000 Z
+date: 2024-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '0.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '0.16'
 - !ruby/object:Gem::Dependency
   name: dry-container
   requirement: !ruby/object:Gem::Requirement
@@ -169,14 +169,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: lode
   requirement: !ruby/object:Gem::Requirement
@@ -317,8 +317,10 @@ files:
 - README.adoc
 - exe/milestoner
 - lib/milestoner.rb
+- lib/milestoner/builders/ascii_doc.rb
 - lib/milestoner/builders/container.rb
 - lib/milestoner/builders/import.rb
+- lib/milestoner/builders/markdown.rb
 - lib/milestoner/builders/stream.rb
 - lib/milestoner/builders/web.rb
 - lib/milestoner/cli/actions/build/format.rb
@@ -361,6 +363,8 @@ files:
 - lib/milestoner/configuration/transformers/gems/label.rb
 - lib/milestoner/configuration/transformers/gems/name.rb
 - lib/milestoner/configuration/transformers/gems/uri.rb
+- lib/milestoner/configuration/transformers/generator/label.rb
+- lib/milestoner/configuration/transformers/generator/uri.rb
 - lib/milestoner/configuration/transformers/project/author.rb
 - lib/milestoner/configuration/transformers/project/generator.rb
 - lib/milestoner/configuration/transformers/project/label.rb
@@ -383,14 +387,20 @@ files:
 - lib/milestoner/tags/creator.rb
 - lib/milestoner/tags/publisher.rb
 - lib/milestoner/tags/pusher.rb
+- lib/milestoner/templates/layouts/page.adoc.erb
 - lib/milestoner/templates/layouts/page.html.erb
+- lib/milestoner/templates/layouts/page.md.erb
 - lib/milestoner/templates/layouts/page.stream.erb
 - lib/milestoner/templates/milestones/_avatar.html.erb
+- lib/milestoner/templates/milestones/_commit.adoc.erb
 - lib/milestoner/templates/milestones/_commit.html.erb
+- lib/milestoner/templates/milestones/_commit.md.erb
 - lib/milestoner/templates/milestones/_commit.stream.erb
 - lib/milestoner/templates/milestones/_icon.html.erb
 - lib/milestoner/templates/milestones/_profile.html.erb
+- lib/milestoner/templates/milestones/show.adoc.erb
 - lib/milestoner/templates/milestones/show.html.erb
+- lib/milestoner/templates/milestones/show.md.erb
 - lib/milestoner/templates/milestones/show.stream.erb
 - lib/milestoner/templates/public/page.css.erb
 - lib/milestoner/views/context.rb