pure-x11 0.0.9 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d50a871d744420a3fc90c8ca3cff7defb5d4917bce297469502c94e64ae12790
-  data.tar.gz: e17c0019823b08847fca5b33b35f2d618bde521fd3e86bf5a5168eb68807383a
+  metadata.gz: b0aef4dac032e7cc033a474d8b3f19920c2dd18e55a98cdf08329c0dcb9f360e
+  data.tar.gz: 346955046f31e2e53a61183ddcd9d19db11dab82c9de8b9ea04c92b9f4900e93
 SHA512:
-  metadata.gz: 36892209167f3aea6ccc68309e64f0e45f56e036ce8a547ffab37460f2169902429d6d1b4f11b7156d64a45151a155a7a46df693b2db86203ba75c9b99fe41ff
-  data.tar.gz: 6c7d7c83efef12e9e9303526cf2b92b5d40ad4e7d726af5a5fe59117f1396a171d8d79e452b7a5ede941d2d1bf0fcef05b7e60fc0cfd180b7f7dce95b5c0289c
+  metadata.gz: 417b477de5a70c6e0e568e218f007544823e1986c7969bd666bf4a8c9382c2af349ac745c693f3b9fe07aeccc9119fadda5daa6b0dfad6bb388218dc6af2ba03
+  data.tar.gz: 153aacfb1fa54955eb14d6b186a65868a803f486c88d55b483a55097b81d545fab3888ebaff3332c1fa0d964d71293a49a08654d6fef71ed7501ab6926028185

data/CLAUDE.md

@@ -0,0 +1,47 @@
+# Ruby X11 Development Guidelines
+
+## Build Commands
+- Install dependencies: `bundle install`
+- Run all tests: `rake test`
+- Run single test: `ruby test/specific_test.rb`
+
+## Code Style
+- Indentation: 2 spaces
+- Naming: snake_case for methods/variables, CamelCase for classes
+- Constants: ALL_CAPS or CamelCase (matching X11 protocol names)
+- Methods: One-line with `=` for simple methods (Ruby 3 syntax)
+- Error handling: Custom X11 error hierarchy (X11::BasicError, etc.)
+- Imports: require_relative for internal files, require for gems
+
+## Organization
+- Core functionality in lib/X11.rb
+- Components in lib/X11/ directory
+- Protocol definitions using DSL in form.rb
+- Test files in test/ directory with _test.rb suffix
+
+## Testing
+- Uses Minitest::Spec syntax: `_(object).must_equal expected`
+- Tests require helper.rb which sets up the environment
+- Mock objects for testing sockets/connections
+
+## Documentation
+- Comments for complex logic
+- Reference X11 protocol documentation when implementing specs
+
+## Adding X11 Protocol Requests
+1. Define request form in lib/X11/form.rb:
+   ```ruby
+   class XRenderFreePicture < BaseForm
+     field :req_type, Uint8
+     field :render_req_type, Uint8, value: 7
+     field :request_length, Uint16, value: 2
+     field :picture, Uint32
+   end
+   ```
+2. Add helper method in lib/X11/display.rb:
+   ```ruby
+   def render_free_picture(picture)
+     write_request(Form::XRenderFreePicture.new(render_opcode, picture))
+   end
+   ```
+3. Update X11::VERSION in lib/X11/version.rb after adding new functionality

data/README.md

@@ -9,6 +9,16 @@ upstread everything.
 This library is based off of Mathieu Bouchard's work on his RubyX11 project,
 and Richard Ramsdens excellent start on Ruby-X11.
 
+Current known use (all mine...):
+
+ * [RubyWM](https://github.com/vidarh/rubywm) - Pure Ruby window manager
+ * [Skrift-X11](https://github.com/vidarh/skrift-x11) - X11 integration for pure Ruby Truetype font rendering
+ * Rebar - not yet published wm toolbar
+ * RubyTerm (name TBD) - not yet published version of Ruby terminal
+
+If you're thinking of using pure-x11, drop me a note and I'll start being more
+cautious about breaking changes ;)
+
 Contributors
 ------------
 

data/lib/X11/display.rb

@@ -541,6 +541,10 @@ module X11
     def create_pixmap(depth, drawable, w,h)
       new_id.tap{|pid| write_request(Form::CreatePixmap.new(depth, pid, drawable, w,h)) }
     end
+    
+    def free_pixmap(pixmap)
+      write_request(Form::FreePixmap.new(pixmap))
+    end
 
     # XRender
 
@@ -651,6 +655,10 @@ module X11
       write_request(Form::XRenderCreateSolidFill.new(render_opcode,fill,color))
       fill
     end
+    
+    def render_free_picture(picture)
+      write_request(Form::XRenderFreePicture.new(render_opcode, picture))
+    end
 
     private
 

data/lib/X11/form.rb

@@ -694,6 +694,13 @@ module X11
       field :width, Uint16
       field :height, Uint16
     end
+    
+    class FreePixmap < BaseForm
+      field :opcode, Uint8, value: 54
+      unused 1
+      field :request_length, Uint16, value: 2
+      field :pixmap, Pixmap
+    end
 
     class Str < BaseForm
       field :name, Uint8, :length, value: ->(str) { str.name.length }
@@ -875,18 +882,18 @@ module X11
     # FIXME: Events have quite a bit of redundancy, but unfortunately
     # BaseForm can't handle subclassing well.
 
-    Shift = 0x001
-    Lock  = 0x002
-    Control = 0x004
-    Mod1 = 0x008
-    Mod2 = 0x010
-    Mod3 = 0x0020
-    Mod4 = 0x0040
-    Mod5 = 0x0080
-    Button1 = 0x100
-    Button2 = 0x200
-    Button3 = 0x400
-    Button4 = 0x800
+    Shift   = 0x0001
+    Lock    = 0x0002
+    Control = 0x0004
+    Mod1    = 0x0008
+    Mod2    = 0x0010
+    Mod3    = 0x0020
+    Mod4    = 0x0040
+    Mod5    = 0x0080
+    Button1 = 0x0100
+    Button2 = 0x0200
+    Button3 = 0x0400
+    Button4 = 0x0800
     Button5 = 0x1000
 
     class Event < BaseForm
@@ -1217,5 +1224,12 @@ module X11
        field :fill, Uint32
        field :color, XRenderColor
      end
+
+     class XRenderFreePicture < BaseForm
+       field :req_type, Uint8
+       field :render_req_type, Uint8, value: 7
+       field :request_length, Uint16, value: 2
+       field :picture, Uint32
+     end
   end
 end

data/lib/X11/version.rb

@@ -1,3 +1,3 @@
 module X11
-  VERSION = "0.0.9"
+  VERSION = "0.0.11"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pure-x11
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.11
 platform: ruby
 authors:
 - Vidar Hokstad
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2025-03-25 00:00:00.000000000 Z
 dependencies: []
 description: Pure Ruby X11 bindings
 email:
@@ -19,6 +19,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- CLAUDE.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt