lux-hammer 0.3.9 → 0.3.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60fa663d47e0d1d68790c40125c1594ae0152d99695cd57fe1d86294b1a5c348
-  data.tar.gz: 779a8291e200bff69a8c3b237662a88647a50071eb038f47fe695d547c805094
+  metadata.gz: 81af43fc44619384d2b62f58e7d3178a1b6edb22cbb1ef4e836b73e2ee469913
+  data.tar.gz: 47d012b5e54d1e8df3441de01eeaee3e3267f71c4ac8545b80f413d419bd3fc6
 SHA512:
-  metadata.gz: 6b2114d72e01ee7aef8166a4881915d4c124e0cce67c6c9e5d680fb945750aa8b338fc7041332dcaf6d54fe15fac04cf3e85271e8cd75b5bc3126edacb30f827
-  data.tar.gz: 7f85fb830fae721e969e2d23e28a9c282c6655b8b9f29aa5c8dd15a9fa3e5f55eddcfa9a978d7605c37c1ca20c177b43c1475114f64f870e41e5993c56287854
+  metadata.gz: d1dd7d495b96a6f7023601427dadcd492e593934c6407eb48dcb7c53fea26e33ea44ec40ef3a69856199fa75dd9d6278a8d32b14cbd4733b692dbbfe662f97ee
+  data.tar.gz: 2a9b223844fd645a79403c653a2bf25be28ba5654eef8562738b2f3768b0a72bddfd8b5ceb3dfe68ac7c583ecaaefc18fcee4d64f3f47964a93ff8f12b0fb586

data/.version

@@ -1 +1 @@
-0.3.9
+0.3.10

data/README.md

@@ -946,6 +946,41 @@ Hammer.run ARGV do
 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:
+
+```ruby
+#!/usr/bin/env hammer
+# desc: tiny greeter
+
+task :hello do
+  desc 'say hi'
+  opt :loud, type: :boolean, alias: :l
+  proc do |opts|
+    msg = "hello #{opts[:args].first || 'world'}"
+    say.cyan(opts[:loud] ? msg.upcase : msg)
+  end
+end
+```
+
+```sh
+$ chmod +x greet
+$ ./greet hello dino -l
+HELLO DINO
+$ ./greet --help
+Usage: greet COMMAND [ARGS]
+  ...
+```
+
+The file body is plain Hammerfile DSL (`task`, `namespace`, `before`,
+`load`). `hammer` detects the shebang, evaluates the script as a
+self-contained CLI, and uses the script's basename as the program name
+in help - so `./greet --help` reads "Usage: greet ..." rather than
+"Usage: hammer ...". The current working directory is left alone, so
+relative paths inside the script resolve where the user ran it.
+
 ## Complete example (every feature)
 
 ```ruby
@@ -1192,21 +1227,19 @@ few small things that have been bugging me about both for years.
 
 | | Thor | hammer |
 |-|-|-|
-| Lines of code | ~6,000 | ~400 |
 | Runtime deps | a few | zero |
-| Root constants | `Thor`, `Thor::Group`, `Thor::Shell`, `Thor::Actions`, ... | just `Hammer` |
 | Command DSL | `desc 'usage', 'help'` + `method_option` + `def name(arg)` | `task :name do ... proc do \|opts\| end end` (or classic `desc` + `def`) |
 | Opts container | `Thor::CoreExt::HashWithIndifferentAccess` | plain `Hash` with symbol keys |
 | Positional args | method positional params + `method_option`, two parallel systems | declared-order opts fill from positional, single system |
 | Sub-namespaces | `register SubClass, 'name', '...'` (inheritance ceremony) | `namespace :name do ... end` (no classes needed) |
+| Command aliases | none (workarounds via `map`) | `alt :s, :srv` |
+| Pre-hooks | none built-in | `before { ... }` per scope, `needs :env` per command |
+| Chained dispatch | no | `hammer build + deploy + notify` |
 | Cross-invoke | `invoke 'name', [args], opts` | `hammer :name, **opts` (looks like a method call) |
 | Inline CLI | class only | class DSL **or** `Hammer.run do ... end` block DSL **or** a `Hammerfile` |
 
 **What hammer does better and why:**
 
-* **One root constant.** Thor exposes `Thor`, `Thor::Group`, `Thor::Shell`,
-  `Thor::Actions` at the top level - Bundler had to vendor its own copy at
-  `Bundler::Thor` to avoid clashes. Hammer is just `Hammer`.
 * **The opts hash is just a Hash.** Symbol keys, always. No magic accessor
   object to remember, no string-vs-symbol confusion, no method_missing.
 * **Positional args fill opts in declaration order.** Thor either forces
@@ -1225,15 +1258,18 @@ few small things that have been bugging me about both for years.
 | | Rake | hammer |
 |-|-|-|
 | Primary use case | build/task automation with file deps | general CLIs |
-| Task file | `Rakefile` | `Hammerfile` |
+| Task file | `Rakefile` | `Hammerfile` (walks up parent dirs) |
 | Namespacing | colon paths (`db:migrate`) | colon paths (`db:migrate`) - parity |
 | Per-task options | `task[a,b,c]` positional only | typed `opt`s with flags, aliases, defaults, required |
 | Help | `rake -T` (plain list) | bare `hammer` lists everything grouped by namespace; `hammer X -h` for per-command help with examples and defaults |
 | Cross-invoke | `Rake::Task['db:migrate'].invoke` | `hammer 'db:migrate'` |
-| Prerequisites | `task :build => [:clean, :compile]` (declarative DAG) | explicit - call `hammer :clean; hammer :compile` in the proc |
+| Prerequisites | `task :build => [:clean, :compile]` (declarative DAG) | `needs :clean, :compile` (declarative, deduped across `+` chains) |
+| Pre-hooks | none built-in | `before { ... }` scoped to root or namespace |
+| Chained dispatch | no (multi-task argv runs sequentially, no per-task flags) | `hammer build prod -v + db:migrate --pretend + deploy` |
 | File tasks | yes (mtime-based) | no |
 | Aliases | none (workarounds via re-defined tasks) | `alt :short_name` |
 | Split across files | `import 'other.rake'` | `load auto: true` (or explicit paths/globs) |
+| Shareable scripts | no | recipes (one-file CLIs installable as their own binary) |
 
 **What hammer does better and why:**
 

data/lib/hammer/command.rb

@@ -39,5 +39,34 @@ class Hammer
       name = name.to_s
       name == @name || @alts.include?(name)
     end
+
+    # Auto-assign a single-letter short alias (first letter of the opt
+    # name) to any opt that does not already declare one. Explicit
+    # aliases and `-h` are reserved first, so they always win. On
+    # collision the opt simply gets no short form - long flag still
+    # works. Idempotent.
+    def finalize!
+      return if @finalized
+      @finalized = true
+
+      claimed = ['-h']
+      @options.each do |o|
+        o.aliases.each { |a| claimed << a if short_flag?(a) }
+      end
+
+      @options.each do |o|
+        next if o.aliases.any? { |a| short_flag?(a) }
+        short = "-#{o.name.to_s[0]}"
+        next if claimed.include?(short)
+        o.aliases << short
+        claimed << short
+      end
+    end
+
+    private
+
+    def short_flag?(switch)
+      switch.length == 2 && switch.start_with?('-') && switch[1] != '-'
+    end
   end
 end

data/lib/lux-hammer.rb

@@ -96,6 +96,7 @@ class Hammer
       m = method_name
       arity = instance_method(method_name).arity
       cmd.handler = arity.zero? ? proc { send(m) } : proc { |opts| send(m, opts) }
+      cmd.finalize!
       commands[cmd.name] = cmd
 
       @pending_desc = nil
@@ -168,6 +169,7 @@ class Hammer
         warn_redefinition('task', cmd.name, prev.location, cmd.location)
       end
 
+      cmd.finalize!
       commands[cmd.name] = cmd
 
       # `task` ignores pending class-level state, but clear it so a

metadata

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