pixelflut 1.0.0 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b91c341d7ba55f35b968b3a35c31cb4e676b2055c2f86bd6a94e3f5a4847c788
-  data.tar.gz: 700e3fae41c985852236339eca7381f05d383e55c74e9948b2f7935b2f7bf69e
+  metadata.gz: df7b03c15db9310c8b374b0aef1fb328bbf01c82da1d69b657f133081af8d475
+  data.tar.gz: bcf596c6c8b92c7645e29c67e409b31ff3cd452798228db177214401a3494877
 SHA512:
-  metadata.gz: 68bbebdd53d083cf10e6bc5c76a18b81ac43347f929166d61493a4e8a54b07263f7ae18c1b23eb5c26317a8d02a33aea18f26740c0cb3f9f387338bb4322a2f5
-  data.tar.gz: c045bd205847f450c924c2e0f2485737af956f6f419e99b78dadd7b8ab101972f0b251bd09eb62bd39024f60c4f00b34830ccf367a718e71395d037696f735ea
+  metadata.gz: ba17e1b0ad958f79d284e9156c5f28969c7bca19444f8e59c7c4064fafd130bf3765acdc828a449ab0026fc36e4f04006bb8dcfc9c569bc81ce9db993f14ba44
+  data.tar.gz: 95ec9eaa9f0772a71f4de9fa0b2382f83cf11cd34a0985da5d6334454e53db3ee1ad2a8232e9d74450f21cf32c0dfa01b4cc81df1a439a1483d4d4f0768d6e95

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Mike Blumtritt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -2,6 +2,9 @@
 
 A Pixelflut client written in Ruby.
 
