ronin-support icon indicating copy to clipboard operation
ronin-support copied to clipboard

A support library for Ronin. Like activesupport, but for hacking!

ronin-support

CI Code Climate

Description

ronin-support is a support library for ronin-rb. ronin-support contains many of the convenience methods used by Ronin and additional libraries.

It's like activesupport, but for hacking!

ronin-rb is a Ruby platform for exploit development and security research. Ronin allows for the rapid development and distribution of code, exploits or payloads over many common Source-Code-Management (SCM) systems.

Features

  • Provides convenience methods for:
    • Formatting data:
      • Binary
        • Structs
      • Text
      • URIs
      • HTTP
      • HTML
      • JavaScript
      • SQL
    • Fuzzing
      • Generating
      • Mutating
    • Networking:
      • DNS
      • UNIX
      • TCP
      • UDP
      • SSL
      • FTP
      • SMTP / ESMTP
      • POP3
      • Imap
      • Telnet
      • HTTP / HTTPS
    • Enumerating IP ranges:
      • IPv4 / IPv6 addresses.
      • CIDR / globbed ranges.
    • (Un-)Hexdumping data.
    • Handling exceptions.
  • Provides Modules/Classes for:
    • Paths
    • Fuzzing
    • Wordlists
    • Erb Templates
    • UI:
      • Terminal Output
      • Custom Shells

Examples

For examples of the convenience methods provided by ronin-support, please see Everyday Ronin.

Requirements

Install

$ gem install ronin-support

Gemfile

gem 'ronin-support', '~> 0.5'

Development

  1. Fork It!
  2. Clone It!
  3. cd ronin-support
  4. bundle install
  5. git checkout -b my_feature
  6. Code It!
  7. bundle exec rake spec
  8. git push origin my_feature

License

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/.