libui 0.1.3.pre-x86_64-linux → 0.2.0.pre-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f068fcf26facd76bd1f56faeca3ac4bea3b11e872befe05447c7ecdbe33cd1c5
-  data.tar.gz: 9911c9a3488c9e0a3c50a36bedba124171a8ce6c2549fb983eee35e8f56955b5
+  metadata.gz: e2f1063859dcd312d95a5a8323b887b39034adb9cc26043f07250c035c1f183a
+  data.tar.gz: c7b2a52f517cc31074f847289e9115d6e25aa5d42a7659080c2cc71e9fdc523e
 SHA512:
-  metadata.gz: 7d07e4e85f62e610d25203f3eb2c99431eac61b021f1872597b9bbba14d905d32f879598b3b9f5d0582ba73904ca5e7a27a7e8309c671cfa1e8c6605f3810fa4
-  data.tar.gz: b4195a2387afaf719b34d33742650a147041e7179ddbe71c4d926c41fb641c27eaecd8ad83a4f7da9d002fa3fd7b219fa035132dc3255512234d0a90d350f579
+  metadata.gz: c71a46bbd71bc27335fca0eee6665ac33381f420ac814487b6ddfa7bbac17f22a4d495db70507a8f55f50229600f430a239b60b31d4fc4850cb5f0f9a393eafd
+  data.tar.gz: c9d03fd78a230349e7694add8c2054186ab2289215781380fa4e1ded2abe2fa2d9d9343a5247f699ef55e2a3907b33fa42762d2f9c623b25c44cab01b7d4d9ef

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020 kojix2
+Copyright (c) 2020-2025 kojix2
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -4,21 +4,32 @@
 [![Gem Version](https://badge.fury.io/rb/libui.svg)](https://badge.fury.io/rb/libui)
 <a href="https://github.com/AndyObtiva/glimmer-dsl-libui"><img alt="glimmer-dsl-libui" src="https://github.com/AndyObtiva/glimmer/blob/master/images/glimmer-logo-hi-res.svg" width="50" height="50" align="right"></a>
 [![Pre-build](https://github.com/kojix2/libui-ng/actions/workflows/pre-build.yml/badge.svg?branch=pre-build)](https://github.com/kojix2/libui-ng/actions/workflows/pre-build.yml)
+[![Lines of Code](https://img.shields.io/endpoint?url=https%3A%2F%2Ftokei.kojix2.net%2Fbadge%2Fgithub%2Fkojix2%2FLibUI%2Flines)](https://tokei.kojix2.net/github/kojix2/LibUI)
 
-LibUI is a Ruby wrapper for libui and libui-ng.
+LibUI is a Ruby wrapper for libui family.
 
 :rocket: [libui-ng](https://github.com/libui-ng/libui-ng) - A cross-platform portable GUI library
 
+:wrench: [libui-dev](https://github.com/petabyt/libui-dev) - Native UI library for C - with some extras
+
 :radio_button: [libui](https://github.com/andlabs/libui) - Original version by andlabs.
 
 ## Installation
 
+It is recommended to use libui-ng, via the --pre commandline flag:
+
+```sh
+gem install libui --pre # libui-ng; this will fetch libui-0.1.3.pre-x86_64-linux.gem
+```
+
+If for some reason you would like to install the slightly older libui-0.1.2.gem release, issue:
+
 ```sh
 gem install libui
 ```
 
-- The gem package includes the [official release](https://github.com/andlabs/libui/releases/tag/alpha4.1) of the libui shared library version 4.1 for Windows, Mac, and Linux.
-  - Namely `libui.dll`, `libui.dylib`, and `libui.so` (only 1.8MB in total).
+- The gem package includes the libui-ng shared library for Windows, Mac, and Linux.
+  - Namely `libui.dll`, `libui.dylib`, or `libui.so`.
 - No dependencies required.
   - The libui gem uses the standard Ruby library [Fiddle](https://github.com/ruby/fiddle) to call C functions.
 
@@ -204,6 +215,19 @@ Another simple approach is to replace the shared libraries in the gem vendor dir
 
 ### Publishing gems
 
+#### Automated Publishing
+
+Push a version tag to automatically publish platform-specific gems:
+
+```sh
+git tag v0.1.3
+git push origin v0.1.3
+```
+
+Requires `RUBYGEMS_API_KEY` repository secret with scoped API key.
+
+#### Manual Publishing
+
 ```sh
 ls vendor             # check the vendor directory
 rm -rf pkg            # remove previously built gems

data/lib/libui/error.rb

@@ -0,0 +1,10 @@
+module LibUI
+  # base error class
+  class Error < StandardError; end
+
+  # LibUI shared library not found error
+  class LibraryNotFoundError < Error; end
+
+  # LibUI shared library load error
+  class LibraryLoadError < Error; end
+end

data/lib/libui/ffi.rb

@@ -1,15 +1,24 @@
 require 'fiddle/import'
 require_relative 'fiddle_patch'
+require_relative 'error'
 
 module LibUI
+  class Error < StandardError; end
+
   module FFI
     extend Fiddle::Importer
     extend FiddlePatch
 
-    begin
-      dlload LibUI.ffi_lib
-    rescue LoadError
-      raise LoadError, 'Could not find libui shared library'
+    if LibUI.ffi_lib.nil?
+      raise LibraryNotFoundError, 'Could not find libui shared library. LibUI.ffi_lib is nil.'
+    elsif !File.exist?(LibUI.ffi_lib)
+      raise LibraryNotFoundError, "Could not find libui shared library: #{LibUI.ffi_lib}"
+    else
+      begin
+        dlload LibUI.ffi_lib
+      rescue LoadError
+        raise LibraryLoadError, "Could not load libui shared library: #{LibUI.ffi_lib}"
+      end
     end
 
     class << self
@@ -18,6 +27,8 @@ module LibUI
       def try_extern(signature, *opts)
         extern(signature, *opts)
       rescue StandardError => e
+        # Do not raise error when the function is not found
+        # because some functions may not be available on older versions of libui.
         warn "#{e.class.name}: #{e.message}"
       end
 

data/lib/libui/version.rb

@@ -1,3 +1,3 @@
 module LibUI
-  VERSION = '0.1.3.pre'
+  VERSION = '0.2.0.pre'
 end

data/lib/libui.rb

@@ -1,16 +1,26 @@
 require_relative 'libui/version'
 require_relative 'libui/utils'
+require_relative 'libui/error'
 require 'rbconfig'
 
 module LibUI
-  class Error < StandardError; end
-
   class << self
     attr_accessor :ffi_lib
   end
 
+  host_cpu = case RbConfig::CONFIG['host_cpu']
+             when /i\d86/
+               'x86'
+             else
+               RbConfig::CONFIG['host_cpu']
+             end
+
   lib_name = [
+    # For libui-ng shared libraries compiled with (rake vendor:build)
     "libui.#{RbConfig::CONFIG['host_cpu']}.#{RbConfig::CONFIG['SOEXT']}",
+    # For libui-ng shared library downloaded from RubyGems.org
+    "libui.#{host_cpu}.#{RbConfig::CONFIG['SOEXT']}",
+    # For backward compatibility or manual compilation of libui-ng
     "libui.#{RbConfig::CONFIG['SOEXT']}"
   ]
 

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: libui
 version: !ruby/object:Gem::Version
-  version: 0.1.3.pre
+  version: 0.2.0.pre
 platform: x86_64-linux
 authors:
 - kojix2
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-09 00:00:00.000000000 Z
-dependencies: []
+date: 2025-08-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fiddle
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description:
 email:
 - 2xijok@gmail.com
@@ -20,6 +34,7 @@ files:
 - LICENSE.txt
 - README.md
 - lib/libui.rb
+- lib/libui/error.rb
 - lib/libui/ffi.rb
 - lib/libui/fiddle_patch.rb
 - lib/libui/libui_base.rb
@@ -43,11 +58,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.4.14
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Ruby bindings to libui