multidocs 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d844c134d8baeff6c16b4caf101d369dc336d0a9d8bab33332818ebd1f4ee68c
+  data.tar.gz: aa3a8cd083858183b215a8af0646f26bc057b20d072229aecc282b2e4c6fa3d9
+SHA512:
+  metadata.gz: 50dc01330e2e065f3eccd36380602ac6e4988cbc2b4bb7ddeba89b2595687286f145a224e980833675b733234b7cfa8b60e49a134c978b48406db0c5820b9497
+  data.tar.gz: 229ec459e9217793e33ad56bd3e5e8c0639bbb09061899fdd16e0c6779190bc5b9436b7e9d80edef2f62e30327bc2eba736267ffb513c5313280ebe3fd1aee3a

data/README.md

@@ -0,0 +1,14 @@
+<!-- copyright (c) 2026, Nashi Uso, (嘘無し). -->
+
+# multidocs
+
+kujo documentation toolchain cli.
+
+```
+gem install multidocs
+
+multidocs build   # runs the rust helper binary
+multidocs serve   # serves ../public_html on :8080
+```
+
+env: `MULTIDOCS_BIN` (rust binary path) · `MULTIDOCS_ROOT` (html dir) · `MULTIDOCS_PORT`.

data/exe/multidocs

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# copyright (c) 2026, Nashi Uso, (嘘無し).
+# frozen_string_literal: true
+
+require_relative "../lib/multidocs/cli"
+
+exit Multidocs::CLI.new(ARGV).run

data/lib/multidocs/cli.rb

@@ -0,0 +1,96 @@
+# Copyright (c) 2026,
+# Nashi Uso , (嘘無し) .
+
+# frozen_string_literal: true
+
+require "webrick"
+require_relative "version"
+
+module Multidocs
+  # command dispatcher for the multidocs executable.
+  class CLI
+    USAGE = <<~TEXT
+      multidocs #{VERSION} — kujo documentation toolchain
+
+      usage:
+        multidocs build   run the rust helper binary (multidocs --version)
+        multidocs serve   serve ../public_html on http://localhost:8080
+        multidocs help    show this message
+    TEXT
+
+    # candidate locations for the rust binary, first match wins:
+    #   1. MULTIDOCS_BIN env override
+    #   2. dev build inside the repo (rust/target/release)
+    #   3. release binary dropped next to the gem
+    #   4. anything on PATH named multidocs-bin
+    BINARY_CANDIDATES = [
+      ENV["MULTIDOCS_BIN"],
+      File.expand_path("../../../rust/target/release/multidocs", __dir__),
+      File.expand_path("../../bin/multidocs-bin", __dir__),
+      "multidocs-bin"
+    ].compact.freeze
+
+    DEFAULT_PORT = 8080
+
+    def initialize(argv)
+      @argv = argv
+    end
+
+    def run
+      case @argv.first
+      when "build" then build
+      when "serve" then serve
+      when "help", "-h", "--help", nil then puts USAGE
+      else
+        warn "multidocs: unknown command #{@argv.first.inspect}"
+        warn USAGE
+        1
+      end || 0
+    end
+
+    private
+
+    def build
+      binary = BINARY_CANDIDATES.find { |candidate| executable?(candidate) }
+      unless binary
+        warn "multidocs: rust binary not found."
+        warn "  build it with: cd rust && cargo build --release"
+        warn "  or point MULTIDOCS_BIN at a release binary."
+        return 1
+      end
+
+      puts "multidocs: running #{binary}"
+      system(binary, "--version") ? 0 : 1
+    end
+
+    def serve
+      root = public_html_dir
+      unless Dir.exist?(root)
+        warn "multidocs: #{root} not found."
+        warn "  generate it with: cd astro-site && npm install && npm run build"
+        return 1
+      end
+
+      port = Integer(ENV.fetch("MULTIDOCS_PORT", DEFAULT_PORT))
+      puts "multidocs: serving #{root} on http://localhost:#{port} (ctrl+c to stop)"
+
+      server = WEBrick::HTTPServer.new(Port: port, DocumentRoot: root, AccessLog: [])
+      trap("INT") { server.shutdown }
+      server.start
+      0
+    end
+
+    def public_html_dir
+      ENV["MULTIDOCS_ROOT"] || File.expand_path("../../../public_html", __dir__)
+    end
+
+    def executable?(candidate)
+      return false unless candidate
+      return true if File.executable?(candidate)
+
+      # PATH lookup for bare names.
+      !candidate.include?(File::SEPARATOR) &&
+        ENV["PATH"].split(File::PATH_SEPARATOR).any? { |dir| File.executable?(File.join(dir, candidate)) }
+    end
+  end
+end

data/lib/multidocs/version.rb

@@ -0,0 +1,8 @@
+# Copyright (c) 2026,
+# Nashi Uso , (嘘無し) .
+
+# frozen_string_literal: true
+
+module Multidocs
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: multidocs
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nashi Uso
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: 'small cli around the kujo docs pipeline: `multidocs build` runs the
+  rust helper binary, `multidocs serve` serves the generated public_html folder.'
+email:
+- corrimosdelagente@proton.me
+executables:
+- multidocs
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- exe/multidocs
+- lib/multidocs/cli.rb
+- lib/multidocs/version.rb
+homepage: https://github.com/nashiuso/kujo
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/nashiuso/kujo
+  source_code_uri: https://github.com/nashiuso/kujo
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: kujo multidocs cli — build and serve the multi-language documentation site.
+test_files: []