slotz 0.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1829fa39dcca433a7c74867bde89d53f70447c4c72c7abd54fb7ef4e68a73c87
-  data.tar.gz: acc87fb694a334b2fbaabf99bb4c608ee6fd9fa168f4f143c2087fd4e86e4f2d
+  metadata.gz: 647d08d88f1e16c20c9aa18c9105aad86b3f1b5136761ad9a192ae0ff2405f90
+  data.tar.gz: bb7622e79a6744750e352ef3cc010d94f8ec48a1c373283d10291442dbe53a4f
 SHA512:
-  metadata.gz: cae56d7e4293d7b3152dd353127ef550b089fefb49aea0e3b83cb48e41a67fee0f9a3e7d2f2166872791ceebcabe5066039ecb5969f64063e4a8358fd0ef2a68
-  data.tar.gz: 05e01352f292781b59cd23cc4fc0ae665ff718d4c1451c8afefdbcd1c9c3c9149e1bc9ccc6cab42ee97d3a89fbd9a3b62d9f61b67c9de671760a2a9438c62ea1
+  metadata.gz: 50d8da5b167c1fabc9e82be9ec8ebbe9d82cbff501961a6c8d3d17ff11193467c5956ca762a1af7e75f4214816ecf49f464eb4e862224a3bd8bde6613d2f198c
+  data.tar.gz: 751e119f5b07eca377631646c137c21114e603f083fd557e5b8e18ac9789fc375df8b450e8a40e76c44e1e94198fd2b3f76613424f6c596907d4ea1a42d50410

data/Gemfile

@@ -16,4 +16,7 @@ group :prof do
     gem 'memory_profiler'
 end
 
+gem 'msgpack'
+gem 'toq'
+
 gemspec

data/LICENSE.md

