ronin-support 0.3.0 → 0.4.0.rc1

data/lib/ronin/network/extensions/imap/net.rb

@@ -18,109 +18,7 @@
 #
 
 require 'ronin/network/imap'
-require 'ronin/network/ssl'
-
-require 'net/imap'
 
 module Net
-  #
-  # Creates a connection to the IMAP server.
-  #
-  # @param [String] host
-  #   The host to connect to.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [Integer] :port (IMAP.default_port)
-  #   The port the IMAP server is running on.
-  #
-  # @option options [String] :certs
-  #   The path to the file containing CA certs of the server.
-  #
-  # @option options [Symbol] :auth
-  #   The type of authentication to perform when connecting to the server.
-  #   May be either `:login` or `:cram_md5`.
-  #
-  # @option options [String] :user
-  #   The user to authenticate as when connecting to the server.
-  #
-  # @option options [String] :password
-  #   The password to authenticate with when connecting to the server.
-  #
-  # @yield [session]
-  #   If a block is given, it will be passed the newly created IMAP
-  #   session.
-  #
-  # @yieldparam [Net::IMAP] session
-  #   The newly created IMAP session object.
-  #
-  # @return [Net::IMAP]
-  #   The newly created IMAP session object.
-  #
-  # @api public
-  #
-  def Net.imap_connect(host,options={})
-    host = host.to_s
-    port = (options[:port] || Ronin::Network::IMAP.default_port)
-    certs = options[:certs]
-    auth = options[:auth]
-    user = options[:user]
-    passwd = options[:password]
-
-    if options[:ssl]
-      ssl = true
-      ssl_certs = options[:ssl][:certs]
-      ssl_verify = Ronin::Network::SSL::VERIFY[options[:ssl][:verify]]
-    else
-      ssl = false
-      ssl_verify = false
-    end
-
-    session = Net::IMAP.new(host,port,ssl,ssl_certs,ssl_verify)
-
-    if user
-      if auth == :cram_md5
-        session.authenticate('CRAM-MD5',user,passwd)
-      else
-        session.authenticate('LOGIN',user,passwd)
-      end
-    end
-
-    yield session if block_given?
-    return session
-  end
-
-  #
-  # Starts an IMAP session with the IMAP 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 the newly created IMAP
-  #   session. After the block has returned, the session will be closed.
-  #
-  # @yieldparam [Net::IMAP] session
-  #   The newly created IMAP session object.
-  #
-  # @return [nil]
-  #
-  # @see Net.imap_connect
-  #
-  # @api public
-  #
-  def Net.imap_session(host,options={})
-    session = Net.imap_connect(host,options)
-
-    yield session if block_given?
-
-    session.logout if options[:user]
-    session.close
-    session.disconnect
-    return nil
-  end
+  extend Ronin::Network::IMAP
 end

data/lib/ronin/network/extensions/pop3/net.rb

@@ -19,76 +19,6 @@
 
 require 'ronin/network/pop3'
 
-require 'net/pop'
-
 module Net
-  #
-  # Creates a connection to the POP3 server.
-  #
-  # @param [String] host
-  #   The host to connect to.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [Integer] :port (Ronin::Network::POP3.default_port)
-  #   The port the POP3 server is running on.
-  #
-  # @option options [String] :user
-  #   The user to authenticate with when connecting to the POP3 server.
-  #
-  # @option options [String] :password
-  #   The password to authenticate with when connecting to the POP3 server.
-  #
-  # @yield [session]
-  #   If a block is given, it will be passed the newly created POP3 session.
-  #
-  # @yieldparam [Net::POP3] session
-  #   The newly created POP3 session.
-  #
-  # @return [Net::POP3]
-  #   The newly created POP3 session.
-  #
-  # @api public
-  #
-  def Net.pop3_connect(host,options={})
-    host = host.to_s
-    port = (options[:port] || Ronin::Network::POP3.default_port)
-    user = options[:user]
-    password = options[:password]
-
-    session = Net::POP3.start(host,port,user,password)
-
-    yield session if block_given?
-    return session
-  end
-
-  #
-  # Starts a session with the POP3 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 the newly created POP3 session.
-  #   After the block has returned, the session will be closed.
-  #
-  # @yieldparam [Net::POP3] session
-  #   The newly created POP3 session.
-  #
-  # @return [nil]
-  #
-  # @api public
-  #
-  def Net.pop3_session(host,options={})
-    session = Net.pop3_connect(host,options)
-
-    yield session if block_given?
-
-    session.finish
-    return nil
-  end
+  extend Ronin::Network::POP3
 end

data/lib/ronin/network/extensions/smtp/net.rb

@@ -17,163 +17,8 @@
 # along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
 #
 
-require 'ronin/network/smtp/smtp'
-require 'ronin/network/smtp/email'
-
-require 'net/smtp'
+require 'ronin/network/smtp'
 
 module Net
-  #
-  # Creates a new email message.
-  #
-  # @param [Hash] options
-  #   Additional options for the email.
-  #
-  # @yield [email]
-  #   The given block will be passed the new email.
-  #
-  # @yieldparam [Ronin::Network::SMTP::Email] email
-  #   The new email.
-  #
-  # @see Ronin::Network::SMTP::Email.new
-  #
-  # @api public
-  #
-  def Net.smtp_message(options={},&block)
-    Ronin::Network::SMTP::Email.new(options,&block)
-  end
-
-  #
-  # Creates a connection to the SMTP server.
-  #
-  # @param [String] host
-  #   The host to connect to.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [Integer] :port (Ronin::Network::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 SMTP session object.
-  #
-  # @yieldparam [Net::SMTP] session
-  #   The SMTP session.
-  #
-  # @return [Net::SMTP]
-  #   The SMTP session.
-  #
-  # @example
-  #   Net.smtp_connect('www.example.com', :user => 'joe')
-  #
-  # @api public
-  #
-  def Net.smtp_connect(host,options={})
-    host = host.to_s
-    port = (options[:port] || Ronin::Network::SMTP.default_port)
-
-    helo = options[:helo]
-
-    auth = options[:auth]
-    user = options[:user]
-    password = options[:password]
-
-    session = Net::SMTP.start(host,port,helo,user,password,auth)
-
-    yield session if block_given?
-    return session
-  end
-
-  #
-  # Starts a session with the SMTP 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 SMTP session object.
-  #   After the block has returned, the session will be closed.
-  #
-  # @yieldparam [Net::SMTP] session
-  #   The SMTP session.
-  #
-  # @example
-  #   Net.smtp_session('www.example.com', :user => 'joe') do |smtp|
-  #     # ...
-  #   end
-  #
-  # @see Net.smtp_connect
-  #
-  # @api public
-  #
-  def Net.smtp_session(host,options={})
-    session = Net.smtp_connect(host,options)
-
-    yield session if block_given?
-
-    session.finish
-    return nil
-  end
-
-  #
-  # @since 0.2.0
-  #
-  # @param [String] host
-  #   The host to connect to.
-  #
-  # @param [Hash] options
-  #   Additional SMTP and Email options.
-  #
-  # @yield [email]
-  #   The given block will be passed the new email to be sent.
-  #
-  # @yieldparam [Ronin::Network::SMTP::Email] email
-  #   The new email to be sent.
-  #
-  # @see Net.smtp_session
-  #
-  # @example
-  #   Net.smtp_send_message 'www.example.com', :to => 'joe@example.com',
-  #                                            :from => 'eve@example.com',
-  #                                            :subject => 'Hello',
-  #                                            :message_id => 'XXXX',
-  #                                            :body => 'Hello'
-  #
-  # @example Using the block.
-  #   Net.smtp_send_message('www.example.com') do |email|
-  #     email.to = 'joe@example.com'
-  #     email.from 'eve@example.com'
-  #     email.subject = 'Hello'
-  #     email.message_id = 'XXXXXXXXXX'
-  #     email.body << 'Hello!'
-  #   end
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def Net.smtp_send_message(host,options={},&block)
-    email = Net.smtp_message(options,&block)
-
-    Net.smtp_session(host,options) do |smtp|
-      smtp.send_message(email.to_s, email.from, email.to)
-    end
-  end
+  extend Ronin::Network::SMTP
 end

