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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6a349bb223eda3eecb772bf46d1d98085e4bcc0a8dc4decd5deedbfb898bde8
-  data.tar.gz: 57e565d3989a659066e1565b7522dd108ac160fb19d7938c004f97e060ea3def
+  metadata.gz: 4f93f77a77f68890634f59988823870d3f80baac5820856ac551dac128c47228
+  data.tar.gz: 0aa9e66cbf90e9a5c3cfb1d86f11e82200f82eac2c9e88d21b2aeb1ad60d3275
 SHA512:
-  metadata.gz: fdef3e3c972f1e369f1636abdd5ba19281145fc5ef17bca0b1fc5308190b388d636ec67f73978671e3ce43f853813d842693d0ff719e64cbbe6ca52a65d87b26
-  data.tar.gz: 3b1071796e70357282109896c91bad0e448f547a91f0ca9e9f1c318a31cafa71d8c9e8ce44fd8f7e9daa6e997c9dfc648fb087548a0b3061be5aa122128fa7c8
+  metadata.gz: abcecf91a66544d8d5365eb98c72b89b5fb8a638dbf7940f4a1fa5232c04b0d37c445ce49994bbec583926e63d6b008d9c519e4ca6f6ca5d390b8a24960bb972
+  data.tar.gz: 1b22d167e1a2b692f5634390856274a9171b129ea1b8509cf381ea5f75ce06ecc3ade77808135bd78fb13637f7a327a3d2a8d386e1b85171313f0c09569f568e

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,16 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: libui
 version: !ruby/object:Gem::Version
-  version: 0.1.3.pre
+  version: 0.2.0.pre
 platform: x86_64-darwin
 authors:
 - kojix2
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-09 00:00:00.000000000 Z
-dependencies: []
-description: 
+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
 executables: []
@@ -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
@@ -32,7 +47,7 @@ homepage: https://github.com/kojix2/libui
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -43,12 +58,12 @@ 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.20
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Ruby bindings to libui
 test_files: []