mac_man 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3a8790951bcf3fb9153ced86590979b8bf7c4f17a558511a4f4f363d274ab52f
+  data.tar.gz: cc955f42f5b29e2b971976f7b6ac192626b6e3635c4488f72f2cc8594674536b
+SHA512:
+  metadata.gz: f1c311f3fd4fe510fab198cc335381232a1832f6729da7f2cf1c6dd90bfb5b4992ab9376a1b355d40ed7979b2046f3be00929b092ec1ddcac09d911cf77288fd
+  data.tar.gz: 74ce41ae1e531e7dd2a09bdc6c78cbb93bcdd01d5b6c5b90810eb5fd09f63ad873684a80a9e3fda88f5f4e9ab4654cb0fbbc6f8d5660555cc3f70047c67234ac

data/README.md

@@ -0,0 +1,25 @@
+# MacMac
+
+You want to generate Your own Mac Addresses or manipulate exiting addresses? Mac Man has you covered.
+
+## Create Random addresses
+
+Completely randomized address. Mac Man ensures that the broadcast flag is not set and the locally administered flag is set.
+
+```ruby
+random_address = MacMan::Address.new
+```
+
+## Create Random address with prefix
+
+Create Address where the NIC part is randomized but the prefix is fix.
+
+```ruby
+random_address = MacMan::Address.new(oui: 0xAB_CD_EF)
+```
+
+
+
+
+
+

data/lib/mac_man/address.rb

@@ -0,0 +1,66 @@
+module MacMan
+  BROADCAST_BITMASK          = 0x01_00_00_00_00_00
+  LOCAL_ADMINISTERED_BITMASK = 0x02_00_00_00_00_00
+
+  class Address
+
+    attr_accessor :address
+
+    # MAC Address for manipulation
+    #
+    # @param address [String] A MAC address for manipulation
+    # @param oui [Sring] The Organizationally Uniqe Identifier of the Address. The second half is randomized.
+    def initialize(**args)
+      if args[:address]
+        @address = args[:address]
+      elsif args[:oui]
+        @address = (args[:oui] << 24 ) + rand(0..0xFFFFFF)
+      else
+        @address = rand(0..0xFF_FF_FF_FF_FF_FF)
+        self.unset_broadcast_bit
+        self.set_locally_administered_bit
+      end
+    end
+
+    # Human readable Text representation of the address
+    #
+    # @param delimiter [String] Set the delimiter used to separate the address. Default: ':'(colon)
+    def to_hex(delimiter: ':')
+     @address.to_s(16).chars.each_slice(2).map(&:join).join(delimiter)
+    end
+
+    # Checks if the address is locally administered
+    #
+    # @see: https://en.wikipedia.org/wiki/MAC_address#Universal_vs._local_(U/L_bit)
+    def locally_administered?
+      (@address & LOCAL_ADMINISTERED_BITMASK) > 0
+    end
+
+    # Checks if the address has the broadcast flag set
+    #
+    # @see https://en.wikipedia.org/wiki/MAC_address#Unicast_vs._multicast_(I/G_bit)
+    def broadcast_address?
+      (@address & BROADCAST_BITMASK) > 0
+    end
+
+    # Enables the locally administered flag
+    #
+    # @see: https://en.wikipedia.org/wiki/MAC_address#Universal_vs._local_(U/L_bit)
+    def set_locally_administered_bit
+      @address |= LOCAL_ADMINISTERED_BITMASK
+    end
+
+    # Disables the Broadcast flag
+    #
+    # @see https://en.wikipedia.org/wiki/MAC_address#Unicast_vs._multicast_(I/G_bit)
+    #
+    def unset_broadcast_bit
+      @address ^= BROADCAST_BITMASK
+    end
+
+    def to_s
+      to_hex
+    end
+
+  end
+end

data/lib/mac_man/version.rb

@@ -0,0 +1,3 @@
+module MacMan
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: mac_man
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Moritz Kraus
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2024-03-21 00:00:00.000000000 Z
+dependencies: []
+description: Generate and manipulate mac addresses
+email: moritz.kraus@makandra.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/mac_man/address.rb
+- lib/mac_man/version.rb
+homepage: https://makandra.com
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/moritz-makandra/mac_man
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: Manipulate MAC addresses
+test_files: []