ronin-nmap 0.1.0.rc1

data/man/ronin-nmap.1.md

@@ -0,0 +1,57 @@
+# ronin-nmap 1 "2024-01-01" Ronin Nmap "User Manuals"
+
+## NAME
+
+ronin-nmap - A CLI for working with nmap
+
+## SYNOPSIS
+
+`ronin-nmap` [*options*] [*COMMAND* [...]]
+
+## DESCRIPTION
+
+`ronin-nmap` provides various commands for automating `nmap`, parsing
+XML output files, and importing scan data into the database.
+
+Runs a `ronin-nmap` *COMMAND*.
+
+## ARGUMENTS
+
+*COMMAND*
+: The `ronin-nmap` command to execute.
+
+## OPTIONS
+
+`-h`, `--help`
+: Print help information
+
+## COMMANDS
+
+*completion*
+: Manages the shell completion rules for `ronin-nmap`.
+
+*convert*
+: Converts an nmap XML file to JSON or CSV.
+
+*dump*
+: Dumps the targets from an nmap XML file.
+
+*import*
+: Imports an nmap XML file into ronin-db.
+
+*new*
+: Generates a new nmap Ruby script.
+
+*print*
+: Prints the scanned hosts from nmap XML file(s).
+
+*scan*
+: Runs nmap and outputs data as JSON or CSV or imports into the database.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-nmap-completion](ronin-nmap-completion.1.md) [ronin-nmap-convert](ronin-nmap-convert.1.md) [ronin-nmap-dump](ronin-nmap-dump.1.md) [ronin-nmap-import](ronin-nmap-import.1.md) [ronin-nmap-new](ronin-nmap-new.1.md) [ronin-nmap-scan](ronin-nmap-scan.1.md)

data/ronin-nmap.gemspec

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
+
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+                  require 'ronin/nmap/version'
+                  Ronin::Nmap::VERSION
+                end
+
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+  gem.metadata    = gemspec['metadata'] if gemspec['metadata']
+
+  glob = ->(patterns) { gem.files & Dir[*patterns] }
+
+  gem.files  = `git ls-files`.split($/)
+  gem.files  = glob[gemspec['files']] if gemspec['files']
+  gem.files += Array(gemspec['generated_files'])
+  # exclude test files from the packages gem
+  gem.files -= glob[gemspec['test_files'] || 'spec/{**/}*']
+
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
+  end
+
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
+
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
+
+  gem.requirements              = gemspec['requirements']
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
+
+  split = ->(string) { string.split(/,\s*/) }
+
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
+    end
+  end
+
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
+    end
+  end
+end

