ronin-support 0.4.1 → 0.5.2

data/lib/ronin/extensions.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/extensions/meta'

data/lib/ronin/extensions/enumerable.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 module Enumerable

data/lib/ronin/extensions/file.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 class File
@@ -43,12 +43,10 @@ class File
   #
   # @api public
   #
-  def File.each_line(path)
-    return enum_for(:each_line,path) unless block_given?
+  def self.each_line(path)
+    return enum_for(__method__,path) unless block_given?
 
-    File.open(path) do |file|
-      file.each_line { |line| yield line.chomp }
-    end
+    foreach(path) { |line| yield line.chomp }
   end
 
   #
@@ -78,30 +76,38 @@ class File
   #
   # @api public
   #
-  def File.each_row(path,separator=/\s+/)
-    return enum_for(:each_row,path,separator) unless block_given?
+  def self.each_row(path,separator=/\s+/)
+    return enum_for(__method__,path,separator) unless block_given?
 
-    File.each_line(path) { |line| yield line.split(separator) }
+    each_line(path) { |line| yield line.split(separator) }
   end
 
-  #
-  # Writes the given data to a specified path.
-  #
-  # @param [String] path
-  #   The path of the file to write to.
-  #
-  # @param [String] data
-  #   The data to write to the file.
-  #
-  # @return [nil]
-  #
-  # @example
-  #   File.write('dump.txt',data)
-  #
-  # @api public
-  #
-  def File.write(path,data)
-    File.open(path,'w') { |file| file.write(data) }
+  if RUBY_VERSION < '1.9.'
+    #
+    # Writes the given data to a specified path.
+    #
+    # @param [String] path
+    #   The path of the file to write to.
+    #
+    # @param [String] data
+    #   The data to write to the file.
+    #
+    # @param [Integer] offset
+    #   Optional offset to write the data to.
+    #
+    # @return [nil]
+    #
+    # @example
+    #   File.write('dump.txt',data)
+    #
+    # @api public
+    #
+    def self.write(path,data,offset=0)
+      open(path,'w') do |file|
+        file.seek(offset)
+        file.write(data)
+      end
+    end
   end
 
   #
@@ -115,7 +121,7 @@ class File
   #
   # @api public
   #
-  def File.escape_path(path)
+  def self.escape_path(path)
     path = path.to_s
 
     # remove any \0 characters first
@@ -124,7 +130,7 @@ class File
     # remove any home-dir expansions
     path.gsub!('~',"\\~")
 
-    path = File.expand_path(File.join('/',path))
+    path = expand_path(File.join('/',path))
 
     # remove the leading slash
     return path[1..-1]

data/lib/ronin/extensions/ip_addr.rb

@@ -1,27 +1,26 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/extensions/resolv'
 require 'ronin/extensions/regexp'
 
 require 'ipaddr'
-require 'strscan'
 require 'combinatorics/list_comprehension'
 
 class IPAddr
@@ -56,7 +55,7 @@ class IPAddr
   #   IPAddr.extract("Host: 127.0.0.1\n\rHost: 10.1.1.1\n\r")
   #   # => ["127.0.0.1", "10.1.1.1"]
   #
-  # @example Extract only IPv4 addresses from a large amount of text.
+  # @example Extract only IPv4 addresses from a large amount of text:
   #   IPAddr.extract(text,:v4) do |ip|
   #     puts ip
   #   end
@@ -64,21 +63,16 @@ class IPAddr
   # @api public
   #
   def IPAddr.extract(text,version=nil,&block)
-    return enum_for(:extract,text,version).to_a unless block_given?
+    return enum_for(__method__,text,version).to_a unless block_given?
 
     regexp = case version
-             when :ipv4, :v4, 4
-               Regexp::IPv4
-             when :ipv6, :v6, 6
-               Regexp::IPv6
-             else
-               Regexp::IP
+             when :ipv4, :v4, 4 then Regexp::IPv4
+             when :ipv6, :v6, 6 then Regexp::IPv6
+             else                    Regexp::IP
              end
 
-    scanner = StringScanner.new(text)
-
-    while scanner.skip_until(regexp)
-      yield scanner.matched
+    text.scan(regexp) do |match|
+      yield match
     end
 
     return nil
@@ -107,7 +101,7 @@ class IPAddr
   #   end
   #
   # @example Enumerate through a globbed IP range
-  #   IPAddr.each('10.1.1-5.*') do |ip|
+  #   IPAddr.each('10.1.1-5,10-20.*') do |ip|
   #     puts ip
   #   end
   #
@@ -119,20 +113,20 @@ class IPAddr
   # @api public
   #
   def IPAddr.each(cidr_or_glob,&block)
-    unless (cidr_or_glob.include?('*') || cidr_or_glob.include?('-'))
+    unless (cidr_or_glob.include?('*') ||
+            cidr_or_glob.include?(',') ||
+            cidr_or_glob.include?('-'))
       return IPAddr.new(cidr_or_glob).each(&block)
     end
 
-    return enum_for(:each,cidr_or_glob) unless block
+    return enum_for(__method__,cidr_or_glob) unless block
 
     if cidr_or_glob.include?('::')
       separator = '::'
       base      = 16
 
