RubyGems - ronin-db - Versions diffs - 0.1.0.beta1 - Mend

ronin-db 0.1.0.beta1

Files changed (74) hide show

checksums.yaml +7 -0
data/.document +5 -0
data/.github/workflows/ruby.yml +31 -0
data/.gitignore +13 -0
data/.rspec +1 -0
data/.ruby-version +1 -0
data/.yardopts +1 -0
data/COPYING.txt +165 -0
data/ChangeLog.md +12 -0
data/Gemfile +39 -0
data/README.md +272 -0
data/Rakefile +76 -0
data/bin/ronin-db +35 -0
data/gemspec.yml +46 -0
data/lib/ronin/db/cli/command.rb +37 -0
data/lib/ronin/db/cli/commands/add.rb +206 -0
data/lib/ronin/db/cli/commands/asn.rb +218 -0
data/lib/ronin/db/cli/commands/creds.rb +80 -0
data/lib/ronin/db/cli/commands/edit.rb +58 -0
data/lib/ronin/db/cli/commands/emails.rb +90 -0
data/lib/ronin/db/cli/commands/hosts.rb +100 -0
data/lib/ronin/db/cli/commands/ips.rb +100 -0
data/lib/ronin/db/cli/commands/irb.rb +81 -0
data/lib/ronin/db/cli/commands/list.rb +124 -0
data/lib/ronin/db/cli/commands/migrate.rb +75 -0
data/lib/ronin/db/cli/commands/remove.rb +69 -0
data/lib/ronin/db/cli/commands/urls.rb +170 -0
data/lib/ronin/db/cli/database_command.rb +71 -0
data/lib/ronin/db/cli/model_command.rb +202 -0
data/lib/ronin/db/cli/modifiable.rb +141 -0
data/lib/ronin/db/cli/resources_command.rb +120 -0
data/lib/ronin/db/cli/ruby_shell.rb +51 -0
data/lib/ronin/db/cli/uri_methods.rb +97 -0
data/lib/ronin/db/cli.rb +38 -0
data/lib/ronin/db/config_file.rb +132 -0
data/lib/ronin/db/exceptions.rb +26 -0
data/lib/ronin/db/home.rb +36 -0
data/lib/ronin/db/root.rb +28 -0
data/lib/ronin/db/version.rb +26 -0
data/lib/ronin/db.rb +123 -0
data/man/ronin-db-add.1 +99 -0
data/man/ronin-db-add.1.md +75 -0
data/man/ronin-db-asn.1 +79 -0
data/man/ronin-db-asn.1.md +59 -0
data/man/ronin-db-creds.1 +78 -0
data/man/ronin-db-creds.1.md +58 -0
data/man/ronin-db-edit.1 +48 -0
data/man/ronin-db-edit.1.md +36 -0
data/man/ronin-db-emails.1 +82 -0
data/man/ronin-db-emails.1.md +61 -0
data/man/ronin-db-hosts.1 +86 -0
data/man/ronin-db-hosts.1.md +64 -0
data/man/ronin-db-ips.1 +90 -0
data/man/ronin-db-ips.1.md +67 -0
data/man/ronin-db-irb.1 +61 -0
data/man/ronin-db-irb.1.md +46 -0
data/man/ronin-db-list.1 +58 -0
data/man/ronin-db-list.1.md +44 -0
data/man/ronin-db-migrate.1 +44 -0
data/man/ronin-db-migrate.1.md +32 -0
data/man/ronin-db-remove.1 +55 -0
data/man/ronin-db-remove.1.md +42 -0
data/man/ronin-db-urls.1 +98 -0
data/man/ronin-db-urls.1.md +73 -0
data/ronin-db.gemspec +78 -0
data/spec/cli/commands/add_spec.rb +220 -0
data/spec/cli/commands/edit_spec.rb +12 -0
data/spec/cli/commands/irb_spec.rb +26 -0
data/spec/cli/database_command_spec.rb +53 -0
data/spec/cli/model_command_spec.rb +237 -0
data/spec/cli/ruby_shell_spec.rb +14 -0
data/spec/cli/uri_methods_spec.rb +190 -0
data/spec/spec_helper.rb +15 -0
metadata +200 -0

data/man/ronin-db-hosts.1.md ADDED Viewed

@@ -0,0 +1,64 @@
+# ronin-db-hosts 1 "April 2012" Ronin "User Manuals"
+## SYNOPSIS
+`ronin-db hosts` [*options*]
+## DESCRIPTION
+Manages host names.
+## OPTIONS
+`--db` *NAME*
+  The database to connect to. Defaults to `default` if not given.
+`--db-uri` *URI*
+  The explicit database URI to connect to
+  (ex: `mysql://user:password@host/ronin`).
+`-v`, `--verbose`
+	Enable verbose output.
+`--add` *USER*:*PASSWORD*
+  Adds the *USER* and *PASSWORD* to the database.
+`--import` *FILE*
+  Imports the credentials from the given *FILE*.
+`--delete` *VALUE*
+  Deletes a value from the database.
+`--delete-all`
+  Deletes every value from the database.
+`-I`, `--with-ip` *IP*
+	Searches for HostNames associated with the IP address.
+`-p`, `--with-port` *PORT*
+	Searches for HostNames associated with the *PORT*.
+`-D`, `--domain` *DOMAIN*
+	Searches for HostNames belonging to the DOMAIN (`co.uk`).
+`-T`, `--tld` *TLD*
+	Searches for HostNames with the Top-Level-Domain (TLD) (`ru`).
+## FILES
+*~/.ronin/*
+	Ronin configuration directory.
+*~/.ronin/database.log*
+	Database log.
+*~/.ronin/database.sqlite3*
+	The default sqlite3 Database file.
+*~/.ronin/database.yml*
+	Optional Database configuration.
+## AUTHOR
+Postmodern <postmodern.mod3@gmail.com>

data/man/ronin-db-ips.1 ADDED Viewed

@@ -0,0 +1,90 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-db-ips 1 "April 2012" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin-db ips\fR \[lB]\fIoptions\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Manages IP addresses\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB--db\fR \fINAME\fP
+The database to connect to\. Defaults to \fBdefault\fR if not given\.
+.LP
+.TP
+\fB--db-uri\fR \fIURI\fP
+The explicit database URI to connect to
+(ex: \fBmysql://user:password@host/ronin\fR)\.
+.LP
+.TP
+\fB-v\fR, \fB--verbose\fR
+Enable verbose output\.
+.LP
+.TP
+\fB--add\fR \fIUSER\fP:\fIPASSWORD\fP
+Adds the \fIUSER\fP and \fIPASSWORD\fP to the database\.
+.LP
+.TP
+\fB--import\fR \fIFILE\fP
+Imports the credentials from the given \fIFILE\fP\.
+.LP
+.TP
+\fB--delete\fR \fIVALUE\fP
+Deletes a value from the database\.
+.LP
+.TP
+\fB--delete-all\fR
+Deletes every value from the database\.
+.LP
+.TP
+\fB-4\fR, \fB--v4\fR
+Searches for IPv4 addresses\.
+.LP
+.TP
+\fB-6\fR, \fB--v6\fR
+Searches for IPv6 addresses\.
+.LP
+.TP
+\fB-p\fR, \fB--with-port\fR \fIPORT\fP
+Searches for IP addresses associated with the user \fIPORT\fP\.
+.LP
+.TP
+\fB-I\fR, \fB--with-mac-addr\fR \fIMAC\fP
+Searches for IP addresses associated with the MAC address\.
+.LP
+.TP
+\fB-I\fR, \fB--with-host\fR \fIHOST\fP
+Searches for IP addresses associated with the \fIHOST\fP\.
+.LP
+.SH FILES
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]\fP
+Ronin configuration directory\.
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]database\.log\fP
+Database log\.
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]database\.sqlite3\fP
+The default sqlite3 Database file\.
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]database\.yml\fP
+Optional Database configuration\.
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP

data/man/ronin-db-ips.1.md ADDED Viewed

@@ -0,0 +1,67 @@
+# ronin-db-ips 1 "April 2012" Ronin "User Manuals"
+## SYNOPSIS
+`ronin-db ips` [*options*]
+## DESCRIPTION
+Manages IP addresses.
+## OPTIONS
+`--db` *NAME*
+  The database to connect to. Defaults to `default` if not given.
+`--db-uri` *URI*
+  The explicit database URI to connect to
+  (ex: `mysql://user:password@host/ronin`).
+`-v`, `--verbose`
+	Enable verbose output.
+`--add` *USER*:*PASSWORD*
+  Adds the *USER* and *PASSWORD* to the database.
+`--import` *FILE*
+  Imports the credentials from the given *FILE*.
+`--delete` *VALUE*
+  Deletes a value from the database.
+`--delete-all`
+  Deletes every value from the database.
+`-4`, `--v4`
+	Searches for IPv4 addresses.
+`-6`, `--v6`
+	Searches for IPv6 addresses.
+`-p`, `--with-port` *PORT*
+	Searches for IP addresses associated with the user *PORT*.
+`-I`, `--with-mac-addr` *MAC*
+	Searches for IP addresses associated with the MAC address.
+`-I`, `--with-host` *HOST*
+	Searches for IP addresses associated with the *HOST*.
+## FILES
+*~/.ronin/*
+	Ronin configuration directory.
+*~/.ronin/database.log*
+	Database log.
+*~/.ronin/database.sqlite3*
+	The default sqlite3 Database file.
+*~/.ronin/database.yml*
+	Optional Database configuration.
+## AUTHOR
+Postmodern <postmodern.mod3@gmail.com>

data/man/ronin-db-irb.1 ADDED Viewed

@@ -0,0 +1,61 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-db-irb 1 "2022-01-01" Ronin DB "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin-db irb\fR \[lB]\fIoptions\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Connects to a database and start an interactive Ruby shell\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB--db\fR \fINAME\fP
+The database to connect to\. Will connect to the \fBdefault\fR database if not
+specified\.
+.LP
+.TP
+\fB--db-uri\fR \fIURI\fP
+The database URI to connect to\.
+.LP
+.TP
+\fB--no-connect\fR
+Causes the Ruby shell to not connect to a database on startup\.
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH FILES
+.LP
+.TP
+\fI\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fP
+The \fBronin-db\fR database(s) configuration file\.
+.LP
+.SH ENVIRONMENT
+.LP
+.PP
+HOME
+Specifies the home directory of the user\. Ronin will search for the
+\fI\[ti]\[sl]\.config\[sl]ronin\-db\fP cache directory within the home directory\.
+.LP
+.PP
+XDG\[ru]CONFIG\[ru]HOME
+Specifies the cache directory to use\. Defaults to \fI\[Do]HOME\[sl]\.config\fP\.
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-db(1)

data/man/ronin-db-irb.1.md ADDED Viewed

@@ -0,0 +1,46 @@
+# ronin-db-irb 1 "2022-01-01" Ronin DB "User Manuals"
+## SYNOPSIS
+`ronin-db irb` [*options*]
+## DESCRIPTION
+Connects to a database and start an interactive Ruby shell.
+## OPTIONS
+`--db` *NAME*
+  The database to connect to. Will connect to the `default` database if not
+  specified.
+`--db-uri` *URI*
+  The database URI to connect to.
+`--no-connect`
+  Causes the Ruby shell to not connect to a database on startup.
+`-h`, `--help`
+  Print help information.
+## FILES
+*~/.config/ronin-db/database.yml*
+	The `ronin-db` database(s) configuration file.
+## ENVIRONMENT
+HOME
+	Specifies the home directory of the user. Ronin will search for the
+	*~/.config/ronin-db* cache directory within the home directory.
+XDG_CONFIG_HOME
+  Specifies the cache directory to use. Defaults to *$HOME/.config*.
+## AUTHOR
+Postmodern <postmodern.mod3@gmail.com>
+## SEE ALSO
+ronin-db(1)

data/man/ronin-db-list.1 ADDED Viewed

@@ -0,0 +1,58 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-db-list 1 "2022-01-01" Ronin DB "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin-db list\fR \[lB]\fIoptions\fP\[rB] \[lB]\fINAME\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Lists entries in the \fB~/.config/ronin-db/database.yml\fR configuration file\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fINAME\fP
+The optional database name to print configuration information for\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-v\fR, \fB--verbose\fR
+Enables verbose output\.
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH FILES
+.LP
+.TP
+\fI\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fP
+The \fBronin-db\fR database(s) configuration file\.
+.LP
+.SH ENVIRONMENT
+.LP
+.PP
+HOME
+Specifies the home directory of the user\. Ronin will search for the
+\fI\[ti]\[sl]\.config\[sl]ronin\-db\fP cache directory within the home directory\.
+.LP
+.PP
+XDG\[ru]CONFIG\[ru]HOME
+Specifies the cache directory to use\. Defaults to \fI\[Do]HOME\[sl]\.config\fP\.
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-db(1) ronin\-db\-add(1) ronin\-db\-edit(1) ronin\-db\-remove(1)

data/man/ronin-db-list.1.md ADDED Viewed

@@ -0,0 +1,44 @@
+# ronin-db-list 1 "2022-01-01" Ronin DB "User Manuals"
+## SYNOPSIS
+`ronin-db list` [*options*] [*NAME*]
+## DESCRIPTION
+Lists entries in the `~/.config/ronin-db/database.yml` configuration file.
+## ARGUMENTS
+*NAME*
+  The optional database name to print configuration information for.
+## OPTIONS
+`-v`, `--verbose`
+  Enables verbose output.
+`-h`, `--help`
+  Print help information.
+## FILES
+*~/.config/ronin-db/database.yml*
+	The `ronin-db` database(s) configuration file.
+## ENVIRONMENT
+HOME
+	Specifies the home directory of the user. Ronin will search for the
+	*~/.config/ronin-db* cache directory within the home directory.
+XDG_CONFIG_HOME
+  Specifies the cache directory to use. Defaults to *$HOME/.config*.
+## AUTHOR
+Postmodern <postmodern.mod3@gmail.com>
+## SEE ALSO
+ronin-db(1) ronin-db-add(1) ronin-db-edit(1) ronin-db-remove(1)

data/man/ronin-db-migrate.1 ADDED Viewed

@@ -0,0 +1,44 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-db-migrate 1 "2022-01-01" Ronin DB "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin-db migrate\fR \[lB]\fIoptions\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Runs database migrations\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB--db\fR \fINAME\fP
+The database to connect to\. Will connect to the \fBdefault\fR database if not
+specified\.
+.LP
+.TP
+\fB--db-uri\fR \fIURI\fP
+The database URI to connect to\.
+.LP
+.TP
+\fB--no-connect\fR
+Causes the Ruby shell to not connect to a database on startup\.
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-db\-add(1)

data/man/ronin-db-migrate.1.md ADDED Viewed

@@ -0,0 +1,32 @@
+# ronin-db-migrate 1 "2022-01-01" Ronin DB "User Manuals"
+## SYNOPSIS
+`ronin-db migrate` [*options*]
+## DESCRIPTION
+Runs database migrations.
+## OPTIONS
+`--db` *NAME*
+  The database to connect to. Will connect to the `default` database if not
+  specified.
+`--db-uri` *URI*
+  The database URI to connect to.
+`--no-connect`
+  Causes the Ruby shell to not connect to a database on startup.
+`-h`, `--help`
+  Print help information.
+## AUTHOR
+Postmodern <postmodern.mod3@gmail.com>
+## SEE ALSO
+ronin-db-add(1)

data/man/ronin-db-remove.1 ADDED Viewed

@@ -0,0 +1,55 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-db-remove 1 "2022-01-01" Ronin DB "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin-db remove\fR \[lB]\fIoptions\fP\[rB] \fINAME\fP
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Removes a database entry from the \fB~/.config/ronin-db/database.yml\fR
+configuration file\.
+.LP
+.SH ARGUMENTS
+.LP
+.TP
+\fINAME\fP
+The database entry to remove\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information\.
+.LP
+.SH FILES
+.LP
+.TP
+\fI\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fP
+The \fBronin-db\fR database(s) configuration file\.
+.LP
+.SH ENVIRONMENT
+.LP
+.PP
+HOME
+Specifies the home directory of the user\. Ronin will search for the
+\fI\[ti]\[sl]\.config\[sl]ronin\-db\fP cache directory within the home directory\.
+.LP
+.PP
+XDG\[ru]CONFIG\[ru]HOME
+Specifies the cache directory to use\. Defaults to \fI\[Do]HOME\[sl]\.config\fP\.
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP
+.SH SEE ALSO
+.LP
+.PP
+ronin\-db(1) ronin\-db\-add(1) ronin\-db\-list(1) ronin\-db\-edit(1)

data/man/ronin-db-remove.1.md ADDED Viewed

@@ -0,0 +1,42 @@
+# ronin-db-remove 1 "2022-01-01" Ronin DB "User Manuals"
+## SYNOPSIS
+`ronin-db remove` [*options*] *NAME*
+## DESCRIPTION
+Removes a database entry from the `~/.config/ronin-db/database.yml`
+configuration file.
+## ARGUMENTS
+*NAME*
+  The database entry to remove.
+## OPTIONS
+`-h`, `--help`
+  Print help information.
+## FILES
+*~/.config/ronin-db/database.yml*
+	The `ronin-db` database(s) configuration file.
+## ENVIRONMENT
+HOME
+	Specifies the home directory of the user. Ronin will search for the
+	*~/.config/ronin-db* cache directory within the home directory.
+XDG_CONFIG_HOME
+  Specifies the cache directory to use. Defaults to *$HOME/.config*.
+## AUTHOR
+Postmodern <postmodern.mod3@gmail.com>
+## SEE ALSO
+ronin-db(1) ronin-db-add(1) ronin-db-list(1) ronin-db-edit(1)

data/man/ronin-db-urls.1 ADDED Viewed

@@ -0,0 +1,98 @@
+.\" Generated by kramdown-man 0.1.8
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-db-urls 1 "April 2012" Ronin "User Manuals"
+.LP
+.SH SYNOPSIS
+.LP
+.HP
+\fBronin-db urls\fR \[lB]\fIoptions\fP\[rB]
+.LP
+.SH DESCRIPTION
+.LP
+.PP
+Manages URLs\.
+.LP
+.SH OPTIONS
+.LP
+.TP
+\fB--db\fR \fINAME\fP
+The database to connect to\. Defaults to \fBdefault\fR if not given\.
+.LP
+.TP
+\fB--db-uri\fR \fIURI\fP
+The explicit database URI to connect to
+(ex: \fBmysql://user:password@host/ronin\fR)\.
+.LP
+.TP
+\fB-v\fR, \fB--verbose\fR
+Enable verbose output\.
+.LP
+.TP
+\fB--add\fR \fIUSER\fP:\fIPASSWORD\fP
+Adds the \fIUSER\fP and \fIPASSWORD\fP to the database\.
+.LP
+.TP
+\fB--import\fR \fIFILE\fP
+Imports the credentials from the given \fIFILE\fP\.
+.LP
+.TP
+\fB--delete\fR \fIVALUE\fP
+Deletes a value from the database\.
+.LP
+.TP
+\fB--delete-all\fR
+Deletes every value from the database\.
+.LP
+.TP
+\fB--http\fR
+Searches for \fBhttp://\fR URLs\.
+.LP
+.TP
+\fB--https\fR
+Searches for \fBhttps://\fR URLs\.
+.LP
+.TP
+\fB-H\fR, \fB--host\fR \fIHOST\fP
+Searches for URLs with the given \fIHOST\fP\.
+.LP
+.TP
+\fB-p\fR, \fB--with-port\fR \fIPORT\fP
+Searches for URLs associated with the \fIPORT\fP\.
+.LP
+.TP
+\fB-d\fR, \fB--directory\fR \fIDIRECTORY\fP
+Searches for URLs sharing the DIRECTORY\.
+.LP
+.HP
+\fB-q\fR, \fB--with-query-param\fR \fINAME\fP \[lB]\.\.\.\[rB]
+Searches for URLs containing the query\-param NAME\.
+.LP
+.HP
+\fB-Q\fR, \fB--with-query-value\fR \fIVALUE\fP \[lB]\.\.\.\[rB]
+Searches for URLs containing the query\-param VALUE\.
+.LP
+.SH FILES
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]\fP
+Ronin configuration directory\.
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]database\.log\fP
+Database log\.
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]database\.sqlite3\fP
+The default sqlite3 Database file\.
+.LP
+.TP
+\fI\[ti]\[sl]\.ronin\[sl]database\.yml\fP
+Optional Database configuration\.
+.LP
+.SH AUTHOR
+.LP
+.PP
+Postmodern
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.LP