lux-hammer 0.3.26 → 0.3.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: acc942b0818d0cc60a8cbe9a55fbf092665d6efcb46df209b2a8e9721aa1e190
-  data.tar.gz: 94baed7a0025611360d0315d084fd7432a1eb68d84302bfeaf0960ee0326aee7
+  metadata.gz: cbcb0355f0ce770acb1ace879a1567ee1193de1da5ac6e6c32e36faa8f2a48fe
+  data.tar.gz: 8299d3bf2a47844e0e5c01ba73225d43be8aef718ceee3cf9603d0ec85e3e582
 SHA512:
-  metadata.gz: 486bb304e25a56faada26757651998d75e589fabca7402f499dc9cdd3228a90b30cc3fc7cda765d2cd34fc90eecc906208681c031e38628e0087f59eb5250af7
-  data.tar.gz: 87115686cf4bbdd6a47ed9a25e048cf811fe1c8071966e5ee3143b7fcafc286ff1480d00c5ba494e407fa9032b8e1b6dda43e8623c011ae9ffdbdf70e8a33612
+  metadata.gz: 6f5a7f793308a5f55e1bdb99ab85ae7aa8b271c92a073f33e1e7130f757395a97071da89a0933958cd89279a7a2004372a71746f1d83c945747ea1cb785f9f75
+  data.tar.gz: b5ee6d077d5b14fd5c448a28ea53e15da59198c067a568bee97193b5352cfea78dd073dff9054af58501453a72cbdae5b0d6c6af5e3e578004b102434a98b29d

data/.version

@@ -1 +1 @@
-0.3.26
+0.3.27

data/AGENTS.md

@@ -22,8 +22,9 @@ usable as a library (`require 'lux-hammer'`, subclass `Hammer`, call
   monkey-patches.
 * **Zero runtime dependencies**. The gem must work with stdlib only. New
   dependencies require explicit user approval.
-* **Ruby >= 2.7**. Do not use language features introduced after 2.7
-  without flagging.
+* **Ruby >= 2.7** for `lib/` and `bin/`. Do not use language features
+  introduced after 2.7 there without flagging. Bundled recipes may sit
+  higher - the `llm` recipe needs >= 3.1 (endless methods, shorthand hash).
 * **`desc` is single-arg, multi-line allowed**. The argument is one
   string; it may contain newlines. The first line is the brief shown in
   command listings, the full string renders (indented) in per-command
@@ -300,7 +301,10 @@ Task contracts:
   `--path NAME`, `--edit NAME`, `--run NAME [ARGS]` (use `--` to
   forward flags through). Bare invocation lists.
 * `h:init` - writes `Hammer::STARTER_HAMMERFILE` to `./Hammerfile`;
-  refuses if one exists.
+  refuses if one exists. `--script` writes `Hammer::STARTER_SCRIPT`
+  (shebang + one `hello` task) to stdout instead, or to a positional
+  TARGET with mode 0755. Both templates are single-quoted heredocs in
+  `lib/lux-hammer.rb` - the one source of truth, also rendered in help.
 * `h:json` - `puts JSON` of `root.export_spec` (tasks grouped exactly
   like the bare listing via `section_for`, root group keyed `__root`).
   `--all` keeps the `h:` tree, `--compact` minifies.

data/README.md

@@ -634,6 +634,9 @@ Under the `h:` namespace:
 * `h:version` - print the lux-hammer version.
 * `h:recipes` - list / install / show / edit recipes.
 * `h:init` - write a starter Hammerfile in cwd (refuses if one exists).
+  `--script` prints a minimal standalone CLI to stdout instead (shebang
+  plus one `hello` task) - pipe it to a file and `chmod +x`, or name a
+  target to write and chmod in one step.
 * `h:json` - dump the CLI definition as JSON (tasks grouped like the
   bare listing, with desc/options/examples/aliases/needs/cron); `--all`
   includes the `h:` tasks, `--compact` minifies. Output is plain stdout
@@ -1135,7 +1138,16 @@ end
 ### `#!/usr/bin/env hammer` (single-file scripts)
 
 For a one-off CLI that lives as a single executable file, point the
-shebang straight at `hammer` - no `require`, no boilerplate:
+shebang straight at `hammer` - no `require`, no boilerplate. Start from
+the bundled template:
+
+```sh
+$ hammer h:init --script greet   # or: h:init --script > greet
+$ ./greet hello
+Hello from Hammer
+```
+
+Then fill it in - the body is plain Hammerfile DSL:
 
 ```ruby
 #!/usr/bin/env hammer

data/lib/hammer/builtins.rb

@@ -108,8 +108,24 @@ class Hammer
     def register_init(klass)
       klass.class_eval do
         task :init do
-          desc 'Write a starter Hammerfile in the current directory'
-          proc { Hammer::Builtins.write_starter_hammerfile }
+          desc <<~TXT
+            Write a starter Hammerfile in the current directory.
+
+            --script prints a minimal standalone CLI (shebang + one `hello`
+            task) to stdout instead - pipe it to a file, chmod +x, run it.
+            Name a TARGET to write and chmod in one step.
+          TXT
+          example 'h:init'
+          example 'h:init --script > mytool && chmod +x mytool'
+          example 'h:init --script mytool'
+          opt :script, type: :boolean, alias: :s, desc: 'print a standalone executable CLI (TARGET writes + chmod +x)'
+          proc do |opts|
+            if opts[:script]
+              Hammer::Builtins.write_starter_script(opts[:args].first)
+            else
+              Hammer::Builtins.write_starter_hammerfile
+            end
+          end
         end
       end
     end
@@ -237,6 +253,20 @@ class Hammer
       Shell.say "created #{target}", :green
     end
 
+    # `h:init --script`. No target -> stdout, so `> tool` works; with a
+    # target it lands executable. Never clobbers, same as the Hammerfile.
+    def write_starter_script(target = nil)
+      return puts(Hammer::STARTER_SCRIPT) unless target
+
+      if File.exist?(target)
+        Shell.print_error "#{target} already exists"
+        exit 1
+      end
+      File.write(target, Hammer::STARTER_SCRIPT)
+      File.chmod(0o755, target)
+      Shell.say "created #{target} (chmod +x)", :green
+    end
+
     # Implementations of the `recipes` task's action flags, plus the
     # no-flag listing view. Separate module so the task definition above
     # stays small.

data/lib/lux-hammer.rb

@@ -1118,6 +1118,20 @@ class Hammer
     end
   RUBY
 
+  # Minimal standalone CLI, dumped by `hammer h:init --script`. The
+  # shebang is what `shebang_script` sniffs for, so `chmod +x` is all
+  # that stands between this and a working binary.
+  STARTER_SCRIPT ||= <<~'RUBY'
+    #!/usr/bin/env hammer
+
+    desc 'My standalone CLI'
+
+    task :hello do
+      desc 'Print a greeting'
+      proc { say.green 'Hello from Hammer' }
+    end
+  RUBY
+
   # Default install dir used by install.sh and `hammer h:update`.
   SELF_UPDATE_DIR  ||= File.expand_path('~/.local/share/lux-hammer')
   SELF_UPDATE_REPO ||= 'https://github.com/dux/hammer.git'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.3.26
+  version: 0.3.27
 platform: ruby
 authors:
 - Dino Reic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-27 00:00:00.000000000 Z
+date: 2026-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest