apex-aprs 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ab4abfcc8a45fe0ed8cf65e3af8027d5ef5bcf851f70a8e9067207b51699cc8
-  data.tar.gz: d9aeb612963bd2f85bd527d94ae8b77794326550590c98b4e51d45c3f8255991
+  metadata.gz: 50aaeb1837b3f6a1515f98e798727ec7ca74815b0b4c6c6e197710b11916bd04
+  data.tar.gz: 7a0aeaafac5d7dc07bd4d74afa2b1eaaf29fad3c64bf6eb8e160f244bd0a7bd7
 SHA512:
-  metadata.gz: 436265f8be51ee2cb49ff0f074a60a7d87214a68c56459a4ae33346da851e2013188735a0f1bdeaca974437c49720e80b4641a91f70c04fc476f831cc6e329cb
-  data.tar.gz: 6e1e45ee6ee7e680db9d3889a57f6a1c8fe1120fea3cc97484ee4c22158aa07949aaea97a7e2daea363a4fef4d0c09de5930ef1adffacb3b644c5a56da34b52d
+  metadata.gz: 4186b7b390dee0744b860b060150adb3fcbb05f9b59890eca04758ae46a60bdc1938351983a59893c27f09badcf458e7fefcd7261651afd1ef5b418311b12970
+  data.tar.gz: 3c772a99fe98e6049036c20465a6cf687dc04f17ca30ab1ea5fc895dcd47eda5ea82dd90328f0c4b2ebbeb77ca998a94d2e78db7caa6b97e0899cc6a86290e6e

data/CHANGELOG.md

@@ -1,8 +1,13 @@
 # Changelog
 
+## 1.0.4
+
+* Frames are now classes rather than a map
+* Added mechanism for comparing frames for equivalence.
+
 ## 1.0.3
 
-* Implemented the IGateTcp class for handking internet gateways.
+* Implemented the IGateTcp class for handling internet gateways.
 
 ## 1.0.2
 

data/README.md