data/scripts/setup

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+
+#
+# Prints a log message.
+#
+function log()
+{
+	if [[ -t 1 ]]; then
+		echo -e "\x1b[1m\x1b[32m>>>\x1b[0m \x1b[1m$1\x1b[0m"
+	else
+		echo ">>> $1"
+	fi
+}
+
+#
+# Prints a warn message.
+#
+function warn()
+{
+	if [[ -t 1 ]]; then
+		echo -e "\x1b[1m\x1b[33m***\x1b[0m \x1b[1m$1\x1b[0m" >&2
+	else
+		echo "*** $1" >&2
+	fi
+}
+
+#
+# Prints an error message.
+#
+function error()
+{
+	if [[ -t 1 ]]; then
+		echo -e "\x1b[1m\x1b[31m!!!\x1b[0m \x1b[1m$1\x1b[0m" >&2
+	else
+		echo "!!! $1" >&2
+	fi
+}
+
+#
+# Prints an error message and exists with -1.
+#
+function fail()
+{
+	error "$@"
+	exit -1
+}
+
+#
+# Sets os_platform and os_arch.
+#
+function detect_os()
+{
+	os_platform="$(uname -s)"
+	os_arch="$(uname -m)"
+}
+
+#
+# Auto-detect the package manager.
+#
+function detect_package_manager()
+{
+	case "$os_platform" in
+		Linux)
+			if [[ -f /etc/redhat-release ]]; then
+				if   command -v dnf >/dev/null; then
+					package_manager="dnf"
+				elif command -v yum >/dev/null; then
+					package_manager="yum"
+				fi
+			elif [[ -f /etc/debian_version ]]; then
+				if command -v apt-get >/dev/null; then
+					package_manager="apt"
+				fi
+			elif [[ -f /etc/SuSE-release ]]; then
+				if command -v zypper >/dev/null; then
+					package_manager="zypper"
+				fi
+			elif [[ -f /etc/arch-release ]]; then
+				if command -v pacman >/dev/null; then
+					package_manager="pacman"
+				fi
+			elif [[ -f /etc/os-release ]]; then
+				if command -v pacman >/dev/null; then
+					package_manager="pacman"
+				elif command -v zypper >/dev/null; then
+					package_manager="zypper"
+				fi
+			elif [[ "$HOME" == *"com.termux"* ]]; then
+				package_manager="termux"
+			fi
+			;;
+		Darwin)
+			if   command -v brew >/dev/null; then
+				package_manager="brew"
+			elif command -v port >/dev/null; then
+				package_manager="port"
+			fi
+			;;
+		*BSD)
+			if command -v pkg >/dev/null; then
+				package_manager="pkg"
+			fi
+			;;
+	esac
+}
+
+#
+# Detects the system.
+#
+function detect_system()
+{
+	detect_os
+	detect_package_manager
+}
+
+#
+# Installs a list of package names using the detected package manager.
+#
+function install_packages()
+{
+	case "$package_manager" in
+		apt)	$sudo apt-get install -y "$@" || return $? ;;
+		dnf|yum)$sudo $package_manager install -y "$@" || return $?     ;;
+		port)   $sudo port install "$@" || return $?       ;;
+		pkg)	$sudo pkg install -y "$@" || return $?     ;;
+		brew)
+			local brew_owner="$(/usr/bin/stat -f %Su "$(command -v brew)")"
+			sudo -u "$brew_owner" brew install "$@" ||
+			sudo -u "$brew_owner" brew upgrade "$@" || return $?
+			;;
+		pacman)
+			local missing_pkgs=($(pacman -T "$@"))
+
+			if (( ${#missing_pkgs[@]} > 0 )); then
+				$sudo pacman -Sy --noconfirm "${missing_pkgs[@]}" || return $?
+			fi
+			;;
+		zypper) $sudo zypper -n in -l $* || return $? ;;
+		termux)	pkg install -y "$@" || return $? ;;
+		"")	warn "Could not determine Package Manager. Proceeding anyway." ;;
+	esac
+}
+
+if ! command -v nmap >/dev/null; then
+	detect_system
+
+	log "Installing nmap ..."
+	install_packages nmap || warn "Could not install nmap. Proceeding anyways ..."
+fi
+
+# default to installing gems into vendor/bundle
+if [[ ! -f .bundle/config ]]; then
+	bundle config set --local path vendor/bundle >/dev/null || \
+	  fail "Failed to run 'bundle config'"
+fi
+
+log "Installing gems ..."
+bundle install || fail "Failed to run 'bundle install'!"
+
+log "Setting up the project ..."
+bundle exec rake setup || "Failed to run 'rake setup'!"

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: ronin-nmap
+version: !ruby/object:Gem::Version
+  version: 0.1.0.rc1
+platform: ruby
+authors:
+- Postmodern
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby-nmap
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: ronin-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.rc1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.rc1
+- !ruby/object:Gem::Dependency
+  name: ronin-db
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.rc1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.rc1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: |
+  ronin-nmap is a Ruby library for working with nmap. ronin-nmap can parse
+  nmap XML, convert nmap XML into JSON or CSV, or import nmap XML into the
+  ronin-db database.
+email: postmodern.mod3@gmail.com
+executables:
+- ronin-nmap
+extensions: []
+extra_rdoc_files:
+- COPYING.txt
+- ChangeLog.md
+- README.md
+files:
+- ".document"
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".yardopts"
+- COPYING.txt
+- ChangeLog.md
+- Gemfile
+- README.md
+- Rakefile
+- bin/ronin-nmap
+- data/completions/ronin-nmap
+- data/templates/script.rb.erb
+- gemspec.yml
+- lib/ronin/nmap.rb
+- lib/ronin/nmap/cli.rb
+- lib/ronin/nmap/cli/command.rb
+- lib/ronin/nmap/cli/commands/completion.rb
+- lib/ronin/nmap/cli/commands/convert.rb
+- lib/ronin/nmap/cli/commands/dump.rb
+- lib/ronin/nmap/cli/commands/grep.rb
+- lib/ronin/nmap/cli/commands/import.rb
+- lib/ronin/nmap/cli/commands/new.rb
+- lib/ronin/nmap/cli/commands/print.rb
+- lib/ronin/nmap/cli/commands/scan.rb
+- lib/ronin/nmap/cli/filtering_options.rb
+- lib/ronin/nmap/cli/importable.rb
+- lib/ronin/nmap/cli/port_list.rb
+- lib/ronin/nmap/converter.rb
+- lib/ronin/nmap/converters.rb
+- lib/ronin/nmap/converters/csv.rb
+- lib/ronin/nmap/converters/json.rb
+- lib/ronin/nmap/exceptions.rb
+- lib/ronin/nmap/importer.rb
+- lib/ronin/nmap/root.rb
+- lib/ronin/nmap/version.rb
+- man/ronin-nmap-completion.1
+- man/ronin-nmap-completion.1.md
+- man/ronin-nmap-convert.1
+- man/ronin-nmap-convert.1.md
+- man/ronin-nmap-dump.1
+- man/ronin-nmap-dump.1.md
+- man/ronin-nmap-grep.1
+- man/ronin-nmap-grep.1.md
+- man/ronin-nmap-import.1
+- man/ronin-nmap-import.1.md
+- man/ronin-nmap-new.1
+- man/ronin-nmap-new.1.md
+- man/ronin-nmap-print.1
+- man/ronin-nmap-print.1.md
+- man/ronin-nmap-scan.1
+- man/ronin-nmap-scan.1.md
+- man/ronin-nmap.1
+- man/ronin-nmap.1.md
+- ronin-nmap.gemspec
+- scripts/setup
+homepage: https://ronin-rb.dev/
+licenses:
+- LGPL-3.0
+metadata:
+  documentation_uri: https://ronin-rb.dev/docs/ronin-nmap
+  source_code_uri: https://github.com/ronin-rb/ronin-nmap
+  bug_tracker_uri: https://github.com/ronin-rb/ronin-nmap/issues
+  changelog_uri: https://github.com/ronin-rb/ronin-nmap/blob/main/ChangeLog.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.27
+signing_key:
+specification_version: 4
+summary: A Ruby library and CLI for working with nmap.
+test_files: []