factorix 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5212e69bd41c45ceffb0fd42e889868b706b0481e6a07567c98b2cce439bb5fc
-  data.tar.gz: e2386ba4154617497efbeddea3537b58eb164dd5af66e963c325d06626536895
+  metadata.gz: 1f669f6ec36e75ef8f9720e7e09337627d56bc84453233484157643f22a55aa9
+  data.tar.gz: 2029ef6d075978429ddd533c7ba5aa68eb0c16bf77e9c1802bcbfd159844f767
 SHA512:
-  metadata.gz: 62ece69fa0e7028367dff967cfb6e5d93ba4c5413be84b9a38cd13466687202a9417b57c09b4b137ca26e149a556b1063d086342747ae95590ace736c492efa6
-  data.tar.gz: 8687814b5cb8f3af5e695db5765117c113de95d09fa361a87e04222f106e30abb935be426eb775751410d0181ee73c9171af9380fea5358d2ae936e9c12ec267
+  metadata.gz: f9a17f3a9a83fdf498555deac57a3d9d99b0b33d77a36c8242e5d78e8e85923ed535f4457bf5976e2e3f1b7209214c84e4eda1f9bf00425657b1c8eb471f34de
+  data.tar.gz: 0e6c5bfc9e7a09d4ff3529e976b0f7f90cba03d49d2e98ef70ae9eae07031e1c2de90e7f4235dbeb8d68b32d852afa5a674ecc76bcfb048684f9e229454c9c83

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.10.0] - 2026-02-21
+
+### Changed
+
+- Refactor `License` to use flyweight pattern for standard licenses with `.for(id)` method
+- Add `.identifiers` class method to `Category`, `License`, and `Tag`
+- Replace `License.identifier_values` with `License.identifiers`
+
 ## [0.9.1] - 2026-02-20
 
 ### Added

data/doc/factorix.1

@@ -184,6 +184,53 @@ Skip confirmation prompts.
 .TP
 .BR \-j ", " \-\-jobs =\fIVALUE\fR
 Number of parallel downloads (default: 4).
+.SS factorix mod changelog add ENTRY
+Add an entry to MOD changelog.
+.TP
+.BR \-\-version =\fIVALUE\fR
+Version (X.Y.Z or Unreleased, default: Unreleased).
+.TP
+.BR \-\-category =\fIVALUE\fR
+Category (e.g., Features, Bugfixes). Required.
+.TP
+.BR \-\-changelog =\fIVALUE\fR
+Path to changelog file (default: changelog.txt).
+.SS factorix mod changelog extract
+Extract a changelog section for a specific version.
+.TP
+.BR \-\-version =\fIVALUE\fR
+Version (X.Y.Z or Unreleased). Required.
+.TP
+.B \-\-json
+Output in JSON format.
+.TP
+.BR \-\-changelog =\fIVALUE\fR
+Path to changelog file (default: changelog.txt).
+.SS factorix mod changelog check
+Validate MOD changelog structure.
+.TP
+.B \-\-release
+Disallow Unreleased section.
+.TP
+.BR \-\-changelog =\fIVALUE\fR
+Path to changelog file (default: changelog.txt).
+.TP
+.BR \-\-info\-json =\fIVALUE\fR
+Path to info.json file (default: info.json).
+.SS factorix mod changelog release
+Convert Unreleased changelog section to a versioned section.
+.TP
+.BR \-\-version =\fIVALUE\fR
+Version (X.Y.Z, default: from info.json).
+.TP
+.BR \-\-date =\fIVALUE\fR
+Release date (YYYY-MM-DD, default: today UTC).
+.TP
+.BR \-\-changelog =\fIVALUE\fR
+Path to changelog file (default: changelog.txt).
+.TP
+.BR \-\-info\-json =\fIVALUE\fR
+Path to info.json file (default: info.json).
 .SH MOD PORTAL COMMANDS
 These commands interact with the Factorio MOD Portal and require authentication.
 .SS factorix mod upload FILE

data/lib/factorix/api/category.rb

@@ -53,6 +53,9 @@ module Factorix
       }.freeze
       private_constant :CATEGORIES
 
