lib-bootp 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: cff1a108551607985c80a8b032204b539f6534f9
-  data.tar.gz: '031192352b530dfa03e1b8d70304d5c588693739'
+SHA256:
+  metadata.gz: e2223b20ccb51ae041606827b59764750331e36200a4d20ac69901e905e01238
+  data.tar.gz: 260d82295af335aaea0ebc27a25ec234b45de52d723096ae1808aaf29b36b349
 SHA512:
-  metadata.gz: 9ce33dfc7523edf9464eca445d855afe33efbf270ea0a9455234f3cf51db9b0d286042efc6a3ddb7979c2ad5fddc59a45d5921fb94abe6dd19e944553b05821b
-  data.tar.gz: a92c15c0f4f6775557b667cf2a5f2c1dac3d895c97c86024d25649e85080e330eff0ef4e1bac165db80f52ae6e7da6986e5f639bcd044e962c79432b85d99dc4
+  metadata.gz: 82ad61f8f6db41f6698eab1a5ad0f3c6087fa73ffd05e12d2ee9b5d6754e794d661678794a7553f32c1133312f7fb4cbaf5b527dd7ff5d28bfbcb2ff843d1f3d
+  data.tar.gz: dc4b2f7dbc810b088e21d82cffaac6221dd1d89975fe7f134d1fb6e6c1a61507b1f2add9b7e684502811b92b2331594dc8ed00a767aab876ed66956ae6246634

data/README.md

@@ -1,6 +1,7 @@
 # Lib::BOOTP
 
-BOOT Library written in ruby. 
+BOOTP Library written in ruby. 
+https://tools.ietf.org/html/rfc951
 
 ## Installation
 
@@ -17,6 +18,50 @@ And then execute:
 Or install it yourself as:
 
     $ gem install lib-bootp
+    
+## Usage
+
+Creating BOOTP package and sending it to BOOTP server
+
+```ruby
+bootp = Lib::BOOTP::Packet.new(
+            op: 1, # BOOTREQUEST = 1, BOOTREPLAY = 2, Default is 1
+            htype: 1, # Hardware Address Type, Default 1 is Ethernet (10Mb)
+            hlen: 6, # Hardware Address Length, Default is 6
+            hops: 0, # Hops count, Default is 0
+            xid: 1, # Transaction ID, by default is generate if not specific
+            secs: 0, # Second counts, Default is 0
+            flags: 0, # Broadcast flags, Default is not set
+            ciaddr: '0.0.0.0', # Client IP Address, Default is '0.0.0.0'
+            yiaddr: '0.0.0.0', # Your IP Address, Default is '0.0.0.0'
+            siaddr: '0.0.0.0', # Server IP Address, Default is '0.0.0.0'
+            giaddr: '0.0.0.0', # Gateway IP Address, Default is '0.0.0.0'
+            chaddr: '00:11:22:33:44:55', # Client hardware address, Default is not set
+            sname: '.', # Optional server host name 
+            file: '.', # Boot file name
+)
+
+client = UDPSocket.new
+
+packet = bootp.pack # Building BOOTP packet to send via UDP socket
+
+client.send packet, 0, "255.255.255.255", 67
+```
+
+Reading and parsing packet from socket
+
+```ruby
+server = UDPSocket.new
+server.setsockopt(Socket::SOL_SOCKET, Socket::SO_BROADCAST, true)
+server.bind("127.0.0.1", 67)
+data = server.recvfrom(1500)[0]
+bootp = Lib::BOOTP::Packet.unpack(data)
+
+# Get Operations code
+bootp.op.to_s
+#=> 'BOOTREQUEST'
+
+```
 
 ## Contributing
 

data/lib/lib/bootp/packet/ip_address.rb

@@ -3,36 +3,16 @@
 # Copyright 18.03.2016 by Piotr Wojcieszonek
 
 require 'forwardable'
-require 'ipaddr'
-#require 'comparable'
+require 'net/address'
+
 
 module Lib
   module BOOTP
     class Packet
-      class IPAddress
-        extend Forwardable
-        include Comparable
-
-        def_delegators :@ip, :to_s, :to_i
-
-        def initialize(ip)
-          @ip = if ip.is_a?(IPAddr)
-                  ip
-                else
-                  raise ArgumentError, "Wrong IP Address #{ip}" if ip.nil? || ip == ''
-                  IPAddr.new(ip, Socket::AF_INET)
-                end
-          raise ArgumentError, "Wrong IP Address #{ip}" unless @ip.is_a?(IPAddr)
-        end
-
-        def <=>(other)
-          other = IPAddr.new(other, Socket::AF_INET) unless other.is_a?(IPAddr)
-          self.to_i <=> other.to_i
-        end
+      class IPAddress < ::Net::Address::IPv4
 
         def pack
-          @ip = 0 if @ip.nil?
-          [@ip.to_i].pack('N')
+          [self.to_i].pack('N')
         end
 
         def self.unpack(ip)

data/lib/lib/bootp/version.rb

@@ -1,5 +1,5 @@
 module Lib
   module BOOTP
-    VERSION = '0.1.0'
+    VERSION = '0.1.1'
   end
 end

data/lib-bootp.gemspec

@@ -23,4 +23,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.16"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
+
+  spec.add_dependency 'net-address', '~> 0.1'
+
+  spec.required_ruby_version = '>= 2.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lib-bootp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Piotr Wojcieszonek
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-12-22 00:00:00.000000000 Z
+date: 2018-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: net-address
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 description: Set of classes to low level handle the BOOTP protocol
 email:
 - piotr@wojcieszonek.pl
@@ -95,7 +109,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -103,7 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 2.7.4
 signing_key: 
 specification_version: 4
 summary: BOOTP protocol library