rrb-common 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 339ea3353a55193acc1cbe6fcb8dc51f9731f72e9ffffeb864c10f4167c1cd84
-  data.tar.gz: eff3b5a43e2efaed07990b15be1dfb42547bfbdc16cd980f6589f193cc91b258
+  metadata.gz: 6c0ce773dfdfb39eebd3eca206e2f583acc855bbbd4a00677d7bc0e4e7f3d228
+  data.tar.gz: e7054853f2f0f99977ecb8a64fa18cfcd6159b07af9cf4815ad08988275d6353
 SHA512:
-  metadata.gz: 7e2a4ccef86a0fbea08fc8c2ab5a143e350225df42d6d1a8ca56e1d97723429c8294fc2c1802c5dbde2b683e7c5f09e88989f829e0ef73a8c23b03e6d0a2083d
-  data.tar.gz: 58aca74385f3e52b34d9252954481ddc388bcadd47b2203a58ca46033db0f851efba59fc6fb11193f3e9ad7726d6cbe2155b0f328e31c7b1f105d41374566725
+  metadata.gz: 9a8566a6cccb99f6c084c2fb012e38b8d47893173de6305d4c48dd01cf07bbad3404e1e969512728c4358c41cf73fdb8d8e887d20d636e5f2a0a8cebb2546119
+  data.tar.gz: '024422087af5f9646086bda2549af7cbac08facf82eb3cb76df32665136fc0dabcdb8bcf5d983e89dbe374811dcbbbb817a7f9d51fe20f040127e8ab2958f46c'

data/lib/rune/common.rb

@@ -0,0 +1,41 @@
+Dir[File.dirname(__FILE__)].each { |file| $LOAD_PATH.unshift(file) if File.directory? file }
+
+require 'console'
+require 'dry/configurable'
+require 'dry/container'
+require 'securerandom'
+require 'singleton'
+
+# A game server written in Ruby targeting the 2006 era (or the 317-377 protocols) of the popular MMORPG, RuneScape.
+#
+# @title RuneRb
+# @author Patrick W.
+# @since 0.1.0
+module RuneRb
+
+  # The Core module contains the core classes and modules of the Rune.rb framework.
+  module Core
+    autoload :Identifiable,       'rune/core/identifiable'
+    autoload :Logging,            'rune/core/logging'
+    autoload :Unit,               'rune/core/unit'
+    autoload :Buffer,             'rune/core/buffer'
+    autoload :Constants,          'rune/core/constants'
+    autoload :ISAAC,              'rune/core/isaac'
+    autoload :ReadableBuffer,     'rune/core/readable_buffer'
+    autoload :WriteableBuffer,    'rune/core/writeable_buffer'
+
+    include Constants
+  end
+
+  # The Patches module contains all common patches to core classes.
+  module Patches
+    autoload :IntegerRefinements, 'rune/patches/integer_refinements'
+    autoload :SetRefinements,     'rune/patches/set_refinements'
+  end
+
+  # The Logger utility for the RuneRb framework.
+  # @return [Console::Logger] the logger instance.
+  def self.logger
+    Console.logger
+  end
+end

data/lib/rune/{network → core}/buffer.rb

@@ -1,10 +1,9 @@
-module RuneRb::Network
+module RuneRb::Core
 
   # A Buffer encapsulates raw data in a String instance. Depending on the mode, the buffer can be read from or written to.
   class Buffer
 
     # Constructs a new Buffer instance.
-    # @param capacity [Integer] the capacity of the buffer.
     # @param mode [String] the mode of the buffer.
     def initialize(mode: 'rw')
       @data = String.new
@@ -21,6 +20,12 @@ module RuneRb::Network
       @data.dup
     end
 
+    # Is the {Buffer#data} empty?
+    # @return [Boolean] true if the {Buffer#data} is empty, false otherwise.
+    def empty?
+      @data.empty?
+    end
+
     # Returns the limit of the buffer.
     # @return [Integer] the limit of the buffer.
     def length
