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

[ruby-talk:444386] Ruby 3.3.0 Released
by NARUSE, Yui 25 Dec '23

25 Dec '23

We are pleased to announce the release of Ruby 3.3.0. Ruby 3.3 adds a new parser named Prism, uses Lrama as a parser generator, adds a new pure-Ruby JIT compiler named RJIT, and many performance improvements especially YJIT. ## Prism * Introduced [the Prism parser](https://github.com/ruby/prism) as a default gem * Prism is a portable, error tolerant, and maintainable recursive descent parser for the Ruby language * Prism is production ready and actively maintained, you can use it in place of Ripper * There is [extensive documentation](https://ruby.github.io/prism/) on how to use Prism * Prism is both a C library that will be used internally by CRuby and a Ruby gem that can be used by any tooling which needs to parse Ruby code * Notable methods in the Prism API are: * `Prism.parse(source)` which returns the AST as part of a parse result object * `Prism.parse_comments(source)` which returns the comments * `Prism.parse_success?(source)` which returns true if there are no errors * You can make pull requests or issues directly on [the Prism repository](https://github.com/ruby/prism) if you are interested in contributing * You can now use `ruby --parser=prism` or `RUBYOPT="--parser=prism"` to experiment with the Prism compiler. Please note that this flag is for debugging only. ## Use Lrama instead of Bison * Replace Bison with [Lrama LALR parser generator](https://github.com/ruby/lrama) [[Feature #19637]](https://bugs.ruby-lang.org/issues/19637) * If you have interest, please see [The future vision of Ruby Parser](https://rubykaigi.org/2023/presentations/spikeolaf.html) * Lrama internal parser is replaced with LR parser generated by Racc for maintainability * Parameterizing Rules `(?, *, +)` are supported, it will be used in Ruby parse.y ## YJIT * Major performance improvements over Ruby 3.2 * Support for splat and rest arguments has been improved. * Registers are allocated for stack operations of the virtual machine. * More calls with optional arguments are compiled. Exception handlers are also compiled. * Unsupported call types and megamorphic call sites no longer exit to the interpreter. * Basic methods like Rails `#blank?` and [specialized `#present?`](https://github.com/rails/rails/pull/49909) are inlined. * `Integer#*`, `Integer#!=`, `String#!=`, `String#getbyte`, `Kernel#block_given?`, `Kernel#is_a?`, `Kernel#instance_of?`, and `Module#===` are specially optimized. * Compilation speed is now slightly faster than Ruby 3.2. * Now more than 3x faster than the interpreter on Optcarrot! * Significantly improved memory usage over Ruby 3.2 * Metadata for compiled code uses a lot less memory. * `--yjit-call-threshold` is automatically raised from 30 to 120 when the application has more than 40,000 ISEQs. * `--yjit-cold-threshold` is added to skip compiling cold ISEQs. * More compact code is generated on Arm64. * Code GC is now disabled by default * `--yjit-exec-mem-size` is treated as a hard limit where compilation of new code stops. * No sudden drops in performance due to code GC. Better copy-on-write behavior on servers reforking with [Pitchfork](https://github.com/shopify/pitchfork). * You can still enable code GC if desired with `--yjit-code-gc` * Add `RubyVM::YJIT.enable` that can enable YJIT at run-time * You can start YJIT without modifying command-line arguments or environment variables. Rails 7.2 will [enable YJIT by default](https://github.com/rails/rails/pull/49947) using this method. * This can also be used to enable YJIT only once your application is done booting. `--yjit-disable` can be used if you want to use other YJIT options while disabling YJIT at boot. * More YJIT stats are available by default * `yjit_alloc_size` and several more metadata-related stats are now available by default. * `ratio_in_yjit` stat produced by `--yjit-stats` is now available in release builds, a special stats or dev build is no longer required to access most stats. * Add more profiling capabilities * `--yjit-perf` is added to facilitate profiling with Linux perf. * `--yjit-trace-exits` now supports sampling with `--yjit-trace-exits-sample-rate=N` * More thorough testing and multiple bug fixes ## RJIT * Introduced a pure-Ruby JIT compiler RJIT and replaced MJIT. * RJIT supports only x86-64 architecture on Unix platforms. * Unlike MJIT, it doesn't require a C compiler at runtime. * RJIT exists only for experimental purposes. * You should keep using YJIT in production. * If you are interested in developing JIT for Ruby, please check out [k0kubun's presentation on Day 3 of RubyKaigi](https://rubykaigi.org/2023/presentations/k0kubun.html#day3). ## M:N thread scheduler * M:N thread scheduler was introduced. [[Feature #19842]](https://bugs.ruby-lang.org/issues/19842) * M Ruby threads are managed by N native threads (OS threads) so the thread creation and management cost are reduced. * It can break C-extension compatibility so that M:N thread scheduler is disabled on the main Ractor by default. * `RUBY_MN_THREADS=1` environment variable enables M:N threads on the main Ractor. * M:N threads are always enabled on non-main Ractors. * `RUBY_MAX_CPU=n` environment variable sets maximum number of `N` (maximum number of native threads). The default value is 8. * Since only one Ruby thread per Ractor can run at the same time, the number of native threads will be used, which is the smaller of the number specified in `RUBY_MAX_CPU` and the number of running Ractors. So that single Ractor applications (most of applications) will only use 1 native thread. * To support blocking operations, more than `N` native threads can be used. ## Performance improvements * `defined?(@ivar)` is optimized with Object Shapes. * Name resolution such as `Socket.getaddrinfo` can now be interrupted (in environments where pthreads are available). [[Feature #19965]](https://bugs.ruby-lang.org/issues/19965) * Several performance improvements to the Garbage Collector * Young objects referenced by old objects are no longer immediately promoted to the old generation. This significantly reduces the frequency of major GC collections. [[Feature #19678]](https://bugs.ruby-lang.org/issues/19678) * A new `REMEMBERED_WB_UNPROTECTED_OBJECTS_LIMIT_RATIO` tuning variable was introduced to control the number of unprotected objects cause a major GC collection to trigger. The default is set to `0.01` (1%). This significantly reduces the frequency of major GC collection. [[Feature #19571]](https://bugs.ruby-lang.org/issues/19571) * Write Barriers were implemented for many core types that were missing them, notably `Time`, `Enumerator`, `MatchData`, `Method`, `File::Stat`, `BigDecimal` and several others. This significantly reduces minor GC collection time and major GC collection frequency. * Most core classes are now using Variable Width Allocation, notably `Hash`, `Time`, `Thread::Backtrace`, `Thread::Backtrace::Location`, `File::Stat`, `Method`. This makes these classes faster to allocate and free, use less memory and reduce heap fragmentation. * Support for weak references has been added to the garbage collector. [[Feature #19783]](https://bugs.ruby-lang.org/issues/19783) ## Other notable changes since 3.2 ### IRB IRB has received several enhancements, including but not limited to: - Advanced `irb:rdbg` integration that provides an equivalent debugging experience to `pry-byebug` ([doc](https://github.com/ruby/irb#debugging-with-irb)) - Pager support for `ls`, `show_source` and `show_cmds` commands. - More accurate and helpful information provided by the `ls` and `show_source` commands. - Experimental autocompletion using type analysis ([doc](https://github.com/ruby/irb#type-based-completion)) - It is now possible to change the font color and font style in the completion dialog by a newly introduced class Reline::Face ([doc](https://github.com/ruby/ruby/blob/master/doc/reline/face.md)) In addition, IRB has also undergone extensive refactoring and received dozens of bug fixes to facilitate easier future enhancements. ## Compatibility issues Note: Excluding feature bug fixes. * `it` calls without arguments in a block with no ordinary parameters are deprecated. `it` will be a reference to the first block parameter in Ruby 3.4. [[Feature #18980]](https://bugs.ruby-lang.org/issues/18980) ### Removed environment variables The following deprecated methods are removed. * Environment variable `RUBY_GC_HEAP_INIT_SLOTS` has been deprecated and is a no-op. Please use environment variables `RUBY_GC_HEAP_{0,1,2,3,4}_INIT_SLOTS` instead. [[Feature #19785]](https://bugs.ruby-lang.org/issues/19785) ## Stdlib compatibility issues ### `ext/readline` is retired * We have `reline` that is pure Ruby implementation compatible with `ext/readline` API. We rely on `reline` in the future. If you need to use `ext/readline`, you can install `ext/readline` via rubygems.org with `gem install readline-ext`. * We no longer need to install libraries like `libreadline` or `libedit`. ## Standard library updates RubyGems and Bundler warn if users do `require` the following gems without adding them to Gemfile or gemspec. This is because they will become the bundled gems in the future version of Ruby. This warning is suppressed if you use bootsnap gem. We recoomend to run your application with `DISABLE_BOOTSNAP=1` environmental variable at least once. This is limitation of this version. Targeted libraries are: * abbrev * base64 * bigdecimal * csv * drb * getoptlong * mutex_m * nkf * observer * racc * resolv-replace * rinda * syslog The following default gem is added. * prism 0.19.0 The following default gems are updated. * RubyGems 3.5.3 * abbrev 0.1.2 * base64 0.2.0 * benchmark 0.3.0 * bigdecimal 3.1.5 * bundler 2.5.3 * cgi 0.4.1 * csv 3.2.8 * date 3.3.4 * delegate 0.3.1 * drb 2.2.0 * english 0.8.0 * erb 4.0.3 * error_highlight 0.6.0 * etc 1.4.3 * fcntl 1.1.0 * fiddle 1.1.2 * fileutils 1.7.2 * find 0.2.0 * getoptlong 0.2.1 * io-console 0.7.1 * io-nonblock 0.3.0 * io-wait 0.3.1 * ipaddr 1.2.6 * irb 1.11.0 * json 2.7.1 * logger 1.6.0 * mutex_m 0.2.0 * net-http 0.4.0 * net-protocol 0.2.2 * nkf 0.1.3 * observer 0.1.2 * open-uri 0.4.1 * open3 0.2.1 * openssl 3.2.0 * optparse 0.4.0 * ostruct 0.6.0 * pathname 0.3.0 * pp 0.5.0 * prettyprint 0.2.0 * pstore 0.1.3 * psych 5.1.2 * rdoc 6.6.2 * readline 0.0.4 * reline 0.4.1 * resolv 0.3.0 * rinda 0.2.0 * securerandom 0.3.1 * set 1.1.0 * shellwords 0.2.0 * singleton 0.2.0 * stringio 3.1.0 * strscan 3.0.7 * syntax_suggest 2.0.0 * syslog 0.1.2 * tempfile 0.2.1 * time 0.3.0 * timeout 0.4.1 * tmpdir 0.2.0 * tsort 0.2.0 * un 0.3.0 * uri 0.13.0 * weakref 0.1.3 * win32ole 1.8.10 * yaml 0.3.0 * zlib 3.1.0 The following bundled gem is promoted from default gems. * racc 1.7.3 The following bundled gems are updated. * minitest 5.20.0 * rake 13.1.0 * test-unit 3.6.1 * rexml 3.2.6 * rss 0.3.0 * net-ftp 0.3.3 * net-imap 0.4.9 * net-smtp 0.4.0 * rbs 3.4.0 * typeprof 0.21.9 * debug 1.9.1 See GitHub releases like [Logger](https://github.com/ruby/logger/releases) or changelog for details of the default gems or bundled gems. See [NEWS](https://github.com/ruby/ruby/blob/v3_3_0/NEWS.md) or [commit logs](https://github.com/ruby/ruby/compare/v3_2_0...v3_3_0) for more details. With those changes, [5532 files changed, 326851 insertions(+), 185793 deletions(-)](https://github.com/ruby/ruby/compare/v3_2_0...v3_3_0#file_buc… since Ruby 3.2.0! Merry Christmas, Happy Holidays, and enjoy programming with Ruby 3.3! ## Download * <https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.0.tar.gz> SIZE: 22065999 SHA1: 1a7e56851bf29bda1183aca99b3b323c58e0187b SHA256: 96518814d9832bece92a85415a819d4893b307db5921ae1f0f751a9a89a56b7d SHA512: 26074009b501fc793d71a74e419f34a6033c9353433919ca74ba2d24a3de432dbb11fd92c2bc285f0e4d951a6d6c74bf5b69a2ab36200c8c26e871746d6e0fc6 * <https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.0.tar.xz> SIZE: 16345456 SHA1: c8f68e1b0a114b90460a0b44165a3b2f540fa5b6 SHA256: 676b65a36e637e90f982b57b059189b3276b9045034dcd186a7e9078847b975b SHA512: 7959c5753bfa0bfc4d6d74060869aabbe9815c1c97930659da11b917ee0803ddbbd80e869e00c48b8694b4ba48709c3b6493fd045568e36e902616c35ababf01 * <https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.0.zip> SIZE: 26935108 SHA1: a433eef1d7f96daeaf3b4cb842d0ed2dd82e7dc1 SHA256: 0e6563f679dd3694732eb3addf9de681c67b584602ac574376b60e7a509d2cd8 SHA512: a94a85937a14b217c1f4b90d24185289ed4aee79239c4f3eecf8034d3fd34e65ee8d66869473857ed153067188adc9b70c0471e4ebe842c9f98ef60c34090450 ## What is Ruby Ruby was first developed by Matz (Yukihiro Matsumoto) in 1993, and is now developed as Open Source. It runs on multiple platforms and is used all over the world especially for web development.

1 0

[ruby-talk:444385] [ANN] Graphs and Charts 0.1.1 (Custom Controls for Glimmer DSL for LibUI)
by Andy Maleh 16 Dec '23

16 Dec '23

Graphs and Charts is a new library for Glimmer DSL for LibUI that aims at providing Custom Controls for rendering graphs and charts. In version 0.1.1, it supports Line Graph in a new `line_graph` Custom Control for rendering lines (1 or more) connecting points with different y-axis values along a time-based x-axis. https://github.com/AndyObtiva/glimmer-libui-cc-graphs_and_charts/raw/master… GitHub : https://github.com/AndyObtiva/glimmer-libui-cc-graphs_and_charts RubyGem : https://rubygems.org/gems/glimmer-libui-cc-graphs_and_charts Blog Post Announcement : https://andymaleh.blogspot.com/2023/12/graphs-and-charts-011-custom-control…

1 0

[ruby-talk:444384] [ANN] wxRuby3 0.9.3 release
by martin＠corino.nl 16 Dec '23

16 Dec '23

This release brings some major additions and improvements for validation and data binding. wxRuby3 is a cross-platform GUI library for Ruby, based on the mature wxWidgets GUI toolkit for C++. It uses native widgets wherever possible, providing the correct look, feel and behavior to GUI applications on Windows, OS X and Linux/GTK. wxRuby aims to provide a comprehensive solution to developing professional-standard desktop applications in Ruby. wxRuby3 also provides extensive and complete reference documentation. What's changed in this release: - improve and extend client/user data support (see new documentation) - improve and extend validator support (see new validator documentation) - add numeric validators - add generic validator - add missing widgets - Wx::BitmapToggleButton - Wx::GenericStaticBitmap - add port of wxWidgets Widgets sample - add bitmask test methods to Wx::Enum - various other (stability and functionality) improvements - documentation improvements IMPORTANT: 1 minor breaking change: - Wx::Window#raise has been renamed to Wx::Window#raise_window to avoid the annoying and confusing clash with the ::Kernel#raise method; for consistency reasons Wx::Window#lower has been renamed to Wx::Window#lower_window If you are interested check this out: Documentation: https://mcorino.github.io/wxRuby3/index.html Github: https://github.com/mcorino/wxruby3 Rubygems: https://rubygems.org/gems/wxruby3

1 0

[ruby-talk:444383] [ANN] httpx 1.2.0 released
by Tiago Cardoso 14 Dec '23

14 Dec '23

httpx 1.2.0 has been released. ``` HTTPX.get("https://gitlab.com/honeyryderchuck/httpx <https://gitlab.com/honeyryderchuck/httpx>") ``` HTTPX is an HTTP client library for the Ruby programming language. Among its features, it supports: * HTTP/2 and HTTP/1.x protocol versions * Concurrent requests by default * Simple and chainable API * Proxy Support (HTTP(S), CONNECT tunnel, Socks4/4a/5) * Simple Timeout System * Lightweight by default (require what you need) And also: * Compression (gzip, deflate, brotli) * Streaming Requests * Authentication (Basic Auth, Digest Auth, AWS Sigv4) * Expect 100-continue * Multipart Requests * Cookies * HTTP/2 Server Push * H2C Upgrade * Automatic follow redirects * International Domain Names * GRPC * Circuit breaker * WebDAV * SSRF Filter * Datadog integration * Faraday integration * Webmock integration * Sentry integration Here are the updates since the last release: # 1.2.0 ## Features ### `:ssrf_filter` plugin The `:ssrf_filter` plugin prevents server-side request forgery attacks, by blocking requests to the internal network. This is useful when the URLs used to perform requests aren’t under the developer control (such as when they are inserted via a web application form). ```ruby http = HTTPX.plugin(:ssrf_filter) # this works response = http.get("https://example.com") # this doesn't response = http.get("http://localhost:3002") response = http.get("http://[::1]:3002") response = http.get("http://169.254.169.254/latest/meta-data/") ``` More info under https://honeyryderchuck.gitlab.io/httpx/wiki/SSRF-Filter ### `:callbacks` plugin The session callbacks introduced in v0.24.0 are in its own plugin. Older code will still work and emit a deprecation warning. More info under https://honeyryderchuck.gitlab.io/httpx/wiki/Callbacks ### `:redirect_on` option for `:follow_redirects` plugin This option allows passing a callback which, when returning `false`, can interrupt the redirect loop. ```ruby http = HTTPX.plugin(:follow_redirects).with(redirect_on: ->(location_uri) { BLACKLIST_HOSTS.include?(location_uri.host) ] ``` ### `:close_on_handshake_timeout` timeout A new `:timeout` option, `:close_handshake_timeout`, is added, which monitors connection readiness when performing HTTP/2 connection termination handshake. ## Improvements * Internal "eden connections" concept was removed, and connection objects are now kept-and-reused during the lifetime of a session, even when closed. This simplified connectio pool implementation and improved performance. * request using `:proxy` and `:retries` plugin enabled sessions will now retry on proxy connection establishment related errors. ## Bugfixes * webmock adapter: mocked responses storing decoded payloads won't try to decode them again (fixes vcr/webmock integrations). * webmock adapter: fix issue related with making real requests over webmock-enabled connection. # 1.1.5 ## improvements * pattern matching support for responses has been backported to ruby 2.7 as well. ## bugfixes * `stream` plugin: fix for `HTTPX::StreamResponse#each_line` not yielding the last line of the payload when not delimiter-terminated. * `stream` plugin: fix `webmock` adapter integration when methods calls would happen in the `HTTPX::StreamResponse#each` block. * `stream` plugin: fix `:follow_redirects` plugin integration which was caching the redirect response and using it for method calls inside the `HTTPX::StreamResponse#each` block. * "103 early hints" responses will be ignored when processing the response (it was causing the response returned by sesssions to hold its headers, instead of the following 200 response, while keeping the 200 response body). # 1.1.4 ## bugfixes * datadog adapter: use `Gem::Version` to invoke the correct configuration API. * stream plugin: do not preempt request enqueuing (this was making integration with the `:follow_redirects` plugin fail when set up with `webmock`). # 1.1.3 ## improvements ## security * when using `:follow_redirects` plugin, the "authorization" header will be removed when following redirect responses to a different origin. ## bugfixes * fixed `:stream` plugin not following redirect responses when used with the `:follow_redirects` plugin. * fixed `:stream` plugin not doing content decoding when responses were p.ex. gzip-compressed. * fixed bug preventing usage of IPv6 loopback or link-local addresses in the request URL in systems with no IPv6 internet connectivity (the request was left hanging). * protect all code which may initiate a new connection from abrupt errors (such as internet turned off), as it was done on the initial request call. ## chore internal usage of `mutex_m` has been removed (`mutex_m` is going to be deprecated in ruby 3.3). # 1.1.2 ## improvements * only moving eden connections to idle when they're recycled. ## bugfixes * skip closing a connection which is already closed during reset. * sentry adapter: fixed `super` call which didn't have a super method (this prevented usinng sentry-enabled sessions with the `:retries` plugin). * sentry adapter: fixing registering of sentry config. * sentry adapter: do not propagate traces when relevant sdk options are disabled (such as `propagate_traces`). # 1.1.1 ## improvements * (Re-)enabling default retries in DNS name queries; this had been disabled as a result of revamping timeouts, and resulted in queries only being sent once, which is very little for UDP-related traffic, and breaks if using DNs rate-limiting software. Retries the query just once, for now. ## bugfixes * reset timers when adding new intervals, as these may be added as a result on after-select connection handling, and must wait for the next tick cycle (before the patch, they were triggering too soon). * fixed "on close" callback leak on connection reuse, which caused linear performance regression in benchmarks performing one request per connection. * fixed hanging connection when an HTTP/1.1 emitted a "connection: close" header but the server would not emit one (it closes the connection now). * fixed recursive dns cached lookups which may have already expired, and created nil entries in the returned address list. * dns system resolver is now able to retry on failure. ## chore * remove duplicated callback unregistering connections.