data/lib/ronin/network/extensions/ssl/net.rb

@@ -17,139 +17,8 @@
 # along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
 #
 
-require 'ronin/network/extensions/tcp/net'
 require 'ronin/network/ssl'
 
-begin
-  require 'openssl'
-rescue ::LoadError
-end
-
 module Net
-  #
-  # Establishes a SSL connection.
-  #
-  # @param [String] host
-  #   The host to connect to.
-  #
-  # @param [Integer] port
-  #   The port to connect to.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [String] :local_host
-  #   The local host to bind to.
-  #
-  # @option options [Integer] :local_port
-  #   The local port to bind to.
-  #
-  # @option options [Symbol] :verify
-  #   Specifies whether to verify the SSL certificate.
-  #   May be one of the following:
-  #
-  #   * `:none`
-  #   * `:peer`
-  #   * `:client_once`
-  #   * `:fail_if_no_peer_cert`
-  #
-  # @option options [String] :cert
-  #   The path to the SSL certificate.
-  #
-  # @option options [String] :key
-  #   The path to the SSL key.
-  #
-  # @yield [ssl_socket]
-  #   The given block will be passed the new SSL Socket.
-  #
-  # @yieldparam [OpenSSL::SSL::SSLSocket] ssl_socket
-  #   The new SSL Socket.
-  #
-  # @return [OpenSSL::SSL::SSLSocket]
-  #   the new SSL Socket.
-  #
-  # @example
-  #   socket = Net.ssl_connect('twitter.com',443)
-  #
-  # @api public
-  #
-  def Net.ssl_connect(host,port,options={})
-    local_host = options[:local_host]
-    local_port = options[:local_port]
-
-    socket = Net.tcp_connect(host,port,local_host,local_port)
-
-    ssl_context = OpenSSL::SSL::SSLContext.new()
-    ssl_context.verify_mode = Ronin::Network::SSL::VERIFY[options[:verify]]
-
-    if options[:cert]
-      cert_file = File.new(options[:cert])
-      ssl_context.cert = OpenSSL::X509::Certificate.new(cert_file)
-    end
-
-    if options[:key]
-      key_file = File.new(options[:key])
-      ssl_context.key = OpenSSL::PKey::RSA.new(key_file)
-    end
-
-    ssl_socket = OpenSSL::SSL::SSLSocket.new(socket,ssl_context)
-    ssl_socket.sync_close = true
-    ssl_socket.connect
-
-    yield ssl_socket if block_given?
-    return ssl_socket
-  end
-
-  #
-  # Creates a new temporary SSL connection.
-  #
-  # @param [String] host
-  #   The host to connect to.
-  #
-  # @param [Integer] port
-  #   The port to connect to.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [String] :local_host
-  #   The local host to bind to.
-  #
-  # @option options [Integer] :local_port
-  #   The local port to bind to.
-  #
-  # @option options [Symbol] :verify
-  #   Specifies whether to verify the SSL certificate.
-  #
-  # @option options [String] :cert
-  #   The path to the SSL certificate.
-  #
-  # @option options [String] :key
-  #   The path to the SSL key.
-  #
-  # @yield [ssl_socket]
-  #   The given block will be passed the temporary SSL Socket.
-  #
-  # @yieldparam [OpenSSL::SSL::SSLSocket] ssl_socket
-  #   The temporary SSL Socket.
-  #
-  # @return [nil]
-  #
-  # @example
-  #   Net.ssl_session('twitter.com',443) do |sock|
-  #     sock.write("GET /\n\n")
-  #
-  #     sock.each_line { |line| puts line }
-  #   end
-  #
-  # @api public
-  #
-  def Net.ssl_session(host,port)
-    ssl_socket = Net.ssl_connect(host,port)
-
-    yield ssl_socket if block_given?
-
-    ssl_socket.close
-    return nil
-  end
+  extend Ronin::Network::SSL
 end