@@ -62,14 +67,14 @@ module RuneRb::Network
 
     # Enables read functions on the buffer instance. Bit Access is disabled by default. Sets the bit position to 0.
     def enable_readable
-      singleton_class.include(RuneRb::Network::Readable)
+      singleton_class.include(RuneRb::Core::ReadableBuffer)
       @bit_access = false
       @bit_position = 0
     end
 
     # Enables write functions on the buffer instance.
     def enable_writeable
-      singleton_class.include(RuneRb::Network::Writeable)
+      singleton_class.include(RuneRb::Core::WriteableBuffer)
     end
   end
 end

data/lib/rune/{network → core}/constants.rb

@@ -1,4 +1,4 @@
-module RuneRb::Network::Constants
+module RuneRb::Core::Constants
   # Acceptable byte orders in which multi-byte values can be read.
   # @return [Array<Symbol>]
   BYTE_ORDERS = %i[BIG MIDDLE INVERSE_MIDDLE LITTLE].freeze

data/lib/rune/core/identifiable.rb

@@ -0,0 +1,47 @@
+module RuneRb::Core::Identifiable
+  # @!attribute [r] id
+  # @return [String, Integer, Symbol] - The identifier of the object.
+  attr_reader :identifier
+
+  # The identifier of the object.
+  # @return [String, Integer, Symbol] - The identifier of the object.
+  def identifier
+    @identifier ||= SecureRandom.uuid
+    @identifier
+  end
+
+  alias id identifier
+  alias signature identifier
+end
+
+############################################################################################################
+#  Copyright (c) 2023, Patrick W.                                                                          #
+#  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 HOLDER 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.                                    #
+#                                                                                                          #
+############################################################################################################
+

data/lib/rune/{network → core}/isaac.rb

@@ -1,4 +1,4 @@
-module RuneRb::Network
+module RuneRb::Core
   # An implementation of an ISAAC cipher used to generate random numbers for message interchange.
   class ISAAC
     using RuneRb::Patches::IntegerRefinements

data/lib/rune/core/logging.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# A module responsible for setting up logging functions.
+module RuneRb::Core::Logging
+
+  # Write information to the log.
+  # @param lines [Array, String] the lines to write to the log.
+  def log(*lines)
+    RuneRb.logger.info(self.class.name) { lines.join("\n") }
+  end
+
+  alias info log
+
+  # Write a warning to the log.
+  # @param lines [Array, String] the lines to write to the log.
+  def log!(*lines)
+    RuneRb.logger.warn(self.class.name) { lines.join("\n") }
+  end
+
+  alias warn log!
+
+  # Write an error to the log.
+  # @param lines [Array, String] the lines to write to the log.
+  def err(*lines)
+    RuneRb.logger.error(self.class.name) { lines.join("\n") }
+  end
+
+  alias error err
+
+  # Write a fatal error to the log.
+  # @param lines [Array, String] the lines to write to the log.
+  def err!(*lines)
+    RuneRb.logger.fatal(self.class.name) { lines.join("\n") }
+  end
+
+  alias fatal err!
+end
+
+############################################################################################################
+#  Copyright (c) 2023, Patrick W.                                                                          #
+#  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 HOLDER 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.                                    #
+#                                                                                                          #
+############################################################################################################
+

data/lib/rune/{network/readable.rb → core/readable_buffer.rb}

@@ -1,5 +1,5 @@
 # The Readable module contains the functions used to read data from a {Buffer} object.
-module RuneRb::Network::Readable
+module RuneRb::Core::ReadableBuffer
   using RuneRb::Patches::IntegerRefinements
 
   # @!attribute [r] bit_access
@@ -30,12 +30,12 @@ module RuneRb::Network::Readable
     end
   end
 
-  # Enables or Disables bit reading by setting the {Buffer#bit_access} variable.
+  # Enables or Disables bit reading by setting the {Readable#bit_access} variable.
   def switch_access
     @bit_access = !@bit_access
   end
 