@@ -30,7 +30,20 @@ After checking out the repo, run `bin/setup` to install dependencies. You can al
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-## Contributing
+### Unit Tests
+
+To run all unit tests first make sure you have dependencies installed:
+
+```bash
+bundle install
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/Syncleus/apex-aprs
+then run the tests with:
+
+```bash
+bundle exec rake test
+```
+
+## Contributing
 
+Bug reports and pull requests are welcome on Git at https://git.qoto.org/digipex/apex-aprs

data/apex-aprs.gemspec

@@ -34,6 +34,7 @@ Gem::Specification.new do |spec|
     spec.add_dependency 'kiss-tnc', '~> 1.0'
     spec.add_development_dependency 'bundler', '~> 2.2'
     spec.add_development_dependency 'rake', '~> 13.0'
-    spec.add_development_dependency 'rdoc', '~> 6.3'
+    spec.add_development_dependency 'test-unit', '~> 3.6'
+    #spec.add_development_dependency 'rdoc', '~> 6.3'
     spec.add_development_dependency 'aruba', '~> 2.0'
 end

data/lib/apex/app_info.rb

@@ -1,3 +1,3 @@
 module Apex
-    VERSION = "1.0.3"
+    VERSION = "1.0.4"
 end

data/lib/apex/aprs_kiss.rb

@@ -1,4 +1,5 @@
 require 'kiss/constants'
+require 'apex/frame'
 
 module Apex
     class AprsKiss
@@ -11,7 +12,6 @@ module Apex
 
         private
         def self.decode_frame(raw_frame)
-            frame = {}
             frame_len = raw_frame.length
 
             if frame_len > 16
@@ -22,12 +22,12 @@ module Apex
                         # Less than 2 callsigns?
                         if 1.0 < i and i < 11.0
                             if raw_frame[raw_slice + 1] & 0x03 == 0x03 and [0xf0, 0xcf].include? raw_frame[raw_slice + 2]
-                                text_as_array = raw_frame[raw_slice + 3..-1].map { |b| b.chr }
-                                frame[:text] = text_as_array.join
-                                frame[:destination] = identity_as_string(extract_callsign(raw_frame))
-                                frame[:source] = identity_as_string(extract_callsign(raw_frame[7..-1]))
-                                frame[:path] = extract_path(i.to_i, raw_frame)
-                                return frame
+                                payload_as_array = raw_frame[raw_slice + 3..-1].map { |b| b.chr }
+                                payload = payload_as_array.join
+                                destination = identity_as_string(extract_callsign(raw_frame))
+                                source = identity_as_string(extract_callsign(raw_frame[7..-1]))
+                                path = extract_path(i.to_i, raw_frame)
+                                return Frame.new(source, destination, path, payload)
                             end
                         end
                     end
@@ -94,13 +94,13 @@ module Apex
 
         private
         def self.encode_frame(frame)
-            enc_frame = encode_callsign(parse_identity_string(frame[:destination])) + encode_callsign(parse_identity_string(frame[:source]))
+            enc_frame = encode_callsign(parse_identity_string(frame.destination)) + encode_callsign(parse_identity_string(frame.source))
 
-            frame[:path].each do |path|
+            frame.path.each do |path|
                 enc_frame += encode_callsign(parse_identity_string(path))
             end
 
-            return enc_frame[0...-1] + [enc_frame[-1] | 0x01] + [Kiss::SLOT_TIME] + [0xf0] + frame[:text].chars.map { |c| c.ord }
+            return enc_frame[0...-1] + [enc_frame[-1] | 0x01] + [Kiss::SLOT_TIME] + [0xf0] + frame.payload.chars.map { |c| c.ord }
         end
 
         private
@@ -170,4 +170,4 @@ module Apex
             end
         end
     end
-end
+end

data/lib/apex/frame.rb

@@ -0,0 +1,124 @@
+module Apex
+  public
+  class UnpathedFrame
+    attr_accessor :source, :destination, :payload
+
+    protected
+    def initialize(source, destination, payload)
+      @source = source
+      @destination = destination
+      @payload = payload
+    end
+
+    public
+    def path_agnostic_eql?(other)
+      raise ArgumentError.new("The argument must be either an UnpathedFrame or a PathAgnosticFrame") if not ((other.instance_of? UnpathedFrame) || (other.instance_of? PathAgnosticFrame))
+
+      return self == other
+    end
+
+    public
+    def path_agnostic_equality?(other)
+      return false if (not other.respond_to? :source) ||
+                      (not other.respond_to? :destination) ||
+                      (not other.respond_to? :payload)
+
+      if (self.source.eql? other.source) && (self.destination.eql? other.destination) && (self.payload.eql? other.payload)
+         return true
+      else
+        return false
+      end
+    end
+
+    public
+    def path_agnostic_hash
+      return [self.source, self.destination, self.payload].hash
+    end
+
+    public
+    def ==(other)
+      return self.path_agnostic_equality? other
+    end
+
+    public
+    def eql?(other)
+      self.path_agnostic_eql? other
+    end
+
+    public
+    def hash
+      return self.path_agnostic_hash
+    end
+  end
+
+  public
+  class Frame < UnpathedFrame
+    attr_accessor :path
+
+    protected
+    def initialize(source, destination, path, payload)
+      super(source, destination, payload)
+
+      @path = path
+    end
+
+    public
+    def eql?(other)
+      raise ArgumentError.new("The argument can not be a UnpathedFrame or a PathAgnosticFrame") if ((other.instance_of? UnpathedFrame) || (other.instance_of? PathAgnosticFrame))
+      raise ArgumentError.new("The argument must be of type Frame (or a child class).") if not other.kind_of? Frame
+
+      return self == other
+    end
+
+    public
+    def ==(other)
+      return false if not super(other)
+
+      return false if not other.respond_to? :path
+
+      if self.path.eql? other.path
+         return true
+      else
+        return false
+      end
+    end
+
+    public
+    def hash
+      return [super, self.path].hash
+    end
+
+    public
+    def path_agnostic_identity
+      return PathAgnosticFrame.new(self)
+    end
+  end
+
+  private
+  class PathAgnosticFrame < Frame
+    protected
+    def initialize(frame)
+      super(frame.source, frame.destination, frame.path, frame.payload)
+    end
+
+    public
+    def eql?(other)
+      return self.path_agnostic_eql? other
+    end
+
+    public
+    def ==(other)
+      return self.path_agnostic_equality? other
+    end
+
+    public
+    def hash
+      return self.path_agnostic_hash
+    end
+
+    public
+    def path_agnostic_identity
+      return self
+    end
+  end
+end

data/lib/apex/igate_tcp.rb

@@ -7,8 +7,9 @@ module Apex
         DEFAULT_APRSIS_FILTER_PORT = 14580
 
         protected
-        def initialize(user, password='-1')
+        def initialize(user, password=nil)
             @user = user
+            password = IGateTcp.calculatePasscode(user) if password.nil?
             @auth = ['user', user, 'pass', password, 'vers', "APEX #{VERSION}"].join(' ')
             @aprsis_sock = nil
             @data_buffer = ''
@@ -29,23 +30,23 @@ module Apex
 
         private
         def self.encode_frame(frame)
-            formatted_frame = [frame[:source], frame[:destination]].join('>')
-            if frame[:path] and frame[:path].length > 0
-                formatted_frame = [formatted_frame, IGateTcp::format_path(frame[:path])].join(',')
+            formatted_frame = [frame.source, frame.destination].join('>')
+            if frame.path and frame.path.length > 0
+                formatted_frame = [formatted_frame, IGateTcp::format_path(frame.path)].join(',')
             end
             formatted_frame += ':'
-            formatted_frame += frame[:text]
+            formatted_frame += frame.payload
             return formatted_frame
         end
 
         private
         def self.decode_frame(frame)
-            decoded_frame = {}
+            decoded_source = nil
             frame_so_far = ''
             path = nil
             frame.chars.each do |char|
-                if char == '>' and !decoded_frame.include? :source
-                    decoded_frame[:source] = frame_so_far
+                if char == '>' and decoded_source.nil?
+                    decoded_source = frame_so_far
                     frame_so_far = ''
                 elsif char == ':' and !path
                     path = frame_so_far
@@ -56,11 +57,28 @@ module Apex
             end
 
             path = path.split(',')
-            decoded_frame[:destination] = path.shift
-            decoded_frame[:path] = path
-            decoded_frame[:text] = frame_so_far
+            decoded_destination = path.shift
+            decoded_path = path
+            decoded_payload = frame_so_far
 
-            decoded_frame
+            return Frame.new(decoded_source, decoded_destination, decoded_path, decoded_payload)
+        end
+
+        private
+        def self.calculatePasscode(callsign_raw)
+          callsign = callsign_raw.upcase.split('-').first
+          hash = 0x73e2
+          flag = true
+
+          callsign.split('').each do |c|
+            hash = if flag
+                      (hash ^ (c.ord << 8))
+                    else
+                      (hash ^ c.ord)
+                    end
+            flag = !flag
+          end
+          hash & 0x7fff
         end
 
         public

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: apex-aprs
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Jeffrey Phillips Freeman
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-09-07 00:00:00.000000000 Z
+date: 2023-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: abstraction
@@ -81,19 +81,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: rdoc
+  name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.3'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.3'
+        version: '3.6'
 - !ruby/object:Gem::Dependency
   name: aruba
   requirement: !ruby/object:Gem::Requirement
@@ -129,13 +129,14 @@ files:
 - lib/apex.rb
 - lib/apex/app_info.rb
 - lib/apex/aprs_kiss.rb
+- lib/apex/frame.rb
 - lib/apex/igate_tcp.rb
 homepage: https://github.com/Syncleus/apex-aprs
 licenses:
 - Apache-2.0
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -150,8 +151,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.5
-signing_key: 
+rubygems_version: 3.4.16
+signing_key:
 specification_version: 4
 summary: Library for APRS, Automatic Packet Reporting System, communications including
   the next-generation APEX extensions. Includes an APRS-IS client.