ronin-support 0.5.2 → 1.0.0.beta2

data/lib/ronin/fuzzing/template.rb

@@ -1,133 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin-support.
-#
-# 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,
-# 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 <https://www.gnu.org/licenses/>.
-#
-
-require 'chars'
-require 'combinatorics/generator'
-require 'combinatorics/list_comprehension'
-
-module Ronin
-  module Fuzzing
-    #
-    # Fuzzing class that generates Strings based on a template.
-    #
-    # @api semipublic
-    #
-    # @since 0.5.0
-    #
-    class Template
-
-      include Enumerable
-
-      #
-      # Initializes a new Fuzzing template.
-      #
-      # @param [Array(<String,Symbol,Enumerable>, <Integer,Array,Range>)] fields
-      #   The fields which defines the string or character sets which will
-      #   make up parts of the String.
-      #
-      # @raise [ArgumentError]
-      #   A given character set name was unknown.
-      #
-      # @raise [TypeError]
-      #   A given string set was not a String, Symbol or Enumerable.
-      #   A given string set length was not an Integer or Enumerable.
-      #
-      def initialize(fields)
-        @enumerators = []
-
-        fields.each do |(set,length)|
-          enum = case set
-                 when String
-                   [set].each
-                 when Enumerable
-                   set.each
-                 when Symbol
-                   name = set.to_s.upcase
-
-                   unless Chars.const_defined?(name)
-                     raise(ArgumentError,"unknown charset #{set.inspect}")
-                   end
-
-                   Chars.const_get(name).each_char
-                 else
-                   raise(TypeError,"set must be a String, Symbol or Enumerable")
-                 end
-
-          case length
-          when Integer
-            length.times { @enumerators << enum.dup }
-          when Array, Range
-            @enumerators << Combinatorics::Generator.new do |g|
-              length.each do |sublength|
-                superset = Array.new(sublength) { enum.dup }
-
-                superset.comprehension { |strings| g.yield strings.join }
-              end
-            end
-          when nil
-            @enumerators << enum
-          else
-            raise(TypeError,"length must be an Integer, Range or Array")
-          end
-        end
-      end
-
-      #
-      # @see #initialize
-      #
-      def self.[](*fields)
-        new(fields)
-      end
-
-      #
-      # Generate permutations of Strings from a format template.
-      #
-      # @yield [string]
-      #   The given block will be passed each unique String.
-      #
-      # @yieldparam [String] string
-      #   A newly generated String.
-      #
-      # @return [Enumerator]
-      #   If no block is given, an Enumerator will be returned.
-      #
-      def each
-        return enum_for(__method__) unless block_given?
-
-        @enumerators.comprehension do |fields|
-          string = ''
-
-          fields.each do |field|
-            string << case field
-                      when Integer
-                        field.chr
-                      else
-                        field.to_s
-                      end
-          end
-
-          yield string
-        end
-
-        return nil
-      end
-
-    end
-  end
-end

data/lib/ronin/fuzzing.rb

@@ -1,21 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin-support.
-#
-# 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,
-# 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 <https://www.gnu.org/licenses/>.
-#
-
-require 'ronin/fuzzing/extensions'
-require 'ronin/fuzzing/fuzzing'

data/lib/ronin/mixin.rb

@@ -1,89 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin.
-#
-# Ronin is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin 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 General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with Ronin.  If not, see <https://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  #
-  # A base Module for all other Mixin modules. Adds a `mixin` method
-  # which includes/extends other Modules and evaluates a block of
-  # code, within any Classes/Objects it is included/extended into.
-  #
-  #     module MyMixin
-  #       include Mixin
-  #
-  #       mixin Paremters
-  #
-  #       mixin do
-  #         parameter :user, :default => 'admin'
-  #       end
-  #     end
-  #
-  # @since 0.2.0
-  #
-  module Mixin
-    #
-    # Defines the `mixin` method when included.
-    #
-    # @since 0.2.0
-    #
-    def self.included(base)
-      base.module_eval do
-        protected
-
-        #
-        # Mixins in the modules or code block into other modules that the
-        # module might be included or extended into.
-        #
-        # @param [Array<Module>] modules
-        #   Other modules to mixin.
-        #
-        # @yield []
-        #   The given code block will be evaluated into the modules
-        #   the module is included or extended into.
-        #
-        # @since 0.2.0
-        #
-        # @api semipublic
-        #
-        def self.mixin(*modules,&block)
-          unless modules.empty?
-            @mixin_modules = modules
-          end
-
-          @mixin_block = block if block
-
-          def self.included(base)
-            if @mixin_modules
-              base.send(:include,*@mixin_modules)
-            end
-
-            base.module_eval(&@mixin_block) if @mixin_block
-          end
-
-          def self.extended(base)
-            if @mixin_modules
-              base.send(:extend,*@mixin_modules)
-            end
-
-            base.instance_eval(&@mixin_block) if @mixin_block
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ronin/network/dns.rb

@@ -1,201 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin-support.
-#
-# 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,
-# 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 <https://www.gnu.org/licenses/>.
-#
-
-require 'resolv'
-
-module Ronin
-  module Network
-    #
-    # Provides helper methods for performing DNS queries.
-    #
-    # @since 0.4.0
-    #
-    module DNS
-      #
-      # The DNS nameserver to query.
-      #
-      # @return [String, nil]
-      #   The address of the nameserver.
-      #
-      # @api public
-      #
-      def self.nameserver
-        @nameserver
-      end
-
-      #
-      # Sets the DNS nameserver to be queried.
-      #
-      # @param [IPAddr, String, nil] address
-      #   The address of the nameserver.
-      #
-      # @return [String, nil]
-      #   The address of the new nameserver.
-      #
-      # @api public
-      #
-      def self.nameserver=(address)
-        @nameserver = if address
-                        address.to_s
-                      end
-      end
-
-      #
-      # Creates a DNS Resolver for the nameserver.
-      #
-      # @param [String, nil] nameserver
-      #   Optional DNS nameserver to query.
-      #
-      # @return [Resolv, Resolv::DNS]
-      #   The DNS Resolver.
-      #
-      # @api public
-      #
-      def dns_resolver(nameserver=DNS.nameserver)
-        if nameserver then Resolv::DNS.new(:nameserver => nameserver)
-        else               Resolv
-        end
-      end
-
-      #
-      # Looks up the address of a hostname.
-      #
-      # @param [String] hostname
-      #   The hostname to lookup.
-      #
-      # @param [String, nil] nameserver
-      #   Optional DNS nameserver to query.
-      #
-      # @yield [address]
-      #   If a block is given and the hostname was resolved, the address will
-      #   be passed to the block.
-      #
-      # @yieldparam [String] address
-      #   The address of the hostname.
-      #
-      # @return [String, nil]
-      #   The address of the hostname.
-      #
-      # @api public
-      #
-      def dns_lookup(hostname,nameserver=DNS.nameserver)
-        hostname = hostname.to_s
-        resolv   = dns_resolver(nameserver)
-        address  = begin
-                     resolv.getaddress(hostname).to_s
-                   rescue Resolv::ResolvError
-                   end
-
-        yield(address) if (block_given? && address)
-        return address
-      end
-
-      #
-      # Looks up all addresses of a hostname.
-      #
-      # @param [String] hostname
-      #   The hostname to lookup.
-      #
-      # @param [String, nil] nameserver
-      #   Optional DNS nameserver to query.
-      #
-      # @yield [address]
-      #   If a block is given, each resolved address will be passed to the
-      #   block.
-      #
-      # @yieldparam [String] address
-      #   A address of the hostname.
-      #
-      # @return [Array<String>]
-      #   The addresses of the hostname.
-      #
-      # @api public
-      #
-      def dns_lookup_all(hostname,nameserver=DNS.nameserver,&block)
-        hostname  = hostname.to_s
-        addresses = dns_resolver(nameserver).getaddresses(hostname).map(&:to_s)
-
-        addresses.each(&block) if block
-        return addresses
-      end
-
-      #
-      # Looks up the hostname of the address.
-      #
-      # @param [String] address
-      #   The address to lookup.
-      #
-      # @param [String, nil] nameserver
-      #   Optional DNS nameserver to query.
-      #
-      # @yield [hostname]
-      #   If a block is given and a hostname was found for the address,
-      #   the resolved hostname will be passed to the block.
-      #
-      # @yieldparam [String] hostname
-      #   The hostname of the address.
-      #
-      # @return [String, nil]
-      #   The hostname of the address.
-      #
-      # @api public
-      #
-      def dns_reverse_lookup(address,nameserver=DNS.nameserver)
-        address  = address.to_s
-        resolv   = dns_resolver(nameserver)
-        hostname = begin
-                     resolv.getname(address).to_s
-                   rescue Resolv::ResolvError
-                   end
-
-        yield(hostname) if (block_given? && hostname)
-        return hostname
-      end
-
-      #
-      # Looks up all hostnames associated with the address.
-      #
-      # @param [String] address
-      #   The address to lookup.
-      #
-      # @param [String, nil] nameserver
-      #   Optional DNS nameserver to query.
-      #
-      # @yield [hostname]
-      #   If a block is given and hostnames were found for the address,
-      #   each hostname will be passed to the block.
-      #
-      # @yieldparam [String] hostname
-      #   A hostname of the address.
-      #
-      # @return [Array<String>]
-      #   The hostnames of the address.
-      #
-      # @api public
-      #
-      def dns_reverse_lookup_all(address,nameserver=DNS.nameserver,&block)
-        address   = address.to_s
-        hostnames = dns_resolver(nameserver).getnames(address).map(&:to_s)
-
-        hostnames.each(&block) if block
-        return hostnames
-      end
-    end
-  end
-end