-  # Completes a bit access by setting the {Buffer#bit_position} to the start of the next byte, then toggling {bit_access}.
+  # Completes a bit access by setting the {Readable#bit_position} to the start of the next byte, then toggling {Readable#bit_access}.
   def finish_access
     @bit_position = (@bit_position + 7) / 8
     switch_access

data/lib/rune/core/unit.rb

@@ -0,0 +1,28 @@
+module RuneRb::Core
+  # A Unit is a {Dry::Container} that encapsulates specific logic for a given system. Units are used to construct and run certain parts of the game. All {Unit} instances should include the {Singletons}.
+  # @abstract
+  class Unit
+    extend Dry::Configurable
+    include Dry::Container::Mixin
+    include RuneRb::Core::Logging
+    include Singleton
+
+    # Constructs a new instance of {Unit} and sets the name to the class name.
+    def initialize
+      @name = self.class.name.split('::')[-2]
+      super
+    end
+
+    # Prepares the unit for use. Providers are loaded and imported based on the configuration.
+    def prepare
+      info "Preparing #{@name} unit."
+
+      # Determine directory based on the class of the current instance
+      class_directory = File.dirname(self.class.instance_method(:prepare).source_location.first)
+      providers_directory = File.join(class_directory, 'providers', '*.rb')
+
+      # Load providers
+      Dir[providers_directory].sort.each { |provider| require provider }
+    end
+  end
+end

data/lib/rune/{network/writeable.rb → core/writeable_buffer.rb}

@@ -1,5 +1,5 @@
 # The Writeable module contains functions for writing data to a {Buffer} object.
-module RuneRb::Network::Writeable
+module RuneRb::Core::WriteableBuffer
 
   # Write data to the payload.
   # @param value [Integer, String, Message, Array] the value to write.
@@ -107,11 +107,11 @@ module RuneRb::Network::Writeable
   def write_long(value, mutation: :STD, signed: false, order: :BIG)
     case order
     when :BIG
-      (RuneRb::Network::BYTE_SIZE * 7).downto(0) { |div| ((div % 8).zero? and div.positive?) ? write_byte(value >> div) : next }
+      (RuneRb::Core::BYTE_SIZE * 7).downto(0) { |div| ((div % 8).zero? and div.positive?) ? write_byte(value >> div) : next }
       write_byte(value, mutation: mutation, signed: signed)
     when :LITTLE
       write_byte(value, mutation: mutation, signed: signed)
-      (0).upto(RuneRb::Network::BYTE_SIZE * 7) { |div| ((div % 8).zero? and div.positive?) ? write_byte(value >> div) : next }
+      (0).upto(RuneRb::Core::BYTE_SIZE * 7) { |div| ((div % 8).zero? and div.positive?) ? write_byte(value >> div) : next }
     else raise "Unrecognized byte order: #{order}"
     end
   end
@@ -141,8 +141,7 @@ module RuneRb::Network::Writeable
   def write_bytes(values)
     case values
     when Array then values.each { |byte| write_byte(byte.to_i) }
-    when RuneRb::Network::Packet then send(:put, values.snapshot)
-    when RuneRb::Network::Buffer then send(:put, values)
+    when RuneRb::Core::Buffer then send(:put, values)
     when String then send(:<<, values)
     end
   end
@@ -173,8 +172,8 @@ module RuneRb::Network::Writeable
 
     while amount > bit_offset
       @buffer[byte_pos] = [0].pack('c') if @buffer[byte_pos].nil?
-      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') & ~RuneRb::Network::BIT_MASK_OUT[bit_offset])].pack('c')
-      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') | (value >> (amount - bit_offset)) & RuneRb::Network::BIT_MASK_OUT[bit_offset])].pack('c')
+      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') & ~RuneRb::Core::BIT_MASK_OUT[bit_offset])].pack('c')
+      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') | (value >> (amount - bit_offset)) & RuneRb::Core::BIT_MASK_OUT[bit_offset])].pack('c')
       byte_pos += 1
       amount -= bit_offset
       bit_offset = 8
