- ruby-talk - ml.ruby-lang.org

[ruby-talk:444639] [ANN] clee-0.4.2
by ara.t.howard 09 Mar '25

09 Mar '25

*REF:* https://github.com/ahoward/clee *README.md:* NAME ---- `clee` TL;DR; -------- `clee` is a tiny, 0 dependency, DSL for building Ã¼ber clean CLIs in Ruby INSTALL ------- ```sh gem install clee ``` URI --- http://github.com/ahoward/clee ABOUT ----- `clee` is a minimalist version of `main` (https://github.com/ahoward/main) a command line DSL i wrote almost 15 years ago, that has seen over [4 million downloads](https://drawohara.io/rubygems/) > then why should i use `clee` instead of `main` ? * `clee` has 0 dependencies beyond ruby itself * `clee` is very very small ```sh drawohara@drawohara.dev:ahoward #=> loc clee/lib clee/lib/clee.rb: 478 === @loc: 478 drawohara@drawohara.dev:ahoward #=> loc main/lib main/lib/main/cast.rb: 139 main/lib/main/daemon.rb: 395 main/lib/main/dsl.rb: 65 main/lib/main/factories.rb: 24 main/lib/main/getoptlong.rb: 245 main/lib/main/logger.rb: 43 main/lib/main/mode.rb: 41 main/lib/main/parameter.rb: 589 main/lib/main/program/class_methods.rb: 362 main/lib/main/program/instance_methods.rb: 274 main/lib/main/program.rb: 6 main/lib/main/softspoken.rb: 12 main/lib/main/stdext.rb: 34 main/lib/main/test.rb: 69 main/lib/main/usage.rb: 159 main/lib/main/util.rb: 96 main/lib/main.rb: 70 === @loc: 2623 ``` * you can use this to decide which to use: ```ruby case when wants?(:simple, :tiny, :scripting) :clee when wants?(:powerful, :testable, :complete, :mature) :main else [:clee, :main].sort_by{ rand }.first end ``` API --- ##### `clee`'s api is very simple. it has every feature you need, and none that you don't, including: - auto generated help messages - support for `my_clee --help` and `my_clee help` to 'just work' - support for modifying help/usage messages simply - sane exit codes - support for --options, env=val pairs, etc - argv parsing - fancy color'd logging - modes, and sub-modes ##### the smallest clee script looks like this ```ruby require 'clee' clee do run do p 42 end end ``` ##### you can name your scripts ```ruby require 'clee' clee do run do help! #=> this will print a default usage message that will include 'my_clee' end end ``` ##### you can alter the default tldr, and help messages ```ruby require 'clee' clee do tldr <<~____ avoid using the default 'tldr' ____ end ``` ```ruby require 'clee' clee do help <<~____ NAME my_clee USAGE fully custom help... ____ end ``` ##### specifying params is trivial ```ruby require 'clee' clee do # support `my_clee --verbose` and -v # option :verbose, :v # support `my_clee --path=./lib` # option :path, value: :required # support `my_clee API_KEY=123` *and* `API_KEY=123 my_clee` # env :API_KEY # support `my_clee --foo=42` *and* `my_clee foo=42` *and* `foo=42 my_clee` syntax # param :foo, value: 'required' # the interface and help messages work the same way for all the above # def run if @options.has_key?(:verbose) @verbose = true end @path = @options.fetch(:path) @api_key = @env.fetch(:API_KEY) @foo = @parms.fetch(:foo) end end ``` ##### modes, and sub-modes, are supported ```ruby require 'clee' clee :my_clee do run :foo do p 42 end run :foo, :bar do p 42.0 end run do p 42.42 end end ``` ##### assuming you saved the above as `my_clee`, you could then do ```sh ~> my_clee foo #=> 42 ~> my_clee foo bar #=> 42.0 ~> my_clee #=> 42.42 ``` ##### `clee` scripts have a sweet dependency-less colored logger that understands what a #tty really is... ```ruby require 'clee' clee do def run log 'hai!' log 'hai!', level: :warning log 'blue', color: :blue end end ``` ##### `clee` ships with a lil code-gen-thang ```sh ~> clee new my_clee > my_clee ~> chmod 755 my_clee ~> ./my_clee ``` i could write more docs but, they would then outnumber the LOC of the library so: 1. see [./lib/clee.rb](./lib/clee.rb) 2. if that still doesn't float your boat install `ima`, a universal command-line filter built on `clee`, that brings AI to your CLI and do something like this ```sh ~> gem install clee ima ~> ima explain clee to me --context=$(gem which clee) ``` which might produce something like this -> --- Clee is a Ruby library that provides a simple way to create command-line interfaces (CLI) for Ruby applications. It allows developers to define commands, options, and parameters for their application, and handles the parsing and execution of these commands. The core features of Clee include: * Command definition: Clee allows developers to define commands and their associated options and parameters. * Option parsing: Clee can parse command-line options and parameters, and provides a simple way to define and handle these options. * Parameter handling: Clee provides a way to handle command-line parameters, including required and optional parameters. * Help generation: Clee can generate help text for commands and options, making it easy to provide documentation for users. * Logging: Clee provides a logging mechanism that allows developers to log messages at different levels (e.g. debug, info, warning, error). Clee is designed to be flexible and customizable, making it easy to integrate into existing Ruby applications. It also provides a number of features that make it easy to use, including automatic help generation and logging. Some of the key concepts in Clee include: * Commands: These are the top-level actions that a user can perform with the application. * Options: These are the flags or switches that can be used to modify the behavior of a command. * Parameters: These are the values that are passed to a command or option. * Modes: These are alternative behaviors that a command can exhibit, depending on the options or parameters passed to it. Overall, Clee is a powerful and flexible library that makes it easy to create command-line interfaces for Ruby applications. Its simple and intuitive API makes it easy to use, even for developers who are new to CLI development. --- SING IT ðŸŽµ ---------- * **DOCS are dead, long live AI!** * **UIs are dead, long live CLIS!** FINALLY ------- > why `clee`? that is honestly such a stupid name... a good friend used to pronounce 'cli' as 'clee'. it stuck. i like it. > i still need you write more docs for this free code [c'mon in!](https://github.com/ahoward/clee/pulls) -- - a "be kind whenever possible. it is always possible." -- h.h. the 14th dalai lama -->> https://drawohara.io