1 0

[ruby-talk:444379] Building Ruby on Windows 10
by knchandan＠gmail.com 23 Nov '23

23 Nov '23

Hi, I'm trying to build Ruby 3.2.2 source code on Windows 10 using Visual Studio 2019. I downloaded the source code using link https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.2.tar.gz from https://www.ruby-lang.org/en/downloads/. I'm following the steps mentioned in this (https://docs.ruby-lang.org/en/master/windows_md.html) Following is the configuration that I'm executing from the Visual Studio 2019 Native x64 command prompt. d:\...\ruby3.2.2> win32\configure --prefix=/usr/local --target=x64-mswin64 --disable-install-doc --with-opt-dir=C:\gitviews\opensource\vcpkg\installed\x64-windows\ I get the following error. How do I make sure these packages are of the correct version and compatible with Ruby 3.2.2? ----------------------------------------------------------------------------------- ... compiling rubyw.rc linking rubyw.exe *** Following extensions are not compiled: fiddle: " Could not be configured. It will not be installed." " D:/Ruby/ruby-3.2.2.tar/ruby-3.2.2/ext/fiddle/extconf.rb:73: missing libffi. Please install libffi or use --with-libffi-source-dir with libffi source location." " Check ext/fiddle/mkmf.log for more details." openssl: " Could not be configured. It will not be installed." " D:/Ruby/ruby-3.2.2.tar/ruby-3.2.2/ext/openssl/extconf.rb:101: OpenSSL library could not be found. You might want to use --with-openssl-dir=<dir> option to specify the prefix where OpenSSL is installed." " Check ext/openssl/mkmf.log for more details." psych: " Could not be configured. It will not be installed." " Check ext/psych/mkmf.log for more details." readline: " Could not be configured. It will not be installed." " D:/Ruby/ruby-3.2.2.tar/ruby-3.2.2/ext/readline/extconf.rb:62: Neither readline nor libedit was found" " Check ext/readline/mkmf.log for more details." zlib: " Could not be configured. It will not be installed." " Check ext/zlib/mkmf.log for more details." *** Fix the problems, then remove these directories and try again if you want. ... ----------------------------------------------------------------------------------- I have already installed the required packages using the following command under C:\gitviews\opensource\vcpkg\ d:\...\ruby3.2.2>vcpkg --triplet x64-windows install openssl libffi libyaml zlib readline ----------------------------------------------------------------------------------- ... openssl:x64-windows -> 3.1.4#1 zlib:x64-windows -> 1.3 The following packages will be built and installed: readline:x64-windows -> 0#5 * readline-win32:x64-windows -> 5.0#8 Additional packages (*) will be modified to complete this operation. Detecting compiler hash for triplet x64-windows... Restored 0 package(s) from C:\Users\310220077\AppData\Local\vcpkg\archives in 808 us. Use --debug to see more details. libffi:x64-windows is already installed libyaml:x64-windows is already installed openssl:x64-windows is already installed zlib:x64-windows is already installed Installing 1/2 readline-win32:x64-windows... ----------------------------------------------------------------------------------- Regards, Chandan

3 3

[ruby-talk:444143] Re: RubyConf 2022 Talk Video for Building Native GUI Apps in Ruby
by Andy Maleh 19 Nov '23

19 Nov '23

Andy Nutter-Upham, I just realized I didn't answer this exact question by you in full details (I read the original message on the phone while being quite busy with something a couple of weeks ago, and I somehow missed some of intricacies of your question): "If I missed the documentation and someone knows where it is, I'd love to read it. I think though that since this is a wrapper library there is instead reference to the underlying documentation (whose method names are a bit different, and whose arguments are a bit different) and I find that translation very challenging; especially since glimmer-dsl-libui is not yet complete, so your run into ineffective keywords if you rely on the underlying glimmer docs." Glimmer DSL for LibUI actually does have full documentation for the Ruby API: https://github.com/AndyObtiva/glimmer-dsl-libui#supported-keywords Someone asked me to add the documentation early on when the project was new, and I added it to that person's satisfaction. I hope it's helpful to you too. By the way, I also do mention under the "Original API" section that you could use the LibUI Go documentation as a reference: https://pkg.go.dev/github.com/andlabs/ui But, the most complete reference is the actual C headers: https://github.com/andlabs/libui/blob/master/ui.h And, the C headers are exposed as low-level FFI functions in Ruby as per the Original API (but it's not recommended that you use these method directly of course): https://github.com/AndyObtiva/glimmer-dsl-libui#original-api To give you an example of how the mapping from the C API to Ruby happens, suppose we have this C function: uiWindowSetTitle('My Application') The word before the "Set" or "Get" operation is the control object (e.g. window), and the word after it is the attribute (e.g. title). So, the equivalent of that in the Glimmer GUI DSL: window { title 'My Application' } Basically, we are declaring a window control with one nested attribute of title having the value 'My Application' The C API is procedural and imperative whereas the Glimmer GUI DSL is object-oriented and declarative, better mapping to the way we think of concepts visually while looking at a screen given that you could nest controls (widgets) within each other. If you need further help, do not hesitate to ask further questions at the Glimmer Gitter chat: https://app.gitter.im/#/room/#AndyObtiva_glimmer:gitter.im You shouldn't really get bogged down unless you are missing foundational grounding in software engineering concepts relating to desktop development in general, like MVC (Model View Controller). I've done GUI development professionally in older technologies like Java Swing in the past, and by comparison, Glimmer lets me leapfrog past productivity by 4x at least, sometimes 10x or even more (and it's that much faster in productivity than web development too, so it's great for building quick local apps or tools that don't need the web as it's much simpler, demanding a tiny fraction of web code only). But, it does assume you know MVC (Model View Controller) very well, and it benefits from also knowing MVP (Model View Presenter). Once you get the main ideas behind Glimmer, everything clicks, and things like exact APIs or detailed documentation wouldn't matter much anymore because the way you think with MVC/MVP is you start with the View layer from a GUI mockup to support a specific user workflow, and you either use native controls (like text and button, by looking them up in examples or the docs mentioned above) or you invent your own custom controls (both options are available in Glimmer DSL for LibUI). Of course, the native controls are only as complete as what is implemented by the underlying LibUI library. I know the authors of it are working on adding many new features, like a Tree control, Table sorting listeners, and some other missing features. They will all be added to Glimmer DSL for LibUI in due time when they get released in C LibUI. But, that shouldn't stop someone from learning the library and using whatever is available in it for now, or at least mastering the current features until more features are added in the future (especially given that you could always temporarily polyfill missing features by building your own custom controls if really needed). Cheers, Andy Maleh On Tue, Feb 14, 2023 at 9:27 PM grigoris charam <xargrigoris(a)gmail.com> wrote: > Stop reply all > > On Feb 15, 2023, at 03:05, Andy Maleh via ruby-talk < > ruby-talk(a)ml.ruby-lang.org> wrote: > > > The Glimmer Gitter Chat: > > https://app.gitter.im/#/room/#AndyObtiva_glimmer:gitter.im > > If you create any Glimmer related projects, libraries, or tools, you could > alert of us of them in the Gitter Chat. > > And, you can open issues or pull requests on any of the Glimmer projects > if needed: > <glimmer.png> > AndyObtiva/glimmer: DSL Framework consisting of a DSL Engine and a > Data-Binding Library used in Glimmer DSL for SWT (JRuby Desktop Development > GUI Framework), Glimmer DSL for Opal (Pure Ruby Web GUI), Glimmer DSL for > LibUI (Prerequisite-Free Ruby Desktop Development GUI Library), Glimmer DSL > for Tk (Ruby Tk Desktop Development GUI Library), Glimmer DSL for GTK > (Ruby-GNOME Desktop Development GUI Library), Glimmer DSL for XML (& HTML), > and Glimmer DSL for CSS <https://github.com/AndyObtiva/glimmer> > github.com <https://github.com/AndyObtiva/glimmer> > <https://github.com/AndyObtiva/glimmer> > > > Andy Maleh > > > LinkedIn: https://www.linkedin.com/in/andymaleh > <https://www.linkedin.com/in/andymaleh> > Blog: https://andymaleh.blogspot.com > GitHub: https://github.com/AndyObtiva > Twitter: https://www.twitter.com/AndyObtiva > > On Feb 14, 2023, at 7:51 PM, Fellipe Fingoli via ruby-talk < > ruby-talk(a)ml.ruby-lang.org> wrote: > > > really good content! I want to help to develop this ecosystem. Does > anybody know where I can reach the community? > > Em ter., 7 de fev. de 2023 às 18:29, Andy Maleh via ruby-talk < > ruby-talk(a)ml.ruby-lang.org> escreveu: > >> My RubyConf 2022 talk video on "Building Native GUI Apps in Ruby" using >> the Fukuoka Award Winning Glimmer DSL for LibUI has just been released! >> >> https://youtu.be/1Bh4CnJqHyY >> >> Andy Maleh >> >> LinkedIn: https://www.linkedin.com/in/andymaleh >> <https://www.linkedin.com/in/andymaleh> >> Blog: http://andymaleh.blogspot.com >> GitHub: http://www.github.com/AndyObtiva >> Twitter: @AndyObtiva <https://twitter.com/AndyObtiva> >> >> ______________________________________________ >> ruby-talk mailing list -- ruby-talk(a)ml.ruby-lang.org >> To unsubscribe send an email to ruby-talk-leave(a)ml.ruby-lang.org >> ruby-talk info -- >> https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.or… > > > > -- > Fellipe Fingoli > ______________________________________________ > ruby-talk mailing list -- ruby-talk(a)ml.ruby-lang.org > To unsubscribe send an email to ruby-talk-leave(a)ml.ruby-lang.org > ruby-talk info -- > https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.or… > > ______________________________________________ > ruby-talk mailing list -- ruby-talk(a)ml.ruby-lang.org > To unsubscribe send an email to ruby-talk-leave(a)ml.ruby-lang.org > ruby-talk info -- > https://ml.ruby-lang.org/mailman3/postorius/lists/ruby-talk.ml.ruby-lang.or… > > -- Andy Maleh LinkedIn: https://www.linkedin.com/in/andymaleh <https://www.linkedin.com/in/andymaleh> Blog: http://andymaleh.blogspot.com GitHub: http://www.github.com/AndyObtiva Twitter: @AndyObtiva <https://twitter.com/AndyObtiva>

3 2

[ruby-talk:444377] [ANN] hoe 4.1.0 Released
by Ryan Davis 16 Nov '23

16 Nov '23

hoe version 4.1.0 has been released! * home: <http://www.zenspider.com/projects/hoe.html> * code: <https://github.com/seattlerb/hoe> * bugs: <https://github.com/seattlerb/hoe/issues> * rdoc: <http://docs.seattlerb.org/hoe/> * doco: <http://docs.seattlerb.org/hoe/Hoe.pdf> * clog: <https://github.com/seattlerb/hoe/blob/master/History.rdoc> * other: <http://github.com/jbarnette/hoe-plugin-examples> Hoe is a rake/rubygems helper for project Rakefiles. It helps you manage, maintain, and release your project and includes a dynamic plug-in system allowing for easy extensibility. Hoe ships with plug-ins for all your usual project tasks including rdoc generation, testing, packaging, deployment, and announcement. See class rdoc for help. Hint: `ri Hoe` or any of the plugins listed below. For extra goodness, see: http://docs.seattlerb.org/hoe/Hoe.pdf Changes: ### 4.1.0 / 2023-11-16 * 1 minor enhancement: * Added Hoe::Cov#cov_filter accessor. * 2 bug fixes: * Removed use of Gem.bin_wrapper. rdoc is now just rdoc. * Removed use of Gem.default_exec_format. gem is now just gem.

1 0

[ruby-talk:444376] Slides & Code for RubyConf 2023 Workshop "How To Build Desktop Applications in Ruby"
by Andy Maleh 15 Nov '23

15 Nov '23

Thanks to everyone who attended my RubyConf 2023 2-Hour Workshop "How To Build Desktop Applications in Ruby". For those who missed the event, I posted the presentation slides and code exercises (27 exercises) on GitHub. I also blogged about the new Color The Circles game app that was developed at the RubyConf 2023 Community Day Glimmer Desktop Hacking event. GitHub Repo: https://github.com/AndyObtiva/how-to-build-desktop-applications-in-ruby Presentation Slides (Direct Link): https://bit.ly/rubyconf2023desktop Blog Post Announcement: https://andymaleh.blogspot.com/2023/11/rubyconf-2023-how-to-build-desktop.h… Happy Glimmering! Andy Maleh LinkedIn: https://www.linkedin.com/in/andymaleh <https://www.linkedin.com/in/andymaleh> Blog: http://andymaleh.blogspot.com GitHub: http://www.github.com/AndyObtiva Twitter: @AndyObtiva <https://twitter.com/AndyObtiva>

1 0

[ruby-talk:444375] [ANN] wxRuby3 0.9.2 release
by martin＠corino.nl 13 Nov '23

13 Nov '23

This is another update on the road to the v1.0.0 release. wxRuby3 is a cross-platform GUI library for Ruby, based on the mature wxWidgets GUI toolkit for C++. It uses native widgets wherever possible, providing the correct look, feel and behavior to GUI applications on Windows, OS X and Linux/GTK. wxRuby aims to provide a comprehensive solution to developing professional-standard desktop applications in Ruby. wxRuby3 also provides extensive and complete reference documentation. This release - consistently provides Ruby-style enumerator methods where appropriate; - enhances the documentation; - extends the regression tests; - adds wxFileCtrl - adds Wx::DarkModeSettings, Wx::TaskBarButton and Wx::ThumbBarButton for WXMSW - implements various other improvements and minor corrections. If you are interested check this out: Documentation: https://mcorino.github.io/wxRuby3/index.html Github: https://github.com/mcorino/wxruby3 Rubygems: https://rubygems.org/gems/wxruby3

1 0

[ruby-talk:444374] [ANN] rodauth-oauth 1.4.0 released
by Tiago Cardoso 08 Nov '23

08 Nov '23

rodauth-oauth 1.4.0 has been released. rodauth-oauth is a rack-compatible toolkit for building OAuth 2.0 authorization servers, as well as OpenID Authentication Providers. rodauth-oauth is certified <https://openid.net/certification/> for the following profiles of the OpenID Connect™ protocol: Basic OP, Implicit OP, Hybrid OP, Config OP, Dynamic OP, Form Post OP, 3rd Party Init OP Session Management OP, RP-Initiated Logout OP, Front-Channel OP, Back-Channel OP # as simple as rodauth do enable :oauth_authorization_code_grant # or enable :oidc end Among its features, it supports: * Authorization Code Grant * Refresh Token Grant * Implicit Grant * Client Credentials Grant * Device Code Grant * Token Revocation * Token Introspection * Auth Server Metadata * PKCE * Resource Indicators * JWT Access Tokens * mTLS Client Authentication * Assertion Framework * SAML 2.0 Bearer Assertion Grant * JWT Bearer Assertion Grant * JWT Secured authorization requests (JAR) * JWT Secured authorization response mode (JARM) * Pushed Authorization requests * Dynamic Client Registration * OpenID * OpenID Discovery * OpenID Multiple Response types * OpenID Self Issued Tokens * OpenID Connect Dynamic Client Registration * OpenID Session Management * OpenID RP Initiated Logout * OpenID Frontchannel Logout * OpenID Backchannel Logout It can also be used with Rails (via the "rodauth-rails" gem). Website: https://honeyryderchuck.gitlab.io/rodauth-oauth/ Documentation: https://honeyryderchuck.gitlab.io/rodauth-oauth/rdoc/ Wiki: https://gitlab.com/honeyryderchuck/rodauth-oauth/wikis/home CI: https://gitlab.com/honeyryderchuck/rodauth-oauth/pipeline These are the release notes since the last update: ## 1.4.0 (08/11/2023) ## Highlights rodauth-oauth is now [OpenID certified](https://openid.net/certification/) for the following logout profiles: * Session Management OP * RP-Initiated Logout OP * Front-Channel Logout OP * Back-Channel Logout OP The OIDC server used to run the test can be found [here](https://gitlab.com/os85/rodauth-oauth/-/blob/master/examples/oidc/aut… and deployed [here](https://rodauth-oauth-oidc.onrender.com). ## Features ### OIDC logout features `rodauth-oauth` ships with the following new features: * `oidc_sesssion_management` - enables [OIDC session management](https://openid.net/specs/openid-connect-session-1_0.html) * `oidc_frontchannel_logout` - enables [OIDC frontchannel logout](https://openid.net/specs/openid-connect-frontchannel-1_0.html) * `oidc_backchannel_logout` - enables [OIDC backchannel logout](https://openid.net/specs/openid-connect-backchannel-1_0.html) which, along with the existing `oidc_rp_initiated_logout`, implemment all OIDC logout profiles. ## Breaking changes If you're using `oidc`, the dependency on `account_expiration` has been replaced by the `active_sessions` rodauth feature. This change is required because it fixes bugs associated with accounts expiring in order for id token invalidation to work. If you're migrating, it's recommended that you keep depending on `account_expiration` during the transition, add `active_sessions` tables as per [rodauth specs](https://github.com/jeremyevans/rodauth/blob/master/spec/migrate/001_…, and run them alongside one another for the max period ID tokens should be valid, after which you can remove `account_expiration` and its tables. ## Improvements ### OAuth SAML Bearer Grant per oauth application settings The `oauth_saml_bearer_grant` feature requires a new table/resource, SAML settings, which enable "per client applicatioon" SAML settings, and therefore, make this feature usable in enterprise/multi-tenancy scenarios. ## Bugfixes * remove `html_safe` usage in rails views to prevent XSS in the authorize form. * fixed for OIDC RFC 5.4 when requesting claims using scope values * `oauth_rp_initiated_logout` does not crash anymore on logout requests with `id_token_hint` * `oauth_rp_initiated_logout` now works with response types other than `code` * `oauth_rp_initiated_logout` emits an ID token hint invalid message when not able to decode the `id_token_hint` ## Chore * Using `auth_methods` everywhere where `auth_value_methods` was used and didn't make sense. * `oauth_tls_client_auth` is not dependent on the `oauth_jwt` feature, and can therefore be used with non-JWT access tokens, at least with the features which do not require it. ### 1.3.2 (27/07/2023) #### Improvements * `require_signed_request_object` option for JAR (`oauth_jwt_secured_authorization_request` plugin) is now supported: * in the oauth server metadata endpoint * as a plugin config option (`oauth_require_signed_request_object`, defaults to `false`) * as a oauth dynamic registration endpoint param (`require_signed_request_object`, requires corresponding columnn) * enforces JAR-based authorization, andd does not allow unsigned JAR JWTs, when turned on. #### Bugfixes * JWT decoding failed in circumstances where a declared encryption algo didn't have key/method declared. * fix for when PAR (`oauth_pushed_authorization_request` feature) is used with JAR (`oauth_jwt_secured_authorization_request` plugin), and PAR `request_uri` param wasn't being removed when validating authorize request parameters, thereby making JAR logic evaluate it as a JAR `requuest_uri` (it is now correctly not taken into account in such a case); ### 1.3.1 (27/06/2023) #### Bugfixes * Set 401 error response when `client_id` parameter is invalid, or from an unexisting client application, instead of failing with a 500 (@igor-alexandrov). * update rails authorize form to use roda request params instead, as plain params was breaking JAR and PAR-based authorize forms in rails applications. #### Chore * set `:padding` to `false` in `Base64.urlsafe_encode64` calls (@felipe.zavan)

1 0