@@ -183,11 +182,11 @@ module RuneRb::Network::Writeable
     @buffer[byte_pos] = [0].pack('c') if @buffer[byte_pos].nil?
 
     if amount == bit_offset
-      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') & ~RuneRb::Network::BIT_MASK_OUT[bit_offset])].pack('c')
-      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') | (value & Rune::Network::BIT_MASK_OUT[bit_offset]))].pack('c')
+      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') & ~RuneRb::Core::BIT_MASK_OUT[bit_offset])].pack('c')
+      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') | (value & RuneRb::Core::BIT_MASK_OUT[bit_offset]))].pack('c')
     else
-      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') & ~(RuneRb::Network::BIT_MASK_OUT[amount] << (bit_offset - amount)))].pack('c')
-      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') | ((value & RuneRb::Network::BIT_MASK_OUT[amount]) << (bit_offset - amount)))].pack('c')
+      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') & ~(RuneRb::Core::BIT_MASK_OUT[amount] << (bit_offset - amount)))].pack('c')
+      @buffer[byte_pos] = [(@buffer[byte_pos].unpack1('c') | ((value & RuneRb::Core::BIT_MASK_OUT[amount]) << (bit_offset - amount)))].pack('c')
     end
   end
 end

metadata

@@ -1,43 +1,85 @@
 --- !ruby/object:Gem::Specification
 name: rrb-common
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Patrick W.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-10 00:00:00.000000000 Z
+date: 2023-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: nio4r
+  name: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.9
+        version: '2.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.9
+        version: '2.8'
 - !ruby/object:Gem::Dependency
-  name: dotenv
+  name: dry-configurable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.8'
+        version: '0.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.8'
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: dry-container
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: singleton
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: benchmark
   requirement: !ruby/object:Gem::Requirement
@@ -114,12 +156,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/rune.rb
-- lib/rune/network/buffer.rb
-- lib/rune/network/constants.rb
-- lib/rune/network/isaac.rb
-- lib/rune/network/readable.rb
-- lib/rune/network/writeable.rb
+- lib/rune/common.rb
+- lib/rune/core/buffer.rb
+- lib/rune/core/constants.rb
+- lib/rune/core/identifiable.rb
+- lib/rune/core/isaac.rb
+- lib/rune/core/logging.rb
+- lib/rune/core/readable_buffer.rb
+- lib/rune/core/unit.rb
+- lib/rune/core/writeable_buffer.rb
 - lib/rune/patches/integer_refinements.rb
 - lib/rune/patches/set_refinements.rb
 homepage:

data/lib/rune.rb

@@ -1,29 +0,0 @@
-Dir[File.dirname(__FILE__)].each { |file| $LOAD_PATH.unshift(file) if File.directory? file }
-
-require 'nio/bytebuffer'
-
-# <h1>RuneRb</h1>
-# <p>A game server written in Ruby targeting the 2006 era (or the 317-377 protocols) of the popular MMORPG, RuneScape.</p>
-#
-#
-# @author Patrick W.
-# @since 0.0.1
-module RuneRb
-
-  # The Network module contains all common network related classes and modules.
-  module Network
-    autoload :Buffer,             'rune/network/buffer'
-    autoload :Constants,          'rune/network/constants'
-    autoload :ISAAC,              'rune/network/isaac'
-    autoload :Readable,           'rune/network/readable'
-    autoload :Writeable,          'rune/network/writeable'
-
-    include Constants
-  end
-
-  # The Patches module contains all common patches to core classes.
-  module Patches
-    autoload :IntegerRefinements, 'rune/patches/integer_refinements'
-    autoload :SetRefinements,     'rune/patches/set_refinements'
-  end
-end