1 0

[ruby-talk:444635] Ruby Mixins vs Rails Concerns
by Andy Maleh 07 Mar '25

07 Mar '25

It is amazing how cryptic, difficult to reason about, and expensive to maintain Ruby codebases become when they include countless 'concerns' without honoring the Ruby naming convention for mixins as representing "traits"... Continue reading blog post: https://andymaleh.blogspot.com/2025/03/ruby-mixins-vs-rails-concerns.html

3 3

[ruby-talk:444634] [ANN] wxRuby3 1.5.1 released
by martin＠corino.nl 26 Feb '25

26 Feb '25

This is a minor update release. ** What's Changed ** * fix potential crash with use of Wx::PGChoiceEntry objects * update wxWidgets master branch compatibility to at least commit 4d5fbf5afa276ebec0fed95c8feb5d6ec485622d * fix some platform build configuration issues For more details see the original release announcement here: https://github.com/mcorino/wxRuby3/discussions/365

1 0

[ruby-talk:444633] Montreal.rb February 2025 Design Patterns in Ruby
by Andy Maleh 25 Feb '25

25 Feb '25

Design Patterns provide reusable solutions to common problems in Software Design and Implementation. Learn how to apply all 23 Design Patterns by the Gang of Four in Ruby by watching the Montreal.rb Ruby Meetup February 2025 Talk "Design Patterns in Ruby"! YouTube Video: https://www.youtube.com/watch?v=pi5RAynZWuA&list=PLRAf4zt5oEjc2mqmEN9m_O0Jo… Presentation Slides: https://docs.google.com/presentation/d/e/2PACX-1vRMuWVMfMQ9q2YQ_MIFG2i0Jer0… GitHub: https://github.com/AndyObtiva/design_patterns_in_ruby Blog: https://andymaleh.blogspot.com/2025/02/montrealrb-february-2025-design.html

1 0

[ruby-talk:444632] Montreal.rb January 2025 Talk "Responsibility Driven Design in Ruby" Learn the basics of Object Oriented Design and how to do Object Oriented Programming the right way in Ruby by watching the Montreal.rb Ruby Meetup January 2025 Talk "Responsibility Driven Design in Ruby"! YouTube Video: https://www.youtube.com/watch?v=-KTUZDpMVKU&list=PLRAf4zt5oEjc2mqmEN9m_O0JovQCXxvxt&index=15 Presentation Slides: https://docs.google.com/presentation/d/e/2PACX-1vRMuWVMfMQ9q2YQ_MIFG2i0Jer0KDeGGnuRrZ4J8RQ
by Andy Maleh 21 Feb '25

21 Feb '25

Learn the basics of Object Oriented Design and how to do Object Oriented Programming the right way in Ruby by watching the Montreal.rb Ruby Meetup January 2025 Talk "Responsibility Driven Design in Ruby"! YouTube Video: https://www.youtube.com/watch?v=-KTUZDpMVKU&list=PLRAf4zt5oEjc2mqmEN9m_O0Jo… Presentation Slides: https://docs.google.com/presentation/d/e/2PACX-1vRMuWVMfMQ9q2YQ_MIFG2i0Jer0… GitHub Repo: https://github.com/AndyObtiva/design_patterns_in_ruby Blog Post: https://andymaleh.blogspot.com/2025/02/montrealrb-january-2025-responsibili…

1 0

[ruby-talk:444631] [ANN] JRuby 9.4.12.0 Released
by Thomas E Enebo 11 Feb '25

11 Feb '25

The JRuby community is pleased to announce the release of JRuby 9.4.12.0. - Homepage: https://www.jruby.org/ - Download: https://www.jruby.org/download JRuby 9.4.12.x targets Ruby 3.1 compatibility. Thank you to our contributors this release, you help keep JRuby moving forward! Critical Fixes - Added additional locking to the new Class#subclasses implementation to fix a concurrent modification error. #8602, #8603 Standard Library - jar-dependencies upgraded to 0.5.4 to fix an issue parsing Maven output on Java versions 9 and higher. #8606, [#8515] 4 Issues and PRs resolved for 9.4.12.0 #8602 ConcurrentModificationException in subclasses map #8603 Ensure subclass set prevents concurrent modification #8606 No such file or directory snakeyaml-engine-2.9.jar in JRuby 9.4.11.0 #8615 Use jar-dependencies 0.5.4 -- blog: http://blog.enebo.com twitter: tom_enebo mail: tom.enebo(a)gmail.com

1 0

[ruby-talk:444630] [ANN] wxRuby3 1.5.0 released
by martin＠corino.nl 31 Jan '25

31 Jan '25

This upgrade release extends the verified platforms and release packages to include MacOS 15 and the latest LinuxMint release as well as some fixes and improvements. ** What's Changed ** * add MacOS 15 verification builds and release packages * add missing Wx::EvtHandler#evt_joystick_events handler method * improve abd optimize event handler method generation * fix missing event handler methods due to naming mismatches * update wxWidgets master branch compatibility to at least commit 5469ba6d8e36af150892a9db16041060d1eec215 For more details see the original release announcement here: https://github.com/mcorino/wxRuby3/discussions/348

1 0

[ruby-talk:444629] [ANN] JRuby 9.4.11.0 Released
by Thomas E Enebo 29 Jan '25

29 Jan '25