data/lib/ronin/network/esmtp.rb

@@ -1,113 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin-support.
-#
-# 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,
-# 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 <https://www.gnu.org/licenses/>.
-#
-
-require 'ronin/network/smtp'
-
-module Ronin
-  module Network
-    #
-    # Provides helper methods for communicating with ESMTP services.
-    #
-    module ESMTP
-      include SMTP
-
-      #
-      # @see SMTP.message
-      #
-      # @api public
-      #
-      def esmtp_message(options={},&block)
-        smtp_message(options,&block)
-      end
-
-      #
-      # Creates a connection to the ESMTP server.
-      #
-      # @param [String] host
-      #   The host to connect to.
-      #
-      # @param [Hash] options
-      #   Additional options.
-      #
-      # @option options [Integer] :port (SMTP.default_port)
-      #   The port to connect to.
-      #
-      # @option options [String] :helo
-      #   The HELO domain.
-      #
-      # @option options [Symbol] :auth
-      #   The type of authentication to use. Can be either `:login`, `:plain`,
-      #   or `:cram_md5`.
-      #
-      # @option options [String] :user
-      #   The user-name to authenticate with.
-      #
-      # @option options [String] :password
-      #   The password to authenticate with.
-      #
-      # @yield [session]
-      #   If a block is given, it will be passed an ESMTP enabled session
-      #   object.
-      #
-      # @yieldparam [Net::SMTP] session
-      #   The ESMTP session.
-      #
-      # @return [Net::SMTP]
-      #   The ESMTP enabled session.
-      #
-      # @api public
-      #
-      def esmtp_connect(host,options={})
-        session = smtp_connect(host,options)
-        session.esmtp = true
-
-        yield session if block_given?
-        return session
-      end
-
-      #
-      # Starts an ESMTP session with the ESMTP enabled server.
-      #
-      # @param [String] host
-      #   The host to connect to.
-      #
-      # @param [Hash] options
-      #   Additional options.
-      #
-      # @yield [session]
-      #   If a block is given, it will be passed an ESMTP enabled session
-      #   object. After the block has returned, the session will be closed.
-      #
-      # @yieldparam [Net::SMTP] session
-      #   The ESMTP session.
-      #
-      # @see Net.esmtp_connect
-      #
-      # @api public
-      #
-      def esmtp_session(host,options={})
-        smtp_session(host,options) do |session|
-          session.esmtp = true
-
-          yield session if block_given?
-        end
-      end
-    end
-  end
-end

data/lib/ronin/network/extensions/dns.rb

@@ -1,20 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin-support.
-#
-# 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,
-# 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 <https://www.gnu.org/licenses/>.
-#
-
-require 'ronin/network/extensions/dns/net'

data/lib/ronin/network/extensions/esmtp.rb

@@ -1,20 +0,0 @@
-#
-# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of ronin-support.
-#
-# 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,
-# 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 <https://www.gnu.org/licenses/>.
-#
-
-require 'ronin/network/extensions/esmtp/net'