@@ -1,29 +1,375 @@
-# License
-
-    Copyright (C) 2025, Anastasios Laskos <mailto:anastasios.laskos@gmail.com>
-    All rights reserved.
-
-    Redistribution and use in source and binary forms, with or without modification,
-    are permitted provided that the following conditions are met:
-
-        * Redistributions of source code must retain the above copyright notice,
-          this list of conditions and the following disclaimer.
-
-        * Redistributions in binary form must reproduce the above copyright notice,
-          this list of conditions and the following disclaimer in the documentation
-          and/or other materials provided with the distribution.
-
-        * Neither the name of the copyright holder nor the names of its contributors
-          may be used to endorse or promote products derived from this software
-          without specific prior written permission.
-
-    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-    ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-    ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-    (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-    LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-    ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-    SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+Mozilla Public License Version 2.0
+==================================
+
+1. Definitions
+--------------
+
+1.1. "Contributor"
+means each individual or legal entity that creates, contributes to
+the creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+means the combination of the Contributions of others (if any) used
+by a Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+means Source Code Form to which the initial Contributor has attached
+the notice in Exhibit A, the Executable Form of such Source Code
+Form, and Modifications of such Source Code Form, in each case
+including portions thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+means
+
+    (a) that the initial Contributor has attached the notice described
+        in Exhibit B to the Covered Software; or
+
+    (b) that the Covered Software was made available under the terms of
+        version 1.1 or earlier of the License, but not also under the
+        terms of a Secondary License.
+
+1.6. "Executable Form"
+means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+means a work that combines Covered Software with other material, in
+a separate file or files, that is not Covered Software.
+
+1.8. "License"
+means this document.
+
+1.9. "Licensable"
+means having the right to grant, to the maximum extent possible,
+whether at the time of the initial grant or subsequently, any and
+all of the rights conveyed by this License.
+
+1.10. "Modifications"
+means any of the following:
+
+    (a) any file in Source Code Form that results from an addition to,
+        deletion from, or modification of the contents of Covered
+        Software; or
+
+    (b) any new file in Source Code Form that contains any Covered
+        Software.
+
+1.11. "Patent Claims" of a Contributor
+means any patent claim(s), including without limitation, method,
+process, and apparatus claims, in any patent Licensable by such
+Contributor that would be infringed, but for the grant of the
+License, by the making, using, selling, offering for sale, having
+made, import, or transfer of either its Contributions or its
+Contributor Version.
+
+1.12. "Secondary License"
+means either the GNU General Public License, Version 2.0, the GNU
+Lesser General Public License, Version 2.1, the GNU Affero General
+Public License, Version 3.0, or any later versions of those
+licenses.
+
+1.13. "Source Code Form"
+means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+means an individual or a legal entity exercising rights under this
+License. For legal entities, "You" includes any entity that
+controls, is controlled by, or is under common control with You. For
+purposes of this definition, "control" means (a) the power, direct
+or indirect, to cause the direction or management of such entity,
+whether by contract or otherwise, or (b) ownership of more than
+fifty percent (50%) of the outstanding shares or beneficial
+ownership of such entity.
+
+2. License Grants and Conditions
+--------------------------------
+
+2.1. Grants
+
+Each Contributor hereby grants You a world-wide, royalty-free,
+non-exclusive license:
+
+(a) under intellectual property rights (other than patent or trademark)
+Licensable by such Contributor to use, reproduce, make available,
+modify, display, perform, distribute, and otherwise exploit its
+Contributions, either on an unmodified basis, with Modifications, or
+as part of a Larger Work; and
+
+(b) under Patent Claims of such Contributor to make, use, sell, offer
+for sale, have made, import, and otherwise transfer either its
+Contributions or its Contributor Version.
+
+2.2. Effective Date
+
+The licenses granted in Section 2.1 with respect to any Contribution
+become effective for each Contribution on the date the Contributor first
+distributes such Contribution.
+
+2.3. Limitations on Grant Scope
+
+The licenses granted in this Section 2 are the only rights granted under
+this License. No additional rights or licenses will be implied from the
+distribution or licensing of Covered Software under this License.
+Notwithstanding Section 2.1(b) above, no patent license is granted by a
+Contributor:
+
+(a) for any code that a Contributor has removed from Covered Software;
+or
+
+(b) for infringements caused by: (i) Your and any other third party's
+modifications of Covered Software, or (ii) the combination of its
+Contributions with other software (except as part of its Contributor
+Version); or
+
+(c) under Patent Claims infringed by Covered Software in the absence of
+its Contributions.
+
+This License does not grant any rights in the trademarks, service marks,
+or logos of any Contributor (except as may be necessary to comply with
+the notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+No Contributor makes additional grants as a result of Your choice to
+distribute the Covered Software under a subsequent version of this
+License (see Section 10.2) or under the terms of a Secondary License (if
+permitted under the terms of Section 3.3).
+
+2.5. Representation
+
+Each Contributor represents that the Contributor believes its
+Contributions are its original creation(s) or it has sufficient rights
+to grant the rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+This License is not intended to limit any rights You have under
+applicable copyright doctrines of fair use, fair dealing, or other
+equivalents.
+
+2.7. Conditions
+
+Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
+in Section 2.1.
+
+3. Responsibilities
+-------------------
+
+3.1. Distribution of Source Form
+
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be under
+the terms of this License. You must inform recipients that the Source
+Code Form of the Covered Software is governed by the terms of this
+License, and how they can obtain a copy of this License. You may not
+attempt to alter or restrict the recipients' rights in the Source Code
+Form.
+
+3.2. Distribution of Executable Form
+
+If You distribute Covered Software in Executable Form then:
+
+(a) such Covered Software must also be made available in Source Code
+Form, as described in Section 3.1, and You must inform recipients of
+the Executable Form how they can obtain a copy of such Source Code
+Form by reasonable means in a timely manner, at a charge no more
+than the cost of distribution to the recipient; and
+
+(b) You may distribute such Executable Form under the terms of this
+License, or sublicense it under different terms, provided that the
+license for the Executable Form does not attempt to limit or alter
+the recipients' rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+You may create and distribute a Larger Work under terms of Your choice,
+provided that You also comply with the requirements of this License for
+the Covered Software. If the Larger Work is a combination of Covered
+Software with a work governed by one or more Secondary Licenses, and the
+Covered Software is not Incompatible With Secondary Licenses, this
+License permits You to additionally distribute such Covered Software
+under the terms of such Secondary License(s), so that the recipient of
+the Larger Work may, at their option, further distribute the Covered
+Software under the terms of either this License or such Secondary
+License(s).
+
+3.4. Notices
+
+You may not remove or alter the substance of any license notices
+(including copyright notices, patent notices, disclaimers of warranty,
+or limitations of liability) contained within the Source Code Form of
+the Covered Software, except that You may alter any license notices to
+the extent required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+You may choose to offer, and to charge a fee for, warranty, support,
+indemnity or liability obligations to one or more recipients of Covered
+Software. However, You may do so only on Your own behalf, and not on
+behalf of any Contributor. You must make it absolutely clear that any
+such warranty, support, indemnity, or liability obligation is offered by
+You alone, and You hereby agree to indemnify every Contributor for any
+liability incurred by such Contributor as a result of warranty, support,
+indemnity or liability terms You offer. You may include additional
+disclaimers of warranty and limitations of liability specific to any
+jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+---------------------------------------------------
+
+If it is impossible for You to comply with any of the terms of this
+License with respect to some or all of the Covered Software due to
+statute, judicial order, or regulation then You must: (a) comply with
+the terms of this License to the maximum extent possible; and (b)
+describe the limitations and the code they affect. Such description must
+be placed in a text file included with all distributions of the Covered
+Software under this License. Except to the extent prohibited by statute
+or regulation, such description must be sufficiently detailed for a
+recipient of ordinary skill to be able to understand it.
+
+5. Termination
+--------------
+
+5.1. The rights granted under this License will terminate automatically
+if You fail to comply with any of its terms. However, if You become
+compliant, then the rights granted under this License from a particular
+Contributor are reinstated (a) provisionally, unless and until such
+Contributor explicitly and finally terminates Your grants, and (b) on an
+ongoing basis, if such Contributor fails to notify You of the
+non-compliance by some reasonable means prior to 60 days after You have
+come back into compliance. Moreover, Your grants from a particular
+Contributor are reinstated on an ongoing basis if such Contributor
+notifies You of the non-compliance by some reasonable means, this is the
+first time You have received notice of non-compliance with this License
+from such Contributor, and You become compliant prior to 30 days after
+Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+infringement claim (excluding declaratory judgment actions,
+counter-claims, and cross-claims) alleging that a Contributor Version
+directly or indirectly infringes any patent, then the rights granted to
+You by any and all Contributors for the Covered Software under Section
+2.1 of this License shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all
+end user license agreements (excluding distributors and resellers) which
+have been validly granted by You or Your distributors under this License
+prior to termination shall survive termination.
+
+************************************************************************
+*                                                                      *
+*  6. Disclaimer of Warranty                                           *
+*  -------------------------                                           *
+*                                                                      *
+*  Covered Software is provided under this License on an "as is"       *
+*  basis, without warranty of any kind, either expressed, implied, or  *
+*  statutory, including, without limitation, warranties that the       *
+*  Covered Software is free of defects, merchantable, fit for a        *
+*  particular purpose or non-infringing. The entire risk as to the     *
+*  quality and performance of the Covered Software is with You.        *
+*  Should any Covered Software prove defective in any respect, You     *
+*  (not any Contributor) assume the cost of any necessary servicing,   *
+*  repair, or correction. This disclaimer of warranty constitutes an   *
+*  essential part of this License. No use of any Covered Software is   *
+*  authorized under this License except under this disclaimer.         *
+*                                                                      *
+************************************************************************
+
+************************************************************************
+*                                                                      *
+*  7. Limitation of Liability                                          *
+*  --------------------------                                          *
+*                                                                      *
+*  Under no circumstances and under no legal theory, whether tort      *
+*  (including negligence), contract, or otherwise, shall any           *
+*  Contributor, or anyone who distributes Covered Software as          *
+*  permitted above, be liable to You for any direct, indirect,         *
+*  special, incidental, or consequential damages of any character      *
+*  including, without limitation, damages for lost profits, loss of    *
+*  goodwill, work stoppage, computer failure or malfunction, or any    *
+*  and all other commercial damages or losses, even if such party      *
+*  shall have been informed of the possibility of such damages. This   *
+*  limitation of liability shall not apply to liability for death or   *
+*  personal injury resulting from such party's negligence to the       *
+*  extent applicable law prohibits such limitation. Some               *
+*  jurisdictions do not allow the exclusion or limitation of           *
+*  incidental or consequential damages, so this exclusion and          *
+*  limitation may not apply to You.                                    *
+*                                                                      *
+************************************************************************
+
+8. Litigation
+-------------
+
+Any litigation relating to this License may be brought only in the
+courts of a jurisdiction where the defendant maintains its principal
+place of business and such litigation shall be governed by laws of that
+jurisdiction, without reference to its conflict-of-law provisions.
+Nothing in this Section shall prevent a party's ability to bring
+cross-claims or counter-claims.
+
+9. Miscellaneous
+----------------
+
+This License represents the complete agreement concerning the subject
+matter hereof. If any provision of this License is held to be
+unenforceable, such provision shall be reformed only to the extent
+necessary to make it enforceable. Any law or regulation which provides
+that the language of a contract shall be construed against the drafter
+shall not be used to construe this License against a Contributor.
+
+10. Versions of the License
+---------------------------
+
+10.1. New Versions
+
+Mozilla Foundation is the license steward. Except as provided in Section
+10.3, no one other than the license steward has the right to modify or
+publish new versions of this License. Each version will be given a
+distinguishing version number.
+
+10.2. Effect of New Versions
+
+You may distribute the Covered Software under the terms of the version
+of the License under which You originally received the Covered Software,
+or under the terms of any subsequent version published by the license
+steward.
+
+10.3. Modified Versions
+
+If you create software not governed by this License, and you want to
+create a new license for such software, you may create and use a
+modified version of this License if you rename the license and remove
+any references to the name of the license steward (except to note that
+such modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary
+Licenses
+
+If You choose to distribute Source Code Form that is Incompatible With
+Secondary Licenses under the terms of this version of the License, the
+notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+-------------------------------------------
+
+This Source Code Form is subject to the terms of the Mozilla Public
+License, v. 2.0. If a copy of the MPL was not distributed with this
+file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular
+file, then You may include the notice in a location (such as a LICENSE
+file in a relevant directory) where a recipient would be likely to look
+for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - "Incompatible With Secondary Licenses" Notice
+---------------------------------------------------------
+
+This Source Code Form is "Incompatible With Secondary Licenses", as
+defined by the Mozilla Public License, v. 2.0.
+```

data/README.md

@@ -1,3 +1,105 @@
 # Slotz
 
-TBD/WiP
+A resource management library for Ruby, an assistance to help you keep your resource (disk, memory) 
+requirements healthy.
+
+## Reservations
+
+Reserve the amount of resources your application needs, and move forward accordingly.
+
+You can stop allocating resources upon getting an exception indicating insufficient resources
+of any type.
+
+```ruby
+require 'slotz'
+
+class MyApp
+
+    Slotz::Reservation.provision( 
+      self,
+      disk:   1 * 1_000_000_000, # bytes
+      memory: 5 * 1_000_000_000 #
+    )
+
+end
+
+my_app = MyApp.new
+
+p my_app.available_slots
+#=> 11
+
+p my_app.available_slots_on_disk
+#=> 1425
+
+p my_app.available_slots_in_memory
+#=> 11
+
+p Slotz.utilization
+#=> 0.08933773478082488 %
+```
+
+versus:
+
+```ruby
+require 'slotz'
+
+class MyApp
+    Slotz::Reservation.provision( 
+        self,
+        disk:   99 * 1_000_000_000, # bytes
+        memory: 50 * 1_000_000_000 #
+    )
+end
+
+my_app = MyApp.new
+
+p my_app.available_slots
+#=> 1
+
+p my_app.available_slots_on_disk
+#=> 13
+
+p my_app.available_slots_in_memory
+#=> 1
+
+p Slotz.utilization
+#=> 0.911408461062344
+```
+
+## Process loading/spawning
+
+In order to still allow for `spawn`/`loader` functionality to be accommodated, you can spawn or load
+your file of interest accordingly, and still maintain the desired resource management.
+
+This can be the file you wish to load:
+
+### `child.rb:`
+
+```ruby
+p $options # Pre-set options.
+# => {:execute=>false}
+# => {:my=>:option, :ppid=>3158249, :tmpdir=>"/tmp", :execute=>true}
+
+class Child
+    Slotz::Reservation.provision(
+      self,
+      disk:   1 * 1_000_000_000,
+      memory: 5 * 1_000_000_000
+    )
+end
+
+# Just load for the inside view. don't run anything, unless you've been instructed to.
+return unless $execute
+
+# Load everything to run.
+# [...]
+```
+
+### `loader.rb:`
+```ruby
+require 'slotz'
+
+loader = Slotz::Loader.new
+loader.load( 'Child', "tmp/test2/child.rb", { my: :option } )
+
+```

data/lib/slotz/loader/base.rb

@@ -0,0 +1,8 @@
+require 'base64'
+require 'slotz'
+
+$options    = Marshal.load( Base64.strict_decode64( ARGV.pop ) )
+$executable = ARGV.pop
+$execute    = !!$options[:execute]
+
+load $executable

data/lib/slotz/loader.rb

@@ -0,0 +1,113 @@
+require 'base64'
+
+module Slotz
+class Loader
+
+    RUNNER = "#{File.dirname( __FILE__ )}/loader/base.rb"
+
+    def initialize
+        @pids = {}
+        @t    = Thread.new do
+            loop do
+                sleep 1
+                @pids.each do |pid, info|
+                    begin
+                        result = Process.waitpid( pid, Process::WNOHANG )
+                        if result
+                            @pids.delete pid
+                            resources = info[:resources]
+                            next if !resources
+
+                            Slotz::RESERVED[:disk]   -= resources[:disk]
+                            Slotz::RESERVED[:memory] -= resources[:klass.memory]
+                        end
+                    rescue Errno::ECHILD
+                        @pids.delete( pid )
+                        resources = info[:resources]
+                        next if !resources
+
+                        Slotz::RESERVED[:disk]   -= resources[:disk]
+                        Slotz::RESERVED[:memory] -= resources[:memory]
+                    end
+                end
+            end
+        end
+    end
+
+    # @param    [String]    executable
+    #   Name of the executable Ruby script found in {OptionGroups::Paths#executables}
+    #   without the '.rb' extension.
+    # @param    [Hash]  options
+    #   Options to pass to the script -- can be retrieved from `$options`.
+    #
+    # @return   [Integer]
+    #   PID of the process.
+    def load( klass, executable, options = {} )
+        if !File.exist?( executable )
+            fail "File does not exist: #{executable}"
+        end
+        executable = File.absolute_path( executable )
+
+        $options = { execute: false }
+        require_relative executable
+        klass     = Object.const_get( klass )
+        resources = Slotz.filter( klass )
+
+        stdin      = options.delete(:stdin)
+        stdout     = options.delete(:stdout)
+        stderr     = options.delete(:stderr)
+        new_pgroup = options.delete(:new_pgroup)
+        daemonize  = options.delete(:daemonize)
+
+        spawn_options = {}
+
+        if new_pgroup
+            spawn_options[:pgroup] = new_pgroup
+        end
+
+        spawn_options[:in]  = stdin  if stdin
+        spawn_options[:out] = stdout if stdout
+        spawn_options[:err] = stderr if stderr
+
+        options[:ppid]   = Process.pid
+        options[:tmpdir] = Dir.tmpdir
+
+        encoded_options = Base64.strict_encode64( Marshal.dump( options.merge( execute: true ) ) )
+        argv            = [executable, encoded_options]
+
+        # It's very, **VERY** important that we use this argument format as
+        # it bypasses the OS shell and we can thus count on a 1-to-1 process
+        # creation and that the PID we get will be for the actual process.
+        pid = Process.spawn(
+          {
+            'SLOTZ_SPAWN_OPTIONS' => Base64.strict_encode64( Marshal.dump( {} ) )
+          },
+          RbConfig.ruby,
+          RUNNER,
+          *(argv + [spawn_options])
+        )
+
+        @pids[pid] = {
+            klass:     klass,
+            resources: resources
+        }
+
+        if !daemonize
+            begin
+                Process.waitpid( pid )
+            rescue Interrupt
+                exit 0
+            end
+        end
+
+        pid
+    rescue => e
+        p e
+        e.backtrace.each do |l|
+            p l
+        end
+    end
+
+
+end
+end

data/lib/slotz/reservation.rb

@@ -1,42 +1,35 @@
 module Slotz
 
-class Reservation < Module
+module Reservation
 
-    attr_reader :disk
-    attr_reader :memory
-    attr_reader :cores
-
-    def initialize( provision )
-        @provision = provision
+    def provision( base, resources )
+        base.class_eval do
+            self.class.attr_accessor :_slotz_disk
+            self.class.attr_accessor :_slotz_memory
+            self.class.attr_accessor :_slotz_cores
 
-        ObjectSpace.define_finalizer(self, proc {
-            Slotz::RESERVED[:disk]   -= self.class.disk
-            Slotz::RESERVED[:memory] -= self.class.memory
-            Slotz::RESERVED[:cores]  -= self.class.cores
-        })
-    end
+            def initialize(*)
+                super
+                Slotz.filter self.class
+            end
 
-    def included( base )
-        provisions = @provision
-        base.class_eval do
-            @disk   = provisions[:disk]
-            def self.disk
-                @disk
+            def available_slots
+                System.available_auto self
             end
 
-            @memory = provisions[:memory]
-            def self.memory
-                @memory
+            def available_slots_on_disk
+                System.disk_space_free / self.class._slotz_disk
             end
 
-            @cores  = provisions[:cores]
-            def self.cores
-                @cores
+            def available_slots_in_memory
+                System.memory_free / self.class._slotz_memory
             end
         end
 
-        Slotz.filter base
+        base._slotz_disk   = resources[:disk]
+        base._slotz_memory = resources[:memory]
     end
+    extend self
 
 end
 

data/lib/slotz/system/platforms/mixins/unix.rb

@@ -1,4 +1,5 @@
 require 'vmstat'
+require_relative '../base'
 
 module Slotz
 class System

data/lib/slotz/system/platforms.rb

@@ -7,6 +7,6 @@ end
 end
 end
 
-Dir.glob( "#{File.dirname(__FILE__)}/**/*.rb" ).each do |platform|
+Dir.glob( "#{File.dirname(__FILE__)}/platforms/**/*.rb" ).each do |platform|
     require platform
 end

data/lib/slotz/system.rb

@@ -1,4 +1,3 @@
-require_relative 'system/platforms/base'
 require 'singleton'
 require 'set'
 
@@ -32,35 +31,35 @@ class System
 
     def initialize
         @platforms = []
-        @pids      = Set.new
-    end
-
-    def use( pid )
-        @pids << pid
-        pid
     end
 
     # @return   [Integer]
     #   Amount of new applications that can be safely run in parallel, currently.
     #   User option will override decision based on system resources.
-    def available
+    def available( application )
         # Manual mode, user gave us a value.
         if (max_slots = System.max_slots)
             max_slots - used
 
         # Auto-mode, pick the safest restriction, RAM vs CPU.
         else
-            available_auto
+            available_auto( application )
         end
     end
 
     # @return   [Integer]
     #   Amount of new applications that can be safely run in parallel, currently.
     #   The decision is based on the available resources alone.
-    def available_auto( requirements )
-        [ available_in_memory( requirements[:memory] ),
-          available_in_cpu( requirements[:cores] ),
-          available_in_disk( requirements[:disk] ) ].min
+    def available_auto( application )
+        memory_slots = available_in_memory( application.class._slotz_memory )
+        # cpu_slots    = available_in_cpu( application.cpu_requirement )
+        disk_slots   = unallocated_disk_space / application.class._slotz_disk
+
+        [
+            memory_slots,
+            # cpu_slots,
+            disk_slots
+        ].min
     end
 
     # @return   [Integer]
@@ -95,30 +94,13 @@ class System
     #   Well, they may not be really available, other stuff on the machine could
     #   be using them to a considerable extent, but we can only do so much.
     def available_in_cpu( cores )
-        @system.cpu_count - used
-    end
-
-    # @param    [Integer]   pid
-    #
-    # @return   [Integer]
-    #   Remaining memory for the scan, in bytes.
-    def remaining_memory_for( pid )
-        [memory_size - @system.memory_for_process_group( pid ), 0].max
+        cpu_count - used
     end
 
     # @return   [Integer]
     #   Amount of memory (in bytes) available for future scans.
     def unallocated_memory
-        # Available memory right now.
-        available_mem = @system.memory_free
-
-        # Remove allocated memory to figure out how much we can really spare.
-        @pids.each do |pid|
-            # Mark the remaining allocated memory as unavailable.
-            available_mem -= remaining_memory_for( pid )
-        end
-
-        available_mem
+         memory_free
     end
 
     # @param    [Integer]   pid
@@ -133,25 +115,7 @@ class System
     #   Amount of disk space (in bytes) available for future scans.
     def unallocated_disk_space
         # Available space right now.
-        available_space = @system.disk_space_free
-
-        # # Remove allocated space to figure out how much we can really spare.
-        # @pids.each do |pid|
-        #     # Mark the remaining allocated space as unavailable.
-        #     available_space -= remaining_disk_space_for( pid )
-        # end
-
-        available_space
-    end
-
-    def disk_space_requirement( application )
-        application.disk.to_i
-    end
-
-    # @return   [Fixnum]
-    #   Amount of memory (in bytes) to allocate.
-    def memory_requirement( application )
-        application.memory.to_i
+        disk_space_free
     end
 
     # @return   [Integer]
@@ -160,15 +124,6 @@ class System
         platform.memory_free
     end
 
-    # @param    [Integer]   pgid
-    #   Process group ID.
-    #
-    # @return   [Integer]
-    #   Amount of RAM in bytes used by the given GPID.
-    def memory_for_process_group( pgid )
-        platform.memory_for_process_group( pgid )
-    end
-
     # @return   [Integer]
     #   Amount of free disk space in bytes.
     def disk_space_free
@@ -216,7 +171,6 @@ class System
 
     # @private
     def reset
-        @pids.clear
         @cpu_count = nil
         @platform  = nil
     end

data/lib/slotz/version.rb

@@ -1,3 +1,3 @@
 module Slotz
-    VERSION = '0.1'
+    VERSION = '0.1.3'
 end

data/lib/slotz.rb

@@ -2,6 +2,7 @@ module Slotz
     require_relative 'slotz/version'
     require_relative 'slotz/options'
     require_relative 'slotz/system'
+    require_relative 'slotz/loader'
     require_relative 'slotz/reservation'
 
     RESERVED = {
@@ -10,26 +11,51 @@ module Slotz
       cores:  0
     }
 
-    def self.filter( reservation )
-        # fail 'Max utilization.' if Slotz::System.max_utilization?
+    def self.utilization
+        disk   = RESERVED[:disk].to_f / System.disk_space_free
+        memory = RESERVED[:memory].to_f / System.memory_free
+        [disk, memory].max
+    end
+
+    def self.filter( klass )
+        if !klass.is_a?( Class ) && !klass.is_a?( Module )
+            klass = Object.const_get( klass.to_s )
+        end
+
+        return if !klass.respond_to?(:_slotz_disk) || !klass.respond_to?(:_slotz_memory)
 
-        if RESERVED[:disk] + reservation.disk <= System.disk_space_free
-            RESERVED[:disk] += reservation.disk
+        disk   = klass._slotz_disk
+        memory = klass._slotz_memory
+
+        if RESERVED[:disk].to_i + disk.to_i <= System.disk_space_free.to_i
+            RESERVED[:disk] += disk.to_i
         else
             fail 'Not enough disk resources.'
         end
 
-        if RESERVED[:memory] + reservation.memory <= System.memory_free
-            RESERVED[:memory] += reservation.memory
+        if RESERVED[:memory].to_i + memory.to_i <= System.memory_free.to_i
+            RESERVED[:memory] += memory.to_i
         else
             fail 'Not enough memory resources.'
         end
 
-        # if RESERVED[:cores] + requirements[:cores] <= System.cores
-        #     RESERVED[:cores]  += requirements[:cores]
+        # if RESERVED[:cores].to_i + cores.to_i <= System.cores.to_i
+        #     RESERVED[:cores] += cores.to_i
         # else
-        #     fail 'Not enough CPU resources.'
+        #     fail 'Not enough memory resources.'
         # end
+
+        ObjectSpace.define_finalizer(klass, proc {
+            Slotz::RESERVED[:disk]   -= klass._slotz_disk
+            Slotz::RESERVED[:memory] -= klass._slotz_memory
+            # Slotz::RESERVED[:cores]  -= klass._slotz_cores
+        })
+
+        {
+            disk:   disk,
+            memory: memory
+            # cores:  0
+        }
     end
 
 end

data/slotz.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
     s.homepage          = 'https://github.com/qadron/cuboid'
     s.email             = 'tasos.laskos@gmail.com'
     s.authors           = [ 'Tasos Laskos' ]
-    s.licenses          = ['MIT']
+    s.licenses          = ['MPL v2']
 
     s.files            += Dir.glob( 'config/**/**' )
     s.files            += Dir.glob( 'lib/**/**' )
@@ -31,6 +31,9 @@ Gem::Specification.new do |s|
     # latest one.
     s.add_dependency 'bundler'
 
+    s.add_dependency 'ostruct'
+    s.add_dependency 'base64'
+
     s.add_dependency 'concurrent-ruby'
     s.add_dependency 'vmstat',              '~> 2.3.1'
     s.add_dependency 'sys-proctable',       '~> 1.3.0'

data/spec/slotz/system/platforms/linux_spec.rb

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'slotz/system'
 
 describe Slotz::System::Platforms::Linux do
     it_should_behave_like 'Slotz::System::Platforms::Mixins::Unix'

data/spec/slotz/system/platforms/osx_spec.rb

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'slotz/system'
 
 describe Slotz::System::Platforms::OSX do
     it_should_behave_like 'Slotz::System::Platforms::Mixins::Unix'

data/spec/slotz/system/platforms/windows_spec.rb

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'slotz/system'
 
 describe Slotz::System::Platforms::Windows, if: Slotz::System.windows? do
     it_should_behave_like 'Slotz::System::Platforms::Base'

data/spec/slotz/system_spec.rb

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'slotz/system'
 
 describe Slotz::System do
     subject { described_class.instance }

data/spec/{slotz/system/slotz_spec.rb → slotz_spec.rb}

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'slotz/system'
 
 describe Slotz do
     subject { system }

data/spec/spec_helper.rb

@@ -2,6 +2,7 @@ require_relative 'support/helpers/paths'
 
 Dir.glob( "#{support_path}/{lib,helpers,shared,factories}/**/*.rb" ).each { |f| require f }
 
+
 RSpec::Core::MemoizedHelpers.module_eval do
     alias to should
     alias to_not should_not

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: slotz
 version: !ruby/object:Gem::Version
-  version: '0.1'
+  version: 0.1.3
 platform: ruby
 authors:
 - Tasos Laskos
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-19 00:00:00.000000000 Z
+date: 2026-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -38,6 +37,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  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'
+- !ruby/object:Gem::Dependency
+  name: base64
+  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'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -85,13 +112,15 @@ email: tasos.laskos@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.md
 - LICENSE.md
+- README.md
 files:
 - Gemfile
 - LICENSE.md
 - README.md
 - lib/slotz.rb
+- lib/slotz/loader.rb
+- lib/slotz/loader/base.rb
 - lib/slotz/options.rb
 - lib/slotz/reservation.rb
 - lib/slotz/system.rb
@@ -107,17 +136,16 @@ files:
 - spec/slotz/system/platforms/linux_spec.rb
 - spec/slotz/system/platforms/osx_spec.rb
 - spec/slotz/system/platforms/windows_spec.rb
-- spec/slotz/system/slotz_spec.rb
 - spec/slotz/system_spec.rb
+- spec/slotz_spec.rb
 - spec/spec_helper.rb
 - spec/support/helpers/paths.rb
 - spec/support/shared/system/platforms/base.rb
 - spec/support/shared/system/platforms/mixins/unix.rb
 homepage: https://github.com/qadron/cuboid
 licenses:
-- MIT
+- MPL v2
 metadata: {}
-post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
@@ -133,17 +161,16 @@ 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: An application-centric, decentralised and distributed computing solution.
 test_files:
-- spec/slotz/system/slotz_spec.rb
-- spec/slotz/system/platforms/osx_spec.rb
 - spec/slotz/system/platforms/linux_spec.rb
+- spec/slotz/system/platforms/osx_spec.rb
 - spec/slotz/system/platforms/windows_spec.rb
 - spec/slotz/system_spec.rb
+- spec/slotz_spec.rb
+- spec/spec_helper.rb
+- spec/support/helpers/paths.rb
 - spec/support/shared/system/platforms/base.rb
 - spec/support/shared/system/platforms/mixins/unix.rb
-- spec/support/helpers/paths.rb
-- spec/spec_helper.rb