The JRuby community is pleased to announce the release of JRuby 9.4.11.0. - Homepage: https://www.jruby.org/ - Download: https://www.jruby.org/download JRuby 9.4.11.x targets Ruby 3.1 compatibility. This release fixes two critical bugs in JRuby 9.4.10.0 and we recommend users skip that version when upgrading. Thank you to our contributors this release, you help keep JRuby moving forward! - Karol Bucek @kares Critical Fixes - Fixed an issue where Mutex lock acquisition may leave the Mutex locked if an asynchronous Thread interrupt happens at the same time. #8585, #8586 - Fixed a memory leak where singleton classes would leave behind bookkeeping objects that accumulated over time. #8591, #8598 Standard Library - rubygems been updated to version 3.6.3 to fix an incompatibility with bundler 2.6. #8590, #8596 - bundler has been updated to version 2.6.3. #8596 - jruby-openssl has been updated to 0.15.3. #8458, Release 0.15.3 - jar-dependencies has been updated to 0.5.3 to fix remaining issues loading Maven jars in containerized environments. #8593, #8595 9 Issues and PRs resolved for 9.4.11.0 #8458 [deps] bump jruby-openssl to 0.15.3 #8584 Remove dependency on jakarta.annotation-api #8585 Thread interrupt can leave Mutex locked in synchronize #8586 Unlock if poll triggers an exception #8590 Bundler v2.6.x is incomptible with Gem system version included in JRuby 9.4.10.0 by default #8591 Eliminate leak of non-concrete subclass references #8593 Cannot create a Rails app with JRuby 9.4.10.0, Rails 7.1.5.1 #8595 Update jar-dependencies to 0.5.3 #8596 Update rubygems to 3.6.3 and bundler to 2.6.3 #8598 Memory leak from ActiveRecord_Relation after upgrading from JRuby 9.4.9.0 to 9.4.10.0 -- blog: http://blog.enebo.com twitter: tom_enebo mail: tom.enebo(a)gmail.com

1 0

[ruby-talk:444627] Glimmer DSL for Web Wins in Fukuoka Prefecture Future IT Initiative 2025 Competition
by Andy Maleh 25 Jan '25

25 Jan '25

Glimmer DSL for Web (Ruby Web Frontend Framework) won an award in the Fukuoka Prefecture Future IT Initiative 2025 competition after I presented it to Yukihiro Matsumoto (the creator of Ruby) and other Fukuoka competition judges earlier this week on January 21, 2025! It's official! Matz approves of Glimmer DSL for Web!!! https://andymaleh.blogspot.com/2025/01/glimmer-dsl-for-web-wins-in-fukuoka.… Glimmer DSL for Web (Ruby Web Frontend Framework) GitHub Repository: https://github.com/AndyObtiva/glimmer-dsl-web

2 1

[ruby-talk:444626] [ANN] JRuby 9.4.10.0 Released
by Thomas E Enebo 21 Jan '25

21 Jan '25

JRuby 9.4.10.0 Released Tuesday, January 21 2025 The JRuby community is pleased to announce the release of JRuby 9.4.10.0. - Homepage: https://www.jruby.org/ - Download: https://www.jruby.org/download JRuby 9.4.x targets Ruby 3.1 compatibility. Thank you to our contributors this release, you help keep JRuby moving forward! Dani Smith @danini-the-panini Karol Bucek @kares mrnoname1000 @mrnoname1000 Ruby Compatibility - Fixed a NegativeArraySizeException crash parsing heredocs. #8355, #8557 - Users can now opt into Ruby 3.3 behavior for NoMethodError and NameError that no longer inspects the target object. This inspect frequently led to memory issues. Specify JRuby flag -XnameError.inspect.object=false or JVM property jruby.nameError.inspect.object=false to disable the inspect call. #216, #8384, #8538 - Implemented the missing Process.argv0 method, used by recent Bundler releases. #8568, #8570 Standard Library - The jar-dependencies gem, responsible for fetching jar file dependencies of Ruby gems, can now be updated independently of JRuby. #7262, #8488, #8502 - An upcoming release of jar-dependencies, will fix issues sourcing jar dependencies in container deployments (partially fixed previously by an updated ruby-maven-libs gem). #7059, #8366 - The psych gem is updated to version 5.2.3, including a fix for YAML aliases from SnakeYAML-Engine version 2.9. #8352, #8575 - The reline gem is updated to 0.5.12. #8481 Java Integration - Only JVM classes imported from the same classloader hierarchy as JRuby will be bound to constants in JRuby’s package hierarchy. #8156 - Implementing a Java interface no longer leads to constant redefinition warnings. #8349, #8503 - Precompiled Ruby scripts now properly prepare optimized homogeneous case/when statements. Previously they would deserialize incorrectly and garble the branches. #8421, #8424 Performance and Usability - Additional runtime data structures are eagerly cleared when tearing down a JRuby runtime, aiding GC. #8343, #8566 - The JRuby shell-based launcher script now properly handles JRuby installed in a path with spaces. #8441, #8442 - The Class#subclasses method has been optimized to eliminate it as a bottleneck in complex ActiveRecord STI queries. #8457, #8462 - Integer multiplication operations that overflow outside of int64 range have been optimized to eliminate heavy exception raises. #8516, #8523 Issues and PRs resolved for 9.4.10.0 #7059 Issue of Jar dependency with Jruby-9.3.3.0 #7262 jar-dependencies cannot be updated out-of-band from jruby #8156 JRuby adds Java proxy classes to the Java module even if they are not from JRubyClassLoader #8343 Free up memory memory used by JRuby during teardown #8349 internal proxy class is stored in Ruby land and prints warning #8352 Cyclic references in Set objects raise exception with YAML#load #8355 NegativeArraySizeException while parsing Heredoc in irb in JRuby 9.4.8.0 #8366 Jruby 9.4.8.0 fails to install psych #8384 OutOfMemoryError while constructing a NameError in the context of a large object #8398 ruby2_keywords + forwarding to native does not properly check arity #8412 Intermittent exceptions with ‘Java::JavaLang::NoClassDefFoundError : org/jruby/gen/RubyObject13’ #8415 Skip extension builds for default gems #8416 [Possible bug] Can not start jruby-swing applications since 9.4.9.0 - or rather, the window auto-closes almost instantly #8417 Trivial refactoring for match #8421 Incorrect case tree selection when comparing long Symbols during compiled Ruby code execution #8424 Sort the jump tables based on new values #8425 Don’t clear the ThreadGroup when Thread terminates #8431 jruby/thread_dump.rb seems to be broken #8433 Root specialized object classloader at JRuby classloader #8436 Pass Enumerable#uniq arguments properly #8438 Remove rogue exit(0) that shuts down JVM #8441 Spaces in the path cause bin/jruby script to build an invalid command string #8442 jruby.sh: Use array to handle option files #8457 Class#subclasses slows down with larger sets #8462 Optimize Class#subclasses #8466 jirb 9.4.9.0 - reline “cannot convert parameter to native pointer” #8469 fix –jdb -sourcepath command #8477 Update to jar-dependencies 0.5.0 #8478 Avoid re-polling while reporting a Thread#raise #8479 Thread interrupt requests can overwrite each other #8480 Provide concrete-only traversal for Class#subclasses #8481 Update reline to 0.5.12 #8488 Issues bundling psych related to the jar-dependencies bump #8502 Avoid loading jar-dependencies to install gem hook #8503 [ji] do not expose InterfaceImpl classes in Ruby land #8511 Update to jruby-maven-plugins 3.0.4 #8512 Disable Maven download progress output on CI jobs #8515 Update jruby-maven-plugins to 3.0.5 #8516 Strange performance difference? #8523 Revert multiply to use non-intrinsic exactness checks #8538 Backport no-inspect NameError logic #8557 Fixes #8355: wallpaper crash in heredoc eof error #8562 Use same logic as IR for kwarg handling in IO#write #8566 Additional teardown to aid GC and release resources #8567 Update thread dump hook for modern JRuby #8568 Process.argv0 missing #8570 Add Process.argv0 #8571 Update to jcodings 1.0.59 #8572 Use warning instead of warning when adding attr as module_function #8573 Update jcodings to 1.0.61 and joni to 2.2.3 #8575 Update psych to 5.2.3 -- blog: http://blog.enebo.com twitter: tom_enebo mail: tom.enebo(a)gmail.com

1 0