+- Gem: [rubygems.org](https://rubygems.org/gems/pixelflut)
+- Source: [codeberg.org](https://codeberg.org/mblumtritt/pixelflut)
+
 ## Description
 
 Based on the idea of a simple server protocol to collaborate on a shared canvas named [Pixelflut](https://cccgoe.de/wiki/Pixelflut) this gem implements a Ruby version of a client.
@@ -10,7 +13,7 @@ This gem is an open experiment. You are welcome to fork or create pull requests
 
 ### Installation
 
-Use [Bundler](http://gembundler.com/) to install the gem:
+Use the Ruby package manager to install the gem:
 
 ```sh
 gem install pixelflut
@@ -36,5 +39,4 @@ Options:
   -t, --threads              use threads instead of processes
   -h, --help                 print this help
   -v, --version              print version information
-
 ```

data/bin/pxf

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#!/usr/bin/env ruby --jit
 # frozen_string_literal: true
 
 $stdout.sync = $stderr.sync = true
@@ -12,10 +12,12 @@ if ARGV.index('-h') || ARGV.index('--help')
           --host <address>       target host address (default 127.0.0.1)
       -p, --port <port>          target port (default 1234)
       -c, --connections <count>  count of connections (default 4)
-      -m, --mode <mode>          select pixel encoding (TEXT | BIN)
-      -t, --threads              use threads instead of processes
       -x, --transpose-x <x>      transpose image <x> pixels
       -y, --transpose-y <y>      transpose image <y> pixels
+          --encode-text          encode pixel in text format (default)
+          --encode-bin           encode pixel in binary format
+          --use-processes        use seperate processes (default)
+          --use-threads          use threads instead of processes
       -h, --help                 print this help
       -v, --version              print version information
   HELP
@@ -33,13 +35,13 @@ def die!(msg, code: 1)
   exit(code)
 end
 
-die!('argument missing') if ARGV.empty?
+die!("argument missing - try `#{$name} --help`") if ARGV.empty?
 
 require_relative('../lib/pixelflut')
 
 module Configuration
   class << self
-    attr_reader :use_threads
+    attr_reader :scheduler
 
     def address
       require_relative('../lib/pixelflut/sender')
@@ -60,10 +62,6 @@ module Configuration
     def as_uint(value, name)
       (ret = value.to_i).positive? ? ret : invalid(value, name)
     end
-
-    def as_mode(value, name)
-      %w[text bin].include?(v = value.downcase) ? v : invalid(value, name)
-    end
   end
 
   until ARGV.empty?
@@ -75,16 +73,20 @@ module Configuration
     when '-c', '--connections'
       Pixelflut.count = as_uint(ARGV.shift, 'connections')
       die!("too many connections - #{Pixelflut.count}") if Pixelflut.count > 255
-    when '-m', '--mode', '--pixel'
-      Pixelflut.mode = as_mode(ARGV.shift, 'mode')
-    when '-t', '--use-threads'
-      @use_threads = true
+    when '--encode-text'
+      Pixelflut.encoding = 'text'
+    when '--encode-bin'
+      Pixelflut.encoding = 'bin'
+    when '--use-threads'
+      @scheduler = :threads
+    when '--use-processes'
+      @scheduler = :processes
     when '-x', '--transpose-x'
       Pixelflut.delta_x = ARGV.shift.to_i
     when '-y', '--transpose-y'
       Pixelflut.delta_y = ARGV.shift.to_i
     else
-      die!("invalid option - #{arg}") if Pixelflut.file_name
+      die!("invalid option - #{arg}") if arg[0] == '-' || Pixelflut.file_name
       Pixelflut.file_name = arg
     end
   end
@@ -92,6 +94,14 @@ module Configuration
   die!('<image> missing') unless Pixelflut.file_name
 end
 
+def use_threads(address, data)
+  puts("#{$name}: start #{data.size} threads for #{data.sum(&:size)} bytes")
+  Thread.report_on_exception = false
+  data.map! { Thread.start { Pixelflut::Sender.send(address, it) } }
+  GC.start
+  data.each(&:join)
+end
+
 def use_processes(address, data)
   puts("#{$name}: start #{data.size} processes for #{data.sum(&:size)} bytes")
   data.size.times do |i|
@@ -99,22 +109,13 @@ def use_processes(address, data)
     data = data[i]
     GC.start
     $name = Process.setproctitle("#{$name}-#{'0' if i < 9}#{i + 1}")
-    Pixelflut::Sender.send(address, data) do |size|
-      puts("#{$name}: #{size} bytes")
-    end
+    Pixelflut::Sender.send(address, data) { puts("#{$name}: #{it} bytes") }
   end
-end
-
-def use_threads(address, data)
-  puts("#{$name}: start #{data.size} threads for #{data.sum(&:size)} bytes")
-  Thread.report_on_exception = false
-  data.map! { |slice| Thread.start { Pixelflut::Sender.send(address, slice) } }
   GC.start
-  data.each(&:join)
 end
 
 begin
-  if Configuration.use_threads
+  if Configuration.scheduler == :threads
     use_threads(Configuration.address, Pixelflut.data)
   else
     use_processes(Configuration.address, Pixelflut.data)

data/lib/pixelflut/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pixelflut
-  VERSION = '1.0.0'
+  VERSION = '1.0.4'
 end

data/lib/pixelflut.rb

@@ -2,7 +2,7 @@
 
 module Pixelflut
   class << self
-    attr_accessor :file_name, :count, :mode, :delta_x, :delta_y
+    attr_accessor :file_name, :count, :encoding, :delta_x, :delta_y
 
     def data
       sliced(convert(*load).shuffle!, @count).map!(&:join)
@@ -44,11 +44,8 @@ module Pixelflut
     end
 
     def convert(width, height, blob)
-      if @mode == 'bin'
-        to_bin_format(width, height, blob)
-      else
-        to_text_format(width, height, blob)
-      end
+      return to_bin_format(width, height, blob) if @encoding == 'bin'
+      to_text_format(width, height, blob)
     end
 
     def to_text_format(width, height, blob)
@@ -94,6 +91,6 @@ module Pixelflut
 
   @count = ENV['TC'].to_i
   @count = 4 unless @count.positive?
-  @mode = 'text'
+  @encoding = 'text'
   @delta_x = @delta_y = 0
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pixelflut
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.4
 platform: ruby
 authors:
 - Mike Blumtritt
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -28,13 +27,14 @@ description: |
   Based on the idea of a simple server protocol to collaborate on a shared
   canvas named [Pixelflut](https://cccgoe.de/wiki/Pixelflut) this gem
   implements a fast Ruby client version.
-email:
 executables:
 - pxf
 extensions: []
 extra_rdoc_files:
+- LICENSE
 - README.md
 files:
+- LICENSE
 - README.md
 - bin/pxf
 - lib/pixelflut.rb
@@ -46,7 +46,6 @@ metadata:
   source_code_uri: https://github.com/mblumtritt/pixelflut
   bug_tracker_uri: https://github.com/mblumtritt/pixelflut/issues
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -61,8 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A fast Pixelflut client written in Ruby.
 test_files: []