factorix 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 970e619a2c58b6ee5c7502adc6803469accf6ee618e41e580df5f950a8b2ed15
-  data.tar.gz: 6651e0dea495831ede26d577410722d5ea08542c6ee2516772c413ddec1b7b55
+  metadata.gz: 5212e69bd41c45ceffb0fd42e889868b706b0481e6a07567c98b2cce439bb5fc
+  data.tar.gz: e2386ba4154617497efbeddea3537b58eb164dd5af66e963c325d06626536895
 SHA512:
-  metadata.gz: 6d10a143153a82c1d2b969d928ce85dd22c8c9bf95c793fe27e3287cc5f7408a00fcec47d839295d40390655667a3b1b6e1ab8e76947c9ce98eec8455f87438f
-  data.tar.gz: 2feeb57d5fc6835ee674f3c024b7ef5a4710e3b4f496dc7ada5ecc76add61e1b0fc3dcc3c7e95aea2ae57d131b28d124da04c83bb7ca1c04869067cac251e4c7
+  metadata.gz: 62ece69fa0e7028367dff967cfb6e5d93ba4c5413be84b9a38cd13466687202a9417b57c09b4b137ca26e149a556b1063d086342747ae95590ace736c492efa6
+  data.tar.gz: 8687814b5cb8f3af5e695db5765117c113de95d09fa361a87e04222f106e30abb935be426eb775751410d0181ee73c9171af9380fea5358d2ae936e9c12ec267

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.9.1] - 2026-02-20
+
+### Added
+
+- Add `mod changelog extract` command to extract a specific version's changelog section
+
 ## [0.9.0] - 2026-02-20
 
 ### Added

data/completion/_factorix.bash

@@ -172,7 +172,7 @@ _factorix() {
             ;;
           changelog)
             if [[ $cword -eq 3 ]]; then
-              COMPREPLY=($(compgen -W "add check release" -- "$cur"))
+              COMPREPLY=($(compgen -W "add check extract release" -- "$cur"))
             else
               case "${words[3]}" in
                 add)
@@ -194,6 +194,15 @@ _factorix() {
                     COMPREPLY=($(compgen -W "$global_opts --release --changelog --info-json" -- "$cur"))
                   fi
                   ;;
+                extract)
+                  if [[ "$prev" == "--changelog" ]]; then
+                    COMPREPLY=($(compgen -f -- "$cur"))
+                  elif [[ "$prev" == "--version" ]]; then
+                    COMPREPLY=($(compgen -W "Unreleased" -- "$cur"))
+                  elif [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$global_opts --version --json --changelog" -- "$cur"))
+                  fi
+                  ;;
                 release)
                   if [[ "$prev" == "--changelog" ]] || [[ "$prev" == "--info-json" ]]; then
                     COMPREPLY=($(compgen -f -- "$cur"))

data/completion/_factorix.fish

@@ -233,6 +233,7 @@ complete -c factorix -n "__factorix_using_subcommand mod sync" -ra '(__fish_comp
 # mod changelog subcommands
 complete -c factorix -n "__factorix_using_subcommand mod changelog" -a add -d 'Add an entry to MOD changelog'
 complete -c factorix -n "__factorix_using_subcommand mod changelog" -a check -d 'Validate MOD changelog structure'
+complete -c factorix -n "__factorix_using_subcommand mod changelog" -a extract -d 'Extract a changelog section for a specific version'
 complete -c factorix -n "__factorix_using_subcommand mod changelog" -a release -d 'Release Unreleased changelog section with a version'
 
 # mod changelog add options
@@ -240,6 +241,11 @@ complete -c factorix -n "__factorix_using_sub_subcommand mod changelog add" -l v
 complete -c factorix -n "__factorix_using_sub_subcommand mod changelog add" -l category -d 'Category name' -xa "'Major Features' Features 'Minor Features' Graphics Sounds Optimizations Balancing 'Combat Balancing' 'Circuit Network' Changes Bugfixes Modding Scripting Gui Control Translation Debug 'Ease of use' Info Locale Compatibility"
 complete -c factorix -n "__factorix_using_sub_subcommand mod changelog add" -l changelog -d 'Path to changelog file' -rF
 
+# mod changelog extract options
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog extract" -l version -d 'Version (X.Y.Z or Unreleased)' -ra 'Unreleased'
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog extract" -l json -d 'Output in JSON format'
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog extract" -l changelog -d 'Path to changelog file' -rF
+
 # mod changelog check options
 complete -c factorix -n "__factorix_using_sub_subcommand mod changelog check" -l release -d 'Disallow Unreleased section'
 complete -c factorix -n "__factorix_using_sub_subcommand mod changelog check" -l changelog -d 'Path to changelog file' -rF

data/completion/_factorix.zsh

@@ -293,6 +293,7 @@ _factorix_mod_changelog() {
       subcommands=(
         'add:Add an entry to MOD changelog'
         'check:Validate MOD changelog structure'
+        'extract:Extract a changelog section for a specific version'
         'release:Release Unreleased changelog section with a version'
       )
       _describe -t subcommands 'changelog subcommand' subcommands
@@ -314,6 +315,13 @@ _factorix_mod_changelog() {
             '--changelog[Path to changelog file]:changelog file:_files' \
             '--info-json[Path to info.json file]:info.json file:_files'
           ;;
+        extract)
+          _arguments \
+            $global_opts \
+            '--version[Version (X.Y.Z or Unreleased)]:version:(Unreleased)' \
+            '--json[Output in JSON format]' \
+            '--changelog[Path to changelog file]:changelog file:_files'
+          ;;
         release)
           _arguments \
             $global_opts \

data/lib/factorix/changelog.rb

@@ -89,21 +89,24 @@ module Factorix
     #
     # @return [String]
     def to_s
-      @sections.map {|section| format_section(section) }.join("\n") + "\n"
+      @sections.map {|section| "#{SEPARATOR}\n#{format_section(section)}" }.join("\n") + "\n"
     end
 
-    private def find_or_create_section(version)
-      @sections.find {|s| s.version == version } || create_section(version)
-    end
-
-    private def create_section(version)
-      section = Section[version:, date: nil, categories: {}]
-      @sections.unshift(section)
-      section
+    # Find a section by version
+    #
+    # @param version [MODVersion, String] target version (or Changelog::UNRELEASED)
+    # @return [Section]
+    # @raise [InvalidArgumentError] if the version is not found
+    def find_section(version)
+      @sections.find {|s| s.version == version } or raise InvalidArgumentError, "version not found: #{version}"
     end
 
-    private def format_section(section)
-      lines = [SEPARATOR]
+    # Format a section as plain text (without separator line)
+    #
+    # @param section [Section] changelog section
+    # @return [String]
+    def format_section(section)
+      lines = []
       lines << "Version: #{section.version}"
       lines << "Date: #{section.date}" if section.date
       section.categories.each do |cat, entries|
@@ -117,6 +120,16 @@ module Factorix
       lines.join("\n")
     end
 
+    private def find_or_create_section(version)
+      @sections.find {|s| s.version == version } || create_section(version)
+    end
+
+    private def create_section(version)
+      section = Section[version:, date: nil, categories: {}]
+      @sections.unshift(section)
+      section
+    end
+
     # Parslet grammar for Factorio changelog.txt
     class Grammar < Parslet::Parser
       rule(:newline) { str("\r\n") | str("\n") }

data/lib/factorix/cli/commands/mod/changelog/extract.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          # Extract a specific version's changelog section
+          class Extract < Base
+            desc "Extract a changelog section for a specific version"
+
+            option :version, required: true, desc: "Version (X.Y.Z or Unreleased)"
+            option :json, type: :flag, default: false, desc: "Output in JSON format"
+            option :changelog, default: "changelog.txt", desc: "Path to changelog file"
+
+            # @param version [String] version string (X.Y.Z or Unreleased)
+            # @param json [Boolean] output in JSON format
+            # @param changelog [String] path to changelog file
+            # @return [void]
+            def call(version:, json: false, changelog: "changelog.txt", **)
+              target_version = version.casecmp("unreleased").zero? ? Factorix::Changelog::UNRELEASED : MODVersion.from_string(version)
+              log = Factorix::Changelog.load(Pathname(changelog))
+              section = log.find_section(target_version)
+
+              if json
+                out.puts JSON.pretty_generate(version: section.version.to_s, date: section.date, entries: section.categories)
+              else
+                out.puts log.format_section(section)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/factorix/cli.rb

@@ -21,6 +21,7 @@ module Factorix
     register "completion", Commands::Completion
     register "mod changelog add", Commands::MOD::Changelog::Add
     register "mod changelog check", Commands::MOD::Changelog::Check
+    register "mod changelog extract", Commands::MOD::Changelog::Extract
     register "mod changelog release", Commands::MOD::Changelog::Release
     register "mod check", Commands::MOD::Check
     register "mod list", Commands::MOD::List

data/lib/factorix/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Factorix
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
   public_constant :VERSION
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: factorix
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - OZAWA Sakuro
@@ -270,6 +270,7 @@ files:
 - lib/factorix/cli/commands/man.rb
 - lib/factorix/cli/commands/mod/changelog/add.rb
 - lib/factorix/cli/commands/mod/changelog/check.rb
+- lib/factorix/cli/commands/mod/changelog/extract.rb
 - lib/factorix/cli/commands/mod/changelog/release.rb
 - lib/factorix/cli/commands/mod/check.rb
 - lib/factorix/cli/commands/mod/disable.rb