-      prefix = if cidr_or_glob.start_with?('::')
-                 '::'
-               else
-                 ''
+      prefix = if cidr_or_glob.start_with?('::') then '::'
+               else                                   ''
                end
 
       format = lambda { |address|
@@ -154,12 +148,16 @@ class IPAddr
 
       ranges << if segment == '*'
                   (1..254)
-                elsif segment.include?('-')
-                  start, stop = segment.split('-',2)
-
-                  (start.to_i(base)..stop.to_i(base))
                 else
-                  segment.to_i(base)
+                  segment.split(',').map { |octet|
+                    if octet.include?('-')
+                      start, stop = octet.split('-',2)
+
+                      (start.to_i(base)..stop.to_i(base)).to_a
+                    else
+                      octet.to_i(base)
+                    end
+                  }.flatten
                 end
     end
 
@@ -204,7 +202,7 @@ class IPAddr
   # @api public
   #
   def each
-    return enum_for(:each) unless block_given?
+    return enum_for(__method__) unless block_given?
 
     family_mask = MASKS[@family]
 

data/lib/ronin/extensions/kernel.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 module Kernel

data/lib/ronin/extensions/meta.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/extensions/meta/object'

data/lib/ronin/extensions/regexp.rb

@@ -1,27 +1,37 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/extensions/resolv'
 
+#
+# @since 0.3.0
+#
 class Regexp
 
+  # Regular expression for finding words
+  #
+  # @since 0.5.0
+  WORD = /[A-Za-z][A-Za-z'\-\.]*[A-Za-z]/
+
   # Regular expression for finding a decimal octet (0 - 255)
+  #
+  # @since 0.4.0
   OCTET = /25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9][0-9]|[0-9]/
 
   # Regular expression for finding MAC addresses in text
@@ -64,49 +74,84 @@ class Regexp
   # Regular expression to find email addresses in text
   EMAIL_ADDR = /#{USER_NAME}\@#{HOST_NAME}/
 
+  # Regular expression to find phone numbers in text
+  #
+  # @since 0.5.0
+  PHONE_NUMBER = /(?:\d[ \-\.]?)?(?:\d{3}[ \-\.]?)?\d{3}[ \-\.]?\d{4}(?:x\d+)?/
+
   # Regular expression to find deliminators in text
+  #
+  # @since 0.4.0
   DELIM = /[;&\n\r]/
 
   # Regular expression to find identifier in text
+  #
+  # @since 0.4.0
   IDENTIFIER = /[_]*[a-zA-Z]+[a-zA-Z0-9_-]*/
 
   # Regular expression to find File extensions in text
+  #
+  # @since 0.4.0
   FILE_EXT = /(?:\.[A-Za-z0-9]+)+/
 
   # Regular expression to find File names in text
+  #
+  # @since 0.4.0
   FILE_NAME = /(?:[^\/\\\. ]|\\[\/\\ ])+/
 
   # Regular expression to find Files in text
+  #
+  # @since 0.4.0
   FILE = /#{FILE_NAME}(?:#{FILE_EXT})?/
 
   # Regular expression to find Directory names in text
+  #
+  # @since 0.4.0
   DIRECTORY = /(?:\.\.|\.|#{FILE})/
 
   # Regular expression to find local UNIX Paths in text
+  #
+  # @since 0.4.0
   RELATIVE_UNIX_PATH = /(?:#{DIRECTORY}\/)+#{DIRECTORY}\/?/
 
   # Regular expression to find absolute UNIX Paths in text
+  #
+  # @since 0.4.0
   ABSOLUTE_UNIX_PATH = /(?:\/#{FILE})+\/?/
 
   # Regular expression to find UNIX Paths in text
+  #
+  # @since 0.4.0
   UNIX_PATH = /#{ABSOLUTE_UNIX_PATH}|#{RELATIVE_UNIX_PATH}/
 
   # Regular expression to find local Windows Paths in text
+  #
+  # @since 0.4.0
   RELATIVE_WINDOWS_PATH = /(?:#{DIRECTORY}\\)+#{DIRECTORY}\\?/
 
   # Regular expression to find absolute Windows Paths in text
+  #
+  # @since 0.4.0
   ABSOLUTE_WINDOWS_PATH = /[A-Za-z]:(?:\\#{FILE})+\\?/
 
   # Regular expression to find Windows Paths in text
+  #
+  # @since 0.4.0
   WINDOWS_PATH = /#{ABSOLUTE_WINDOWS_PATH}|#{RELATIVE_WINDOWS_PATH}/
 
   # Regular expression to find local Paths in text
+  #
+  # @since 0.4.0
   RELATIVE_PATH = /#{RELATIVE_UNIX_PATH}|#{RELATIVE_WINDOWS_PATH}/
 
   # Regular expression to find absolute Paths in text
+  #
+  # @since 0.4.0
   ABSOLUTE_PATH = /#{ABSOLUTE_UNIX_PATH}|#{ABSOLUTE_WINDOWS_PATH}/
 
   # Regular expression to find Paths in text
+  #
+  # @since 0.4.0
   PATH = /#{UNIX_PATH}|#{WINDOWS_PATH}/
 
 end