+      # @return [Array<String>] all category identifiers
+      def self.identifiers = CATEGORIES.keys
+
       # Get Category instance for the given value
       #
       # Returns predefined instance for known categories (flyweight pattern).

data/lib/factorix/api/license.rb

@@ -9,10 +9,11 @@ module Factorix
     # License object from MOD Portal API
     #
     # Represents a MOD license information.
+    # Uses flyweight pattern for standard licenses.
     # Also provides valid license identifiers for edit_details API.
     #
     # @see https://wiki.factorio.com/Mod_portal_API
-    # @see https://wiki.factorio.com/Mod_details_API
+    # @see https://wiki.factorio.com/Mod_details_API#License
     class License
       # @!attribute [r] id
       #   @return [String] license ID
@@ -25,37 +26,92 @@ module Factorix
       # @!attribute [r] url
       #   @return [URI::HTTPS] license URL
 
-      # Valid license identifiers for edit_details API
-      # Custom licenses (custom_$ID) are not included
-      IDENTIFIERS = {
-        "default_mit" => "MIT",
-        "default_gnugplv3" => "GNU GPLv3",
-        "default_gnulgplv3" => "GNU LGPLv3",
-        "default_mozilla2" => "Mozilla Public License 2.0",
-        "default_apache2" => "Apache License 2.0",
-        "default_unlicense" => "The Unlicense"
+      # Predefined standard license instances
+      DEFAULT_MIT = new(
+        id: "default_mit",
+        name: "MIT",
+        title: "MIT License",
+        description: "A permissive license that is short and to the point. It lets people do anything with your code with proper attribution and without warranty.",
+        url: "https://raw.githubusercontent.com/spdx/license-list-data/main/text/MIT.txt"
+      )
+      private_constant :DEFAULT_MIT
+      DEFAULT_GNUGPLV3 = new(
+        id: "default_gnugplv3",
+        name: "GNU GPLv3",
+        title: "GNU General Public License v3.0",
+        description: "The GNU GPL is the most widely used free software license and has a strong copyleft requirement.",
+        url: "https://raw.githubusercontent.com/spdx/license-list-data/main/text/GPL-3.0-or-later.txt"
+      )
+      private_constant :DEFAULT_GNUGPLV3
+      DEFAULT_GNULGPLV3 = new(
+        id: "default_gnulgplv3",
+        name: "GNU LGPLv3",
+        title: "GNU Lesser General Public License v3.0",
+        description: "Version 3 of the GNU LGPL is an additional set of permissions to the GNU GPLv3 license that requires derived works use the same license.",
+        url: "https://raw.githubusercontent.com/spdx/license-list-data/main/text/LGPL-3.0-or-later.txt"
+      )
+      private_constant :DEFAULT_GNULGPLV3
+      DEFAULT_MOZILLA2 = new(
+        id: "default_mozilla2",
+        name: "Mozilla Public License 2.0",
+        title: "Mozilla Public License Version 2.0",
+        description: "The Mozilla Public License (MPL 2.0) attempts to be a compromise between the permissive BSD license and the reciprocal GPL license.",
+        url: "https://raw.githubusercontent.com/spdx/license-list-data/main/text/MPL-2.0.txt"
+      )
+      private_constant :DEFAULT_MOZILLA2
+      DEFAULT_APACHE2 = new(
+        id: "default_apache2",
+        name: "Apache License 2.0",
+        title: "Apache License, Version 2.0",
+        description: "A permissive license that also provides an express grant of patent rights from contributors to users.",
+        url: "https://raw.githubusercontent.com/spdx/license-list-data/main/text/Apache-2.0.txt"
+      )
+      private_constant :DEFAULT_APACHE2
+      DEFAULT_UNLICENSE = new(
+        id: "default_unlicense",
+        name: "The Unlicense",
+        title: "The Unlicense",
+        description: "The Unlicense is a template to waive copyright interest in software and dedicate it to the public domain.",
+        url: "https://raw.githubusercontent.com/spdx/license-list-data/main/text/Unlicense.txt"
+      )
+      private_constant :DEFAULT_UNLICENSE
+
+      # Lookup table for flyweight pattern
+      LICENSES = {
+        "default_mit" => DEFAULT_MIT,
+        "default_gnugplv3" => DEFAULT_GNUGPLV3,
+        "default_gnulgplv3" => DEFAULT_GNULGPLV3,
+        "default_mozilla2" => DEFAULT_MOZILLA2,
+        "default_apache2" => DEFAULT_APACHE2,
+        "default_unlicense" => DEFAULT_UNLICENSE
       }.freeze
-      private_constant :IDENTIFIERS
+      private_constant :LICENSES
 
       # Pattern for custom license identifiers (custom_ + 24 lowercase hex chars)
       CUSTOM_LICENSE_PATTERN = /\Acustom_[0-9a-f]{24}\z/
       private_constant :CUSTOM_LICENSE_PATTERN
 
+      # @return [Array<String>] all license identifiers
+      def self.identifiers = LICENSES.keys
+
+      # Get License instance for the given identifier
+      #
+      # Returns predefined instance for known licenses (flyweight pattern).
+      # Raises an error for unknown license identifiers.
+      #
+      # @param id [String] license identifier
+      # @return [License] License instance
+      # @raise [KeyError] if license identifier is unknown
+      def self.for(id) = LICENSES.fetch(id.to_s)
+
       # Check if the given value is a valid license identifier
       #
       # @param value [String] license identifier
       # @return [Boolean] true if valid (standard or custom license)
       def self.valid_identifier?(value)
-        IDENTIFIERS.key?(value) || CUSTOM_LICENSE_PATTERN.match?(value)
+        LICENSES.key?(value) || CUSTOM_LICENSE_PATTERN.match?(value)
       end
 
-      # List all valid license identifier values
-      #
-      # @return [Array<String>] array of license identifiers
-      def self.identifier_values = IDENTIFIERS.keys
-
-      # Create License from API response hash
-      #
       # @param id [String] license ID
       # @param name [String] license name
       # @param title [String] license title

data/lib/factorix/api/tag.rb

@@ -79,6 +79,9 @@ module Factorix
       }.freeze
       private_constant :TAGS
 
+      # @return [Array<String>] all tag identifiers
+      def self.identifiers = TAGS.keys
+
       # Get Tag instance for the given value
       #
       # Returns predefined instance for known tags (flyweight pattern).

data/lib/factorix/cli/commands/mod/edit.rb

@@ -100,7 +100,7 @@ module Factorix
             return if API::License.valid_identifier?(license)
 
             say "Invalid license identifier: #{license}", prefix: :error
-            say "Valid identifiers: #{API::License.identifier_values.join(", ")}"
+            say "Valid identifiers: #{API::License.identifiers.join(", ")}"
             say "Custom licenses: custom_<24 hex chars> (e.g., custom_0123456789abcdef01234567)"
             raise InvalidArgumentError, "Invalid license identifier"
           end

data/lib/factorix/version.rb

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

data/sig/factorix/api/category.rbs

@@ -9,6 +9,7 @@ module Factorix
       attr_reader name: String
       attr_reader description: String
 
+      def self.identifiers: () -> Array[String]
       def self.for: (String value) -> Category
     end
   end

data/sig/factorix/api/license.rbs

@@ -11,8 +11,9 @@ module Factorix
       attr_reader description: String
       attr_reader url: URI::HTTPS
 
+      def self.identifiers: () -> Array[String]
+      def self.for: (String id) -> License
       def self.valid_identifier?: (String value) -> bool
-      def self.identifier_values: () -> Array[String]
 
       def initialize: (id: String, name: String, title: String, description: String, url: String) -> void
     end

data/sig/factorix/api/tag.rbs

@@ -9,6 +9,7 @@ module Factorix
       attr_reader name: String
       attr_reader description: String
 
+      def self.identifiers: () -> Array[String]
       def self.for: (String value) -> Tag
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factorix
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - OZAWA Sakuro
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-20 00:00:00.000000000 Z
+date: 2026-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby