factorix 0.5.1 → 0.7.0

data/sig/factorix.rbs

@@ -6,4 +6,103 @@ module Factorix
   VERSION: String
 
   Import: Dry::AutoInject::_Builder
+
+  extend Dry::Configurable
+
+  def self.config: () -> Config
+
+  def self.configure: () { (Config) -> void } -> void
+
+  def self.load_config: (?Pathname? path) -> void
+
+  class Config
+    def log_level: () -> Symbol
+
+    def log_level=: (Symbol) -> void
+
+    def credential: () -> CredentialConfig
+
+    def runtime: () -> RuntimeConfig
+
+    def http: () -> HttpConfig
+
+    def cache: () -> CacheConfig
+  end
+
+  class CredentialConfig
+    def source: () -> Symbol
+
+    def source=: (Symbol) -> void
+  end
+
+  class RuntimeConfig
+    def executable_path: () -> Pathname?
+
+    def executable_path=: (Pathname | String | nil) -> void
+
+    def user_dir: () -> Pathname?
+
+    def user_dir=: (Pathname | String | nil) -> void
+
+    def data_dir: () -> Pathname?
+
+    def data_dir=: (Pathname | String | nil) -> void
+  end
+
+  class HttpConfig
+    def connect_timeout: () -> Integer
+
+    def connect_timeout=: (Integer) -> void
+
+    def read_timeout: () -> Integer
+
+    def read_timeout=: (Integer) -> void
+
+    def write_timeout: () -> Integer
+
+    def write_timeout=: (Integer) -> void
+  end
+
+  class CacheConfig
+    def download: () -> CacheInstanceConfig
+
+    def api: () -> CacheInstanceConfig
+
+    def info_json: () -> CacheInstanceConfig
+
+    def values: () -> Hash[Symbol, CacheInstanceConfig]
+  end
+
+  class CacheInstanceConfig
+    def dir: () -> Pathname
+
+    def dir=: (Pathname | String) -> void
+
+    def ttl: () -> Integer?
+
+    def ttl=: (Integer?) -> void
+
+    def max_file_size: () -> Integer?
+
+    def max_file_size=: (Integer?) -> void
+
+    def compression_threshold: () -> Integer?
+
+    def compression_threshold=: (Integer?) -> void
+
+    def to_h: () -> Hash[Symbol, untyped]
+  end
+
+  # @deprecated Use Container for DI and Factorix for configuration
+  class Application
+    def self.[]: (Symbol) -> untyped
+
+    def self.resolve: (Symbol) -> untyped
+
+    def self.register: (Symbol, ?memoize: bool) { () -> untyped } -> void
+
+    def self.config: () -> Config
+
+    def self.configure: () { (Config) -> void } -> void
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factorix
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - OZAWA Sakuro
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-13 00:00:00.000000000 Z
+date: 2026-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -94,6 +94,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: dry-inflector
+  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: dry-logger
   requirement: !ruby/object:Gem::Requirement
@@ -221,8 +235,11 @@ files:
 - lib/factorix/api/release.rb
 - lib/factorix/api/tag.rb
 - lib/factorix/api_credential.rb
-- lib/factorix/application.rb
+- lib/factorix/cache/base.rb
+- lib/factorix/cache/entry.rb
 - lib/factorix/cache/file_system.rb
+- lib/factorix/cache/redis.rb
+- lib/factorix/cache/s3.rb
 - lib/factorix/cli.rb
 - lib/factorix/cli/commands/backup_support.rb
 - lib/factorix/cli/commands/base.rb
@@ -253,8 +270,10 @@ files:
 - lib/factorix/cli/commands/mod/update.rb
 - lib/factorix/cli/commands/mod/upload.rb
 - lib/factorix/cli/commands/path.rb
+- lib/factorix/cli/commands/portal_support.rb
 - lib/factorix/cli/commands/requires_game_stopped.rb
 - lib/factorix/cli/commands/version.rb
+- lib/factorix/container.rb
 - lib/factorix/dependency/edge.rb
 - lib/factorix/dependency/entry.rb
 - lib/factorix/dependency/graph.rb
@@ -322,8 +341,11 @@ files:
 - sig/factorix/api/release.rbs
 - sig/factorix/api/tag.rbs
 - sig/factorix/api_credential.rbs
-- sig/factorix/application.rbs
+- sig/factorix/cache/base.rbs
+- sig/factorix/cache/entry.rbs
 - sig/factorix/cache/file_system.rbs
+- sig/factorix/cache/redis.rbs
+- sig/factorix/cache/s3.rbs
 - sig/factorix/cli.rbs
 - sig/factorix/cli/commands/base.rbs
 - sig/factorix/cli/commands/cache/evict.rbs
@@ -353,6 +375,7 @@ files:
 - sig/factorix/cli/commands/path.rbs
 - sig/factorix/cli/commands/requires_game_stopped.rbs
 - sig/factorix/cli/commands/version.rbs
+- sig/factorix/container.rbs
 - sig/factorix/dependency/edge.rbs
 - sig/factorix/dependency/entry.rbs
 - sig/factorix/dependency/graph.rbs

data/lib/factorix/application.rb

@@ -1,218 +0,0 @@
-# frozen_string_literal: true
-
-require "dry/configurable"
-require "dry/core"
-require "dry/logger"
-
-module Factorix
-  # Application container and configuration
-  #
-  # Provides dependency injection container and configuration management
-  # using dry-core's Container and dry-configurable.
-  #
-  # @example Configure the application
-  #   Factorix::Application.configure do |config|
-  #     config.log_level = :debug
-  #     config.http.connect_timeout = 10
-  #   end
-  #
-  # @example Resolve dependencies
-  #   runtime = Factorix::Application[:runtime]
-  class Application
-    extend Dry::Core::Container::Mixin
-    extend Dry::Configurable
-
-    # Some items are registered with memoize: false to support independent event handlers
-    # for each parallel download task (e.g., progress tracking).
-    # Items registered with memoize: false:
-    # - :downloader (event handlers for progress tracking)
-    # - :mod_download_api (contains :downloader)
-    # - :portal (contains :mod_download_api)
-
-    # Register runtime detector
-    register(:runtime, memoize: true) do
-      Runtime.detect
-    end
-
-    # Register logger
-    register(:logger, memoize: true) do
-      runtime = resolve(:runtime)
-      log_path = runtime.factorix_log_path
-
-      # Ensure log directory exists
-      log_path.dirname.mkpath unless log_path.dirname.exist?
-
-      # Create logger with file backend
-      # Dispatcher level set to DEBUG to allow all messages through
-      # Backend controls filtering based on --log-level option
-      Dry.Logger(:factorix, level: :debug) do |dispatcher|
-        dispatcher.add_backend(level: config.log_level, stream: log_path.to_s, template: "[%<time>s] %<severity>s: %<message>s %<payload>s")
-      end
-    end
-
-    # Register retry strategy for network operations
-    register(:retry_strategy, memoize: true) do
-      HTTP::RetryStrategy.new
-    end
-
-    # Register download cache
-    register(:download_cache, memoize: true) do
-      c = config.cache.download
-      Cache::FileSystem.new(c.dir, **c.to_h.except(:dir))
-    end
-
-    # Register API cache (with compression for JSON responses)
-    register(:api_cache, memoize: true) do
-      c = config.cache.api
-      Cache::FileSystem.new(c.dir, **c.to_h.except(:dir))
-    end
-
-    # Register info.json cache (for MOD metadata from ZIP files)
-    register(:info_json_cache, memoize: true) do
-      c = config.cache.info_json
-      Cache::FileSystem.new(c.dir, **c.to_h.except(:dir))
-    end
-
-    # Register base HTTP client
-    register(:http_client, memoize: true) do
-      HTTP::Client.new(masked_params: %w[username token secure])
-    end
-
-    # Register decorated HTTP client for downloads (with retry only)
-    # Note: Caching is handled by Downloader, not at HTTP client level
-    register(:download_http_client, memoize: true) do
-      client = resolve(:http_client)
-      retry_strategy = resolve(:retry_strategy)
-
-      # Decorate: Client -> Retry (no cache, handled by Downloader)
-      HTTP::RetryDecorator.new(client:, retry_strategy:)
-    end
-
-    # Register decorated HTTP client for API calls (with retry + cache)
-    register(:api_http_client, memoize: true) do
-      client = resolve(:http_client)
-      api_cache = resolve(:api_cache)
-      retry_strategy = resolve(:retry_strategy)
-
-      # Decorate: Client -> Cache -> Retry
-      cached = HTTP::CacheDecorator.new(client:, cache: api_cache)
-      HTTP::RetryDecorator.new(client: cached, retry_strategy:)
-    end
-
-    # Register decorated HTTP client for uploads (with retry only, no cache)
-    register(:upload_http_client, memoize: true) do
-      client = resolve(:http_client)
-      retry_strategy = resolve(:retry_strategy)
-
-      # Decorate: Client -> Retry (no cache for uploads)
-      HTTP::RetryDecorator.new(client:, retry_strategy:)
-    end
-
-    # Register downloader
-    register(:downloader, memoize: false) do
-      Transfer::Downloader.new
-    end
-
-    # Register uploader
-    register(:uploader, memoize: true) do
-      Transfer::Uploader.new
-    end
-
-    # Register service credential
-    register(:service_credential, memoize: true) { ServiceCredential.load }
-
-    # Register MOD Portal API client
-    register(:mod_portal_api, memoize: true) do
-      API::MODPortalAPI.new
-    end
-
-    # Register MOD Download API client
-    register(:mod_download_api, memoize: false) do
-      API::MODDownloadAPI.new
-    end
-
-    # Register API credential (for MOD upload/management)
-    register(:api_credential, memoize: true) { APICredential.load }
-
-    # Register MOD Management API client
-    register(:mod_management_api, memoize: true) do
-      api = API::MODManagementAPI.new
-      # Subscribe mod_portal_api to invalidate cache when MOD is changed on portal
-      api.subscribe(resolve(:mod_portal_api))
-      api
-    end
-
-    # Register portal (high-level API wrapper)
-    register(:portal, memoize: false) do
-      Portal.new
-    end
-
-    # Log level (:debug, :info, :warn, :error, :fatal)
-    setting :log_level, default: :info
-
-    # Runtime settings (optional overrides for auto-detection)
-    setting :runtime do
-      setting :executable_path, constructor: ->(v) { v ? Pathname(v) : nil }
-      setting :user_dir, constructor: ->(v) { v ? Pathname(v) : nil }
-      setting :data_dir, constructor: ->(v) { v ? Pathname(v) : nil }
-    end
-
-    # HTTP timeout settings
-    setting :http do
-      setting :connect_timeout, default: 5
-      setting :read_timeout, default: 30
-      setting :write_timeout, default: 30
-    end
-
-    # Cache settings
-    setting :cache do
-      # Download cache settings (for MOD files)
-      setting :download do
-        setting :dir, constructor: ->(value) { Pathname(value) }
-        setting :ttl, default: nil # nil for unlimited (MOD files are immutable)
-        setting :max_file_size, default: nil # nil for unlimited
-        setting :compression_threshold, default: nil # nil for no compression (binary files)
-      end
-
-      # API cache settings (for API responses)
-      setting :api do
-        setting :dir, constructor: ->(value) { Pathname(value) }
-        setting :ttl, default: 3600 # 1 hour (API responses may change)
-        setting :max_file_size, default: 10 * 1024 * 1024 # 10MiB (JSON responses)
-        setting :compression_threshold, default: 0 # always compress (JSON is highly compressible)
-      end
-
-      # info.json cache settings (for MOD metadata from ZIP files)
-      setting :info_json do
-        setting :dir, constructor: ->(value) { Pathname(value) }
-        setting :ttl, default: nil # nil for unlimited (info.json is immutable within a MOD ZIP)
-        setting :max_file_size, default: nil # nil for unlimited (info.json is small)
-        setting :compression_threshold, default: 0 # always compress (JSON is highly compressible)
-      end
-    end
-
-    # Load configuration from file
-    #
-    # @param path [Pathname, String, nil] configuration file path
-    # @return [void]
-    # @raise [ConfigurationError] if explicitly specified path does not exist
-    def self.load_config(path=nil)
-      if path
-        # Explicitly specified path must exist
-        config_path = Pathname(path)
-        raise ConfigurationError, "Configuration file not found: #{config_path}" unless config_path.exist?
-      else
-        # Default path is optional
-        config_path = resolve(:runtime).factorix_config_path
-        return unless config_path.exist?
-      end
-
-      instance_eval(config_path.read, config_path.to_s)
-    end
-
-    runtime = resolve(:runtime)
-    config.cache.download.dir = runtime.factorix_cache_dir / "download"
-    config.cache.api.dir = runtime.factorix_cache_dir / "api"
-    config.cache.info_json.dir = runtime.factorix_cache_dir / "info_json"
-  end
-end

data/sig/factorix/application.rbs

@@ -1,86 +0,0 @@
-# RBS type signature file
-# NOTE: Do not include private method definitions in RBS files.
-#       Only public interfaces should be documented here.
-
-module Factorix
-  class Application
-    extend Dry::Core::Container::Mixin
-    extend Dry::Configurable
-
-    def self.register: (Symbol, ?memoize: bool) { () -> untyped } -> void
-
-    def self.resolve: (Symbol) -> untyped
-
-    def self.[]: (Symbol) -> untyped
-
-    def self.config: () -> Config
-
-    def self.configure: () { (Config) -> void } -> void
-
-    def self.load_config: (?String? path) -> void
-
-    class Config
-      def log_level: () -> Symbol
-
-      def log_level=: (Symbol) -> void
-
-      def credential: () -> CredentialConfig
-
-      def runtime: () -> RuntimeConfig
-
-      def http: () -> HttpConfig
-
-      def cache: () -> CacheConfig
-    end
-
-    class CredentialConfig
-      def source: () -> Symbol
-
-      def source=: (Symbol) -> void
-    end
-
-    class RuntimeConfig
-      def executable_path: () -> Pathname?
-
-      def executable_path=: (Pathname | String | nil) -> void
-
-      def user_dir: () -> Pathname?
-
-      def user_dir=: (Pathname | String | nil) -> void
-    end
-
-    class HttpConfig
-      def connect_timeout: () -> Integer
-
-      def connect_timeout=: (Integer) -> void
-
-      def read_timeout: () -> Integer
-
-      def read_timeout=: (Integer) -> void
-
-      def write_timeout: () -> Integer
-
-      def write_timeout=: (Integer) -> void
-    end
-
-    class CacheConfig
-      def download: () -> CacheInstanceConfig
-
-      def api: () -> CacheInstanceConfig
-    end
-
-    class CacheInstanceConfig
-      def dir: () -> Pathname
-
-      def dir=: (Pathname | String) -> void
-
-      def ttl: () -> Integer?
-
-      def ttl=: (Integer?) -> void
-
-      def max_file_size: () -> Integer?
-
-      def max_file_size=: (Integer?) -> void
-    end
-  end
-end