Introduction

pathgro takes a brief list of path strings as input and "grows" them into much larger sets. It is a tool that freely commingles pathname pieces to generate new omnifarious string mappings. It is designed to maximize attack surface coverage when testing software components that take pathnames as input; the technique referred to as dirbusting as implemented by dirb is a good example of such testing which stands to benefit from path growing abilities. Such tactics exploit predictable resource location and are sometimes referred to as forced browsing pathgro has been coded as a set of GNU Guile modules that are wrapped in a command-line interface script.

Examples

General overview of the functionality:

Note that pathgro --Combos 1 and pathgro --Powerset 1 will generate equivalent lists according to their definitions.

Dependencies

Requirement

GNU Guile 2.x
- NOTE: you must make sure that you have both of the guile and guild executables installed.
  Some Linux distributions (e.g. Debian) provide guild separately from guile, so simply
  installing a package named guile with APT may not be sufficient.
  (Debian provides guild in a development package entitled guile-2.x-dev)

Optional

direnv

Installation

# 🚊 on Linux, install the required GNU Guile binaries
$ sudo apt install guile guile-2.0-dev

# 🍻 on macOS, install Homebrew according to its site at https://brew.sh 
# 🍺 on Linux, optionally install the Linux version of Homebrew which might maintain a newer version of GNU Guile
$ sudo apt install linuxbrew-wrapper 

# 🥂 install the GNU Guile package via the default [homebrew/core](https://github.com/Homebrew/homebrew-core "Default formulae for the missing package manager for macOS") tap 
$ brew install guile 

# 🖥️ on macOS, you can simply `brew install guile` after installing Homebrew from https://brew.sh
# 💻 on Linux, you may need to add `~/.linuxbrew/Cellar/guile/2.x.x/bin` to `PATH`

# 🌀 clone the source code repository
$ git clone https://github.com/decal/pathgro

# 📁 change working directory to pathgro
$ cd pathgro

# ⛵ compile the source using the Makefile
$ make

# ✈️ execute various tests using the Makefile
$ make test

# #️⃣ install pathgro using the Makefile
$ make install

# ⚓ append the above environment variable settings to the shell initialization file
$ cat ~/.pathgrorc >> ~/.bashrc

# 🥚 re-assign path environment variables for Guile and the current shell process
$ . .pathgrorc

# 📗 read the detailed program usage statement and refer to the table underneath the following screenshot
$ pathgro --help

# 🐅 That's it--you're done! Go get 'em tiger! Grow your pathname lists!

Usage

| Command Line Flag | Description of Grow Level |:-------------------------------------------|----------------------------------------------------------------------- | --Grow 0, -G0 | <details><summary>each command-line flag has a 50% chance of being enabled randomly</summary> --basename, --dirname, --extname, --filename, --generate, --macos, --saves, --vimswap, --xtdirname</details> | --Grow 1, -G1 | <details><summary>bases, extensions and full file names</summary> --basename, --extname, --filename</details> | --Grow 2, -G2 | <details><summary>file extensions as directories and standalone directories</summary> --dirname, --xtdirname</details> | --Grow 3, -G3 | <details><summary>bases, extensions, full file names, standalone directories and extensions as directories</summary> --basename, --extname, --filename, --dirname, --xtdirname</details> | --Grow 4, -G4 | <details><summary>auto-save and backup file names</summary> --macos, --saves</details> | --Grow 5, -G5 | <details><summary>vim swap file names, one-byte base name appendages and extensions</summary> --generate, --vimswap</details> | --Grow 6, -G6 | <details><summary>-G4 and -G5 togther</summary> --macos, --saves, --generate, --vimswap</details> | --Grow 7, -G7 | <details><summary>combinations of folders two levels deep with traversals of same depth</summary> --Combos 2, --Traverse 2</details> | --Grow 8, -G8 | <details><summary>enable each individual flag while passing the value 1 to each set operation</summary> --basename, --extname, --filename, --dirname, --xtdirname, --macos, --saves, --generate, --vimswap, --Combos, --Powerset, --Traverse</summary> --basename, --extname, --filename, --dirname, --xtdirname, --macos, --saves, --generate, --vimswap, --Combos, --Powerset, --Traverse</details>

Note that depending upon the command-line invocation's combined option flags, the results may still need to be uniqued by piping the output stream to sort -u.

Errors

ERROR: no code for module (pathgro main)

Don't forget to run make install and . ~/.pathgrorc before attempting to execute pathgro

Utilities

mortalis13 / List-Folders

Lists files and subfolders of a selected local directory

kdomasze / Folder-List

Lists all files and folders in a directory.

Listers

mgeeky / dirbuster

wfuzz, SecLists and john -based dirbusting / forceful browsing script intended to be used during web pentest assingments

DominikSchlecht / WordLGen

A program that combines given words.

sc0tfree / mentalist

Mentalist is a graphical tool for custom wordlist generation. It utilizes common human paradigms for constructing passwords and can output the full wordlist as well as rules compatible with Hashcat and John the Ripper.

BlackArch / wordlistctl

Fetch, install and search wordlist archives from websites and torrent peers.

[imkzh / webwordlist](https://gith

Pathgro

Install / Use

README