factorix 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 266f397cb572fd4db54fe30671c9ba4e8ba3f60a4b17593193a829ae69b526c0
+  data.tar.gz: aeecbbf8447e8823d2d374ad13899581f51060eda1ec95959f672b883e60c8a4
+SHA512:
+  metadata.gz: 2c28e713c148c4ebb43f03094713c9b02a8c038dd64a8d6da6d69c5a09f43f1dcee7430e67a9b92be5d784d26f3986c25bf7e9d9cfd5ba3402469b0d0649723b
+  data.tar.gz: cec4b9103df79b6f2e94bb15599d4306346378030a18a3ea9480c27a7cf6004a62f7c2d2d6fa7c3c0d7416af0e4ebd5adeee5df2d281b2d68d09f9ce5d52c675

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+## [Unreleased]
+
+## [0.5.0] - 2025-12-26
+
+### Added
+
+- **CLI tool** for Factorio MOD management, settings sync, and game control
+- **MOD management commands**: installation, lifecycle, dependency validation
+- **MOD Portal integration**: download, upload, metadata/image management
+- **Utility commands**: version display, path info, game launch, shell completion
+- **Cache management**: statistics and eviction
+- **Dependency resolution** with graph-based analysis and incompatibility detection
+- **Settings management**: export/import mod-settings.dat as JSON
+- **Save file analysis**: extract MOD information and startup settings
+- **Multi-platform support**: Linux (native and WSL), macOS, and Windows
+
+For detailed documentation, see:
+- [Project Overview](doc/overview.md)
+- [CLI Commands](doc/components/cli.md)
+- [Architecture](doc/architecture.md)

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 OZAWA Sakuro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,105 @@
+# :gear: Factorix
+
+A Ruby gem providing a CLI for Factorio MOD management, settings synchronization, and game control.
+
+## Overview
+
+Factorix simplifies Factorio MOD management by providing:
+- A CLI tool for everyday MOD operations
+- Automatic dependency resolution and validation
+- JSON-based MOD settings export/import
+- Save file synchronization capabilities
+
+## Features
+
+- **MOD Discovery & Download**: Search and download MODs from the Factorio MOD Portal
+- **Dependency Management**: Automatic dependency resolution and validation with graph-based analysis
+- **MOD State Management**: Enable/disable MODs with automatic handling of dependencies and dependents
+- **Installation & Uninstallation**: Install MODs directly from the portal or uninstall existing MODs
+- **Save File Sync**: Synchronize MOD states and startup settings from Factorio save files
+- **Settings Management**: Export/import MOD settings in JSON format
+- **MOD Portal Integration**: Upload new MODs or update existing ones, edit metadata
+- **Game Control**: Launch Factorio from the command line
+- **Cross-platform Support**: Works on Windows, Linux, macOS, and WSL
+
+## Requirements
+
+- Ruby (non-EOL versions)
+- Factorio API Key (required for uploading MODs and editing MOD metadata)
+  - Obtain your API key from [Factorio Profile](https://factorio.com/profile)
+
+## Setup
+
+For uploading MODs or editing MOD metadata, set the `FACTORIO_API_KEY` environment variable:
+
+```bash
+export FACTORIO_API_KEY=your_api_key_here
+```
+
+API key is not required for downloading, installing, or managing local MODs.
+
+## Configuration
+
+### Path Configuration
+
+Factorix auto-detects Factorio installation paths for Steam installations. For other environments or to override the detected paths, create a configuration file.
+
+**Find configuration file location:**
+```bash
+factorix path --json | jq -r .factorix_config_path
+```
+
+**Create configuration file:**
+```bash
+# Copy example configuration
+cp example/config.rb ~/.config/factorix/config.rb
+
+# Edit the configuration
+$EDITOR ~/.config/factorix/config.rb
+```
+
+**Configurable paths:**
+- `executable_path` - Path to Factorio executable
+- `user_dir` - Path to Factorio user directory (MODs, saves, settings)
+- `data_dir` - Path to Factorio data directory
+
+**Example configuration:**
+```ruby
+Factorix::Application.configure do |config|
+  config.runtime.executable_path = "/Applications/Factorio.app/Contents/MacOS/factorio"
+  config.runtime.user_dir = "#{Dir.home}/Library/Application Support/factorio"
+  config.runtime.data_dir = "/Applications/Factorio.app/Contents/data"
+end
+```
+
+See [`example/config.rb`](example/config.rb) for platform-specific examples and additional configuration options.
+
+**Alternative configuration path:**
+
+You can specify a custom configuration file path using the `--config-path` option or `FACTORIX_CONFIG` environment variable:
+```bash
+# Using CLI option
+factorix mod list --config-path=/path/to/config.rb
+
+# Using environment variable
+export FACTORIX_CONFIG=/path/to/config.rb
+factorix mod list
+```
+
+## Usage
+
+Run `factorix --help` to see available commands, or `factorix <command> --help` for command-specific usage and examples.
+
+For detailed CLI documentation, run `factorix man` or see [`doc/components/cli.md`](doc/components/cli.md).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/sakuro/factorix.
+
+For development setup and detailed contribution guidelines, please see [`DEVELOPMENT.md`](DEVELOPMENT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+Copyright (c) 2025 OZAWA Sakuro

data/completion/_factorix.bash

@@ -0,0 +1,202 @@
+# Bash completion for factorix
+# Output by: factorix completion bash
+
+# Helper function to get installed MOD names
+_factorix_installed_mods() {
+  factorix mod list --json 2>/dev/null | jq -r '.[].name' 2>/dev/null
+}
+
+_factorix() {
+  local cur prev
+  cur="${COMP_WORDS[COMP_CWORD]}"
+  prev="${COMP_WORDS[COMP_CWORD-1]}"
+  local cword=$COMP_CWORD
+  local words=("${COMP_WORDS[@]}")
+
+  local global_opts="-c --config-path --log-level -q --quiet"
+  local confirmable_opts="-y --yes"
+
+  # Top-level commands
+  local commands="version man launch path mod cache completion"
+
+  # mod subcommands
+  local mod_commands="check list show enable disable install uninstall update download upload edit search sync image settings"
+
+  # cache subcommands
+  local cache_commands="stat evict"
+
+  # mod image subcommands
+  local image_commands="list add edit"
+
+  # mod settings subcommands
+  local settings_commands="dump restore"
+
+  case "${words[1]}" in
+    version|man)
+      COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+      return
+      ;;
+    launch)
+      COMPREPLY=($(compgen -W "$global_opts -w --wait" -- "$cur"))
+      return
+      ;;
+    path)
+      COMPREPLY=($(compgen -W "$global_opts --json" -- "$cur"))
+      return
+      ;;
+    completion)
+      if [[ $cword -eq 2 ]] && [[ "$cur" != -* ]]; then
+        COMPREPLY=($(compgen -W "zsh bash fish" -- "$cur"))
+      else
+        COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+      fi
+      return
+      ;;
+    cache)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "$cache_commands" -- "$cur"))
+      else
+        case "${words[2]}" in
+          stat)
+            COMPREPLY=($(compgen -W "$global_opts --json" -- "$cur"))
+            ;;
+          evict)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts --all --expired --older-than" -- "$cur"))
+            else
+              COMPREPLY=($(compgen -W "download api info_json" -- "$cur"))
+            fi
+            ;;
+          *)
+            COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            ;;
+        esac
+      fi
+      return
+      ;;
+    mod)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "$mod_commands" -- "$cur"))
+      else
+        case "${words[2]}" in
+          check)
+            COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            ;;
+          list)
+            COMPREPLY=($(compgen -W "$global_opts --enabled --disabled --errors --outdated --json" -- "$cur"))
+            ;;
+          show)
+            COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            ;;
+          enable|disable)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts $confirmable_opts" -- "$cur"))
+            else
+              local mods=$(_factorix_installed_mods)
+              COMPREPLY=($(compgen -W "$mods" -- "$cur"))
+            fi
+            ;;
+          install)
+            COMPREPLY=($(compgen -W "$global_opts $confirmable_opts -j --jobs" -- "$cur"))
+            ;;
+          uninstall)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts $confirmable_opts --all" -- "$cur"))
+            else
+              local mods=$(_factorix_installed_mods)
+              COMPREPLY=($(compgen -W "$mods" -- "$cur"))
+            fi
+            ;;
+          update)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts $confirmable_opts -j --jobs" -- "$cur"))
+            else
+              local mods=$(_factorix_installed_mods)
+              COMPREPLY=($(compgen -W "$mods" -- "$cur"))
+            fi
+            ;;
+          download)
+            COMPREPLY=($(compgen -W "$global_opts -d --directory -j --jobs -r --recursive" -- "$cur"))
+            ;;
+          upload)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts --description --category --license --source-url" -- "$cur"))
+            elif [[ "$prev" == "--category" ]]; then
+              COMPREPLY=($(compgen -W "content overhaul tweaks utilities scenarios mod-packs localizations internal no-category" -- "$cur"))
+            elif [[ "$prev" == "--license" ]]; then
+              COMPREPLY=($(compgen -W "default_mit default_gnugplv3 default_gnulgplv3 default_mozilla2 default_apache2 default_unlicense" -- "$cur"))
+            else
+              COMPREPLY=($(compgen -f -X '!*.zip' -- "$cur"))
+            fi
+            ;;
+          edit)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts --description --summary --title --category --tags --license --homepage --source-url --faq --deprecated --no-deprecated" -- "$cur"))
+            elif [[ "$prev" == "--category" ]]; then
+              COMPREPLY=($(compgen -W "content overhaul tweaks utilities scenarios mod-packs localizations internal no-category" -- "$cur"))
+            elif [[ "$prev" == "--license" ]]; then
+              COMPREPLY=($(compgen -W "default_mit default_gnugplv3 default_gnulgplv3 default_mozilla2 default_apache2 default_unlicense" -- "$cur"))
+            elif [[ "$prev" == "--tags" ]]; then
+              COMPREPLY=($(compgen -W "transportation logistics trains combat armor enemies character environment planets mining fluids logistic-network circuit-network manufacturing power storage blueprints cheats" -- "$cur"))
+            fi
+            ;;
+          search)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts --hide-deprecated --no-hide-deprecated --page --page-size --sort --sort-order --version --json" -- "$cur"))
+            elif [[ "$prev" == "--sort" ]]; then
+              COMPREPLY=($(compgen -W "name created_at updated_at" -- "$cur"))
+            elif [[ "$prev" == "--sort-order" ]]; then
+              COMPREPLY=($(compgen -W "asc desc" -- "$cur"))
+            fi
+            ;;
+          sync)
+            if [[ "$cur" == -* ]]; then
+              COMPREPLY=($(compgen -W "$global_opts $confirmable_opts -j --jobs" -- "$cur"))
+            else
+              COMPREPLY=($(compgen -f -X '!*.zip' -- "$cur"))
+            fi
+            ;;
+          image)
+            if [[ $cword -eq 3 ]]; then
+              COMPREPLY=($(compgen -W "$image_commands" -- "$cur"))
+            else
+              case "${words[3]}" in
+                add)
+                  if [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+                  elif [[ $cword -eq 5 ]]; then
+                    COMPREPLY=($(compgen -f -X '!*.@(png|jpg|jpeg|gif)' -- "$cur"))
+                  fi
+                  ;;
+                *)
+                  COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+                  ;;
+              esac
+            fi
+            ;;
+          settings)
+            if [[ $cword -eq 3 ]]; then
+              COMPREPLY=($(compgen -W "$settings_commands" -- "$cur"))
+            else
+              COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            fi
+            ;;
+          *)
+            COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+            ;;
+        esac
+      fi
+      return
+      ;;
+  esac
+
+  # Top-level completion
+  if [[ $cword -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+  else
+    COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+  fi
+}
+
+# Register the completion function
+complete -F _factorix factorix

data/completion/_factorix.fish

@@ -0,0 +1,197 @@
+# Fish completion for factorix
+# Output by: factorix completion fish
+
+# Helper function to get installed MOD names
+function __factorix_installed_mods
+    factorix mod list --json 2>/dev/null | jq -r '.[].name' 2>/dev/null
+end
+
+# Helper function to check if we're completing a specific subcommand
+function __factorix_using_command
+    set -l cmd (commandline -opc)
+    set -l argc (count $cmd)
+
+    if test $argc -eq 1
+        return 1
+    end
+
+    for i in (seq 2 $argc)
+        switch $cmd[$i]
+            case '-*'
+                continue
+            case '*'
+                if test "$cmd[$i]" = "$argv[1]"
+                    return 0
+                end
+                return 1
+        end
+    end
+    return 1
+end
+
+# Helper function to check nested subcommand
+function __factorix_using_subcommand
+    set -l cmd (commandline -opc)
+    set -l argc (count $cmd)
+
+    if test $argc -lt 3
+        return 1
+    end
+
+    set -l parent $argv[1]
+    set -l sub $argv[2]
+
+    set -l found_parent 0
+    for i in (seq 2 $argc)
+        switch $cmd[$i]
+            case '-*'
+                continue
+            case '*'
+                if test $found_parent -eq 0
+                    if test "$cmd[$i]" = "$parent"
+                        set found_parent 1
+                    else
+                        return 1
+                    end
+                else
+                    if test "$cmd[$i]" = "$sub"
+                        return 0
+                    end
+                    return 1
+                end
+        end
+    end
+    return 1
+end
+
+# Disable file completion by default
+complete -c factorix -f
+
+# Global options
+complete -c factorix -s c -l config-path -d 'Path to configuration file' -r
+complete -c factorix -l log-level -d 'Set log level' -xa 'debug info warn error fatal'
+complete -c factorix -s q -l quiet -d 'Suppress non-essential output'
+
+# Top-level commands
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a version -d 'Display Factorix version'
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a man -d 'Display the Factorix manual page'
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a launch -d 'Launch Factorio game'
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a path -d 'Display Factorio and Factorix paths'
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a mod -d 'MOD management commands'
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a cache -d 'Cache management commands'
+complete -c factorix -n "not __factorix_using_command version; and not __factorix_using_command man; and not __factorix_using_command launch; and not __factorix_using_command path; and not __factorix_using_command mod; and not __factorix_using_command cache; and not __factorix_using_command completion" -a completion -d 'Generate shell completion script'
+
+# launch options
+complete -c factorix -n "__factorix_using_command launch" -s w -l wait -d 'Wait for the game to finish'
+
+# path options
+complete -c factorix -n "__factorix_using_command path" -l json -d 'Output in JSON format'
+
+# completion shell argument
+complete -c factorix -n "__factorix_using_command completion" -a 'zsh bash fish' -d 'Shell type'
+
+# cache subcommands
+complete -c factorix -n "__factorix_using_command cache" -a stat -d 'Display cache statistics'
+complete -c factorix -n "__factorix_using_command cache" -a evict -d 'Evict cache entries'
+
+# cache stat options
+complete -c factorix -n "__factorix_using_subcommand cache stat" -l json -d 'Output in JSON format'
+
+# cache evict options
+complete -c factorix -n "__factorix_using_subcommand cache evict" -l all -d 'Remove all entries'
+complete -c factorix -n "__factorix_using_subcommand cache evict" -l expired -d 'Remove expired entries only'
+complete -c factorix -n "__factorix_using_subcommand cache evict" -l older-than -d 'Remove entries older than AGE' -r
+complete -c factorix -n "__factorix_using_subcommand cache evict" -a 'download api info_json' -d 'Cache name'
+
+# mod subcommands
+complete -c factorix -n "__factorix_using_command mod" -a check -d 'Check MOD dependencies'
+complete -c factorix -n "__factorix_using_command mod" -a list -d 'List installed MODs'
+complete -c factorix -n "__factorix_using_command mod" -a show -d 'Show MOD details from Factorio MOD Portal'
+complete -c factorix -n "__factorix_using_command mod" -a enable -d 'Enable MODs'
+complete -c factorix -n "__factorix_using_command mod" -a disable -d 'Disable MODs'
+complete -c factorix -n "__factorix_using_command mod" -a install -d 'Install MODs from Factorio MOD Portal'
+complete -c factorix -n "__factorix_using_command mod" -a uninstall -d 'Uninstall MODs'
+complete -c factorix -n "__factorix_using_command mod" -a update -d 'Update MODs'
+complete -c factorix -n "__factorix_using_command mod" -a download -d 'Download MODs without installing'
+complete -c factorix -n "__factorix_using_command mod" -a upload -d 'Upload MOD to Factorio MOD Portal'
+complete -c factorix -n "__factorix_using_command mod" -a edit -d 'Edit MOD metadata on Factorio MOD Portal'
+complete -c factorix -n "__factorix_using_command mod" -a search -d 'Search MODs on Factorio MOD Portal'
+complete -c factorix -n "__factorix_using_command mod" -a sync -d 'Sync MOD states from a save file'
+complete -c factorix -n "__factorix_using_command mod" -a image -d 'MOD image management'
+complete -c factorix -n "__factorix_using_command mod" -a settings -d 'MOD settings management'
+
+# mod list options
+complete -c factorix -n "__factorix_using_subcommand mod list" -l enabled -d 'Show only enabled MODs'
+complete -c factorix -n "__factorix_using_subcommand mod list" -l disabled -d 'Show only disabled MODs'
+complete -c factorix -n "__factorix_using_subcommand mod list" -l errors -d 'Show only MODs with dependency errors'
+complete -c factorix -n "__factorix_using_subcommand mod list" -l outdated -d 'Show only MODs with available updates'
+complete -c factorix -n "__factorix_using_subcommand mod list" -l json -d 'Output in JSON format'
+
+# mod enable/disable options
+complete -c factorix -n "__factorix_using_subcommand mod enable" -s y -l yes -d 'Skip confirmation prompts'
+complete -c factorix -n "__factorix_using_subcommand mod enable" -a '(__factorix_installed_mods)' -d 'MOD name'
+complete -c factorix -n "__factorix_using_subcommand mod disable" -s y -l yes -d 'Skip confirmation prompts'
+complete -c factorix -n "__factorix_using_subcommand mod disable" -a '(__factorix_installed_mods)' -d 'MOD name'
+
+# mod install options
+complete -c factorix -n "__factorix_using_subcommand mod install" -s y -l yes -d 'Skip confirmation prompts'
+complete -c factorix -n "__factorix_using_subcommand mod install" -s j -l jobs -d 'Number of parallel downloads' -r
+
+# mod uninstall options
+complete -c factorix -n "__factorix_using_subcommand mod uninstall" -s y -l yes -d 'Skip confirmation prompts'
+complete -c factorix -n "__factorix_using_subcommand mod uninstall" -l all -d 'Uninstall all MODs'
+complete -c factorix -n "__factorix_using_subcommand mod uninstall" -a '(__factorix_installed_mods)' -d 'MOD name'
+
+# mod update options
+complete -c factorix -n "__factorix_using_subcommand mod update" -s y -l yes -d 'Skip confirmation prompts'
+complete -c factorix -n "__factorix_using_subcommand mod update" -s j -l jobs -d 'Number of parallel downloads' -r
+complete -c factorix -n "__factorix_using_subcommand mod update" -a '(__factorix_installed_mods)' -d 'MOD name'
+
+# mod download options
+complete -c factorix -n "__factorix_using_subcommand mod download" -s d -l directory -d 'Download directory' -ra '(__fish_complete_directories)'
+complete -c factorix -n "__factorix_using_subcommand mod download" -s j -l jobs -d 'Number of parallel downloads' -r
+complete -c factorix -n "__factorix_using_subcommand mod download" -s r -l recursive -d 'Include required dependencies recursively'
+
+# mod upload options
+complete -c factorix -n "__factorix_using_subcommand mod upload" -l description -d 'Markdown description' -r
+complete -c factorix -n "__factorix_using_subcommand mod upload" -l category -d 'MOD category' -xa 'content overhaul tweaks utilities scenarios mod-packs localizations internal no-category'
+complete -c factorix -n "__factorix_using_subcommand mod upload" -l license -d 'License identifier' -xa 'default_mit default_gnugplv3 default_gnulgplv3 default_mozilla2 default_apache2 default_unlicense'
+complete -c factorix -n "__factorix_using_subcommand mod upload" -l source-url -d 'Repository URL' -r
+complete -c factorix -n "__factorix_using_subcommand mod upload" -ra '(__fish_complete_suffix .zip)'
+
+# mod edit options
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l description -d 'Markdown description' -r
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l summary -d 'Brief description' -r
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l title -d 'MOD title' -r
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l category -d 'MOD category' -xa 'content overhaul tweaks utilities scenarios mod-packs localizations internal no-category'
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l tags -d 'Tags' -xa 'transportation logistics trains combat armor enemies character environment planets mining fluids logistic-network circuit-network manufacturing power storage blueprints cheats'
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l license -d 'License identifier' -xa 'default_mit default_gnugplv3 default_gnulgplv3 default_mozilla2 default_apache2 default_unlicense'
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l homepage -d 'Homepage URL' -r
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l source-url -d 'Repository URL' -r
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l faq -d 'FAQ text' -r
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l deprecated -d 'Deprecation flag'
+complete -c factorix -n "__factorix_using_subcommand mod edit" -l no-deprecated -d 'Clear deprecation flag'
+
+# mod search options
+complete -c factorix -n "__factorix_using_subcommand mod search" -l hide-deprecated -d 'Hide deprecated MODs'
+complete -c factorix -n "__factorix_using_subcommand mod search" -l no-hide-deprecated -d 'Show deprecated MODs'
+complete -c factorix -n "__factorix_using_subcommand mod search" -l page -d 'Page number' -r
+complete -c factorix -n "__factorix_using_subcommand mod search" -l page-size -d 'Results per page' -r
+complete -c factorix -n "__factorix_using_subcommand mod search" -l sort -d 'Sort field' -xa 'name created_at updated_at'
+complete -c factorix -n "__factorix_using_subcommand mod search" -l sort-order -d 'Sort order' -xa 'asc desc'
+complete -c factorix -n "__factorix_using_subcommand mod search" -l version -d 'Filter by Factorio version' -r
+complete -c factorix -n "__factorix_using_subcommand mod search" -l json -d 'Output in JSON format'
+
+# mod sync options
+complete -c factorix -n "__factorix_using_subcommand mod sync" -s y -l yes -d 'Skip confirmation prompts'
+complete -c factorix -n "__factorix_using_subcommand mod sync" -s j -l jobs -d 'Number of parallel downloads' -r
+complete -c factorix -n "__factorix_using_subcommand mod sync" -ra '(__fish_complete_suffix .zip)'
+
+# mod image subcommands
+complete -c factorix -n "__factorix_using_subcommand mod image" -a list -d 'List MOD images'
+complete -c factorix -n "__factorix_using_subcommand mod image" -a add -d 'Add an image to a MOD'
+complete -c factorix -n "__factorix_using_subcommand mod image" -a edit -d 'Edit MOD images'
+
+# mod settings subcommands
+complete -c factorix -n "__factorix_using_subcommand mod settings" -a dump -d 'Dump MOD settings to JSON'
+complete -c factorix -n "__factorix_using_subcommand mod settings" -a restore -d 'Restore MOD settings from JSON'