DEV Community: Gerrishon Sirere

Getting Started with webprobe

Gerrishon Sirere — Wed, 31 Aug 2022 08:46:19 +0000

webprobe

Nifty and sophisticated web path scanner

A sophisticated web path scanner designed for the most descerning bug bounty hunters.

This CLI brute forces directories and files in webservers.

Installation & Usage

Requirement: python 3.8 or higher

Install with PyPi: pip install webprobe

How to use

Some common examples on how to use webprobe.

💡 If you need to see a list of all options, just use the -h | --help argument.

To use multiple wordlists, you can separate your wordlists with commas. Example: wordlist1.txt,wordlist2.txt

Simple usage


webprobe -u https://example.com


webprobe -e php,html,js -u https://example.com

webprobe -e php,html,js -u https://exaple.com -w /path/to/wordlist

Pausing progress

You can pause the scanning progress with CTRL+C from here, you can save the progress (and continue later), skip the current target, or skip the current sub-directory.

Recursion

Brutforcing recursively can be achieved using -r or --recursive flag.

For example, if webprobe finds admin/, it will brute-force admin/* (* is where it brute forces).


webprobe -e php,html,js -u https://example.com -r

You can set the max recursion depth with --recursion-depth and status codes to recurse with --recursion-status


webprobe -e php,html,js -u https://example.com -r --recursion-depth 3 --recursion-status 200-39

You can brute force recursively all found paths, not just paths end with / using --force-recursive flag.
You can recursively brute-force all depths of a path (a/b/c => add a/, a/b/) using --deep-recursive flag.
If there are sub-directories that you do not want to brute-force recursively use --exclude-subdirs flag.


webprobe -e php,html,js -u https://example.com -r --exclude-subdirs image/,media/,css/

Threads

Thread number (-t | --threads) reflects the number of separated brute force processes. The bigger the thread number, the faster webprobe runs. By default, the number of threads is 25, but you can increase it if you want to speed up the progress.

However, the speed still depends on the response time of the server.

💡 keep the threads number within a reasonable range because it can cause DoS (Denial of Service).


webprobe -e php,htm,js,bak,zip,tgz,txt -u https://example.com -t 20

Filters

Use -i | --include-status and -x | --exclude-status flags to select allowed and not allowed response status-codes

For more advanced filters: --exclude-sizes, --exclude-texts, --exclude-regexps, --exclude-redirects and --exclude-response


webprobe  -e php,html,js -u https://example.com --exclude-sizes 1B,243KB


webprobe -e php,html,js -u https://example.com --exclude-texts "403 Forbidden"


webprobe -e php,html,js -u https://example.com --exclude-regexps "^Error$"


webprobe -e php,html,js -u https://example.com --exclude-redirects "https://(.*).okta.com/*"


webprobe -e php,html,js -u https://example.com --exclude-response /error.html

Scan sub-directories

You can scan a list of sub-directories with --subdirs flag.


webprobe -e php,html,js -u https://example.com --subdirs /,admin/,folder/

Proxies

Webprobe supports both SOCKS and HTTP proxy. You can enlist a proxy server or a list of proxy servers from a file.


webprobe -e php,html,js -u https://example.com --proxy 127.0.0.1:8080


webprobe -e php,html,js -u https://example.com --proxy socks5://10.10.0.1:8080


webprobe -e php,html,js -u https://example.com --proxylist proxyservers.txt

More example commands


cat urls.txt | python3 webprobe --stdin


webprobe -u https://example.com --max-time 360


webprobe -u https://example.com --auth admin:pass --auth-type basic


webprobe -u https://example.com --header-list rate-limit-bypasses.txt

Reports

Supported report formats are: simple, plain, json, xml, md, csv, html, sqlite

💡 We will be adding yaml soon

 webprobe -e php -l URLs.txt --format plain -o report.txt

 webprobe -e php -u https://example.com --format html -o example.json

License📑

This software is licensed under the MIT License. See the License file in the top distribution directory for the full license text.

Donate🎁

In order to for us to maintain this project and grow our community of contributors.
Donate

Code of Conduct

Code of Conduct is adapted from the Contributor Covenant, version 1.2.0 available at Code of Conduct

Getting Started with quo python

Gerrishon Sirere — Wed, 31 Aug 2022 08:39:49 +0000

Forever Scalable

Quo is a toolkit for writing Command-Line Interface(CLI) applications and a TUI (Text User Interface) framework for Python.

Quo is making headway towards composing speedy and orderly CLI and TUI applications while forestalling any disappointments brought about by the failure to execute a python application.
Simple to code, easy to learn, and does not come with needless baggage.

Compatibility

Quo works flawlessly with Linux, OSX, and Windows.
Quo requires Python 3.8 or later.

Features

[x] Support for Ansi, RGB and Hex color models
[x] Support for tabular presentation of data
[x] Intuitive progressbars
[x] Code completions
[x] Nesting of commands
[x] Customizable Text User Interface (TUI) dialogs.
[x] Automatic help page generation
[x] Syntax highlighting
[x] Autosuggestions
[x] Key Binders

Getting Started

Installation

You can install quo via the Python Package Index (PyPI)

pip install -U quo

In order to check your installation you can use

python -m pip show quo

Run the following to test Quo output on your terminal:

python -m quo

Quo Library

Quo contains a number of builtin features you c
an use to create elegant output in your CLI.

Quo echo

To output formatted text to your terminal you can import the echo method.
Try this:

Example 1

 from quo import echo

 echo("Hello, World!", fg="red", italic=True, bold=True)

Example 2

 from quo import echo

 echo("Quo is ", nl=False)
 echo("scalable", bg="red", fg="black")

Alternatively, you can import print

 from quo import print

 print('<b>This is bold</b>')
 print('<i>This is italic</i>')
 print('<u>This is underlined</u>')

 # Colors from the ANSI palette.
 print('<red>This is red</red>')
 print('<style fg="green" bg="red">Green on red background</stlye>')

Quo prompt

Using quo.prompt method.

 from quo import prompt

 prompt("What is your name?")

Using quo.prompt.Prompt object

Example 1

 from quo.prompt import Prompt

 session = Prompt()
 session.prompt("Type something:")

Example 2

Real time integer validator


 from quo.prompt import Prompt

 session = Prompt(int=True)
 number = int(session.prompt('Give a number: '))

Example 3

A prompt with a bottom toolbar


  from quo.prompt import Prompt
  from quo.text import Text

  def toolbar():
        return Text('This is a <b><style bg="red">Toolbar</style></b>!')

  # Returns a callable
  session = Prompt(bottom_toolbar=toolbar)
  session.prompt('> ')

Example 4

A placeholder text that's displayed as long as no input s given.

💡 This won't be returned as part of the output.


  from quo.prompt import Prompt
  from quo.text import Text

  session = Prompt(placeholder=Text('<gray>(please type something)</gray>'))
  session.prompt("What is your name?: ")

Example 5

Add colors to the prompt itself.


 from quo.color import Color
 from quo.prompt import Prompt

 style = Color("fg:red")
 session = Prompt(style=style)
 session.prompt("Type something: ")

Quo Console

For more control over quo terminal content, import and construct a Console object.

Bar

Draw a horizontal bar with an optional title, which is a good way of dividing your terminal output in to sections.


 from quo.console import Console

 console = Console()
 console.bar("I am a bar", style="fg:red bg:yellow")

Launching Applications

Quo supports launching applications through Console.launch

Example 1


 from quo.console import Console

 console = Console()
 console.launch("https://quo.rtfd.io/")

Example 2


 from quo.console import Console

 console = Console()
 console.launch("/home/path/README.md", locate=True)

Rule

Used for drawing a horizontal line.

Example 1


 from quo.console import Console

 console = Console()
 console.rule(

Example 2

A multicolored line.


 from quo.console import Console

 console = Console()
 console.rule(multicolored=True)

Spin🔁

Quo can create a context manager that is used to display a spinner on stdout as long as the context has not exited


 import time
 from quo.console import Console

 console = Console()

 with console.spin():
           time.sleep(3)
           print("Hello, World")

Quo Dialogs

High level API for displaying dialog boxes to the user for informational purposes, or to get input from the user.

Example 1

Message Box dialog


 from quo.dialog import MessageBox

 MessageBox(
       title="Message pop up window", 
       text="Do you want to continue?\nPress ENTER to quit."
              )

Example 2

Input Box dialog


 from quo.dialog import InputBox

 InputBox(
      title="InputBox shenanigans",
      text="What Country are you from? :"
        )

Quo Key Binding🔐

A key binding is an association between a physical key on akeyboard and a parameter.


 from quo import echo
 from quo.keys import bind
 from quo.prompt import Prompt

 session = Prompt()

 # Print "Hello world" when ctrl-h is pressed
 @bind.add("ctrl-h")
 def _(event):
      echo("Hello, World!")

 session.prompt("")

Quo Tables

This offers a number of configuration options to set the look and feel of the table, including how borders are rendered and the style and alignment of the columns.

Example 1


 from quo.table import Table

 data = [
     ["Name", "Gender", "Age"],
     ["Alice", "F", 24],
     ["Bob", "M", 19],
     ["Dave", "M", 24]
  ]

 Table(data)

Example 2

Right aligned table


 from quo.table import Table

 data = [
    ["Name", "Gender", "Age"],
    ["Alice", "F", 24],
    ["Bob", "M", 19],
    ["Dave", "M", 24]
    ]
 Table(data, align="right")

Example 3

Colored table


 from quo.table import Table

 data = [
    ["Name", "Gender", "Age"],
    ["Alice", "F", 24],
    ["Bob", "M", 19],
    ["Dave", "M", 24]

 Table(data, style="fg:green")

Example 4

Grid table


 from quo.table import Table

 data = [
    ["Name", "Gender", "Age"],
    ["Alice", "F", 24],
    ["Bob", "M", 19],
    ["Dave", "M", 24]
    ]

 Table(data, theme="grid")

Quo Widgets

A collection of reusable components for building full screen applications.

Frame 🎞️

Draw a border around any container, optionally with a title.


 from quo import container
 from quo.widget import Frame, Label

 content = Frame(
             Label("Hello, World!"),
               title="Quo: python")

 #Press Ctrl-C to exit
 container(content, bind=True, full_screen=True)

Label

Widget that displays the given text. It is not editable or focusable.

Example 1

This will occupy a minimum space in your terminal


 from quo import container
 from quo.widget import Label

 content = Label("Hello, World", style="fg:black bg:red")

 container(content)

Example 2

This will be a fullscreen application


 from quo import container
 from quo.widget import Label

 content = Label("Hello, World", style="fg:black bg:red")

 # Press Ctrl-C to exit
 container(content, bind=True, full_screen=True)

Example 3

Full screen application using a custom binding key.


 from quo import container
 from quo.keys import bind
 from quo.widget import Label

 content = Label("Hello, World", style="fg:black bg:red")

 #Press Ctrl-Z to exit
 @bind.add("ctrl-z")
 def _(event):
     event.app.exit()

 container(content, bind=True, full_screen=True)

`Autocompletion`

Press [Tab] to autocomplete


 from quo.prompt import Prompt
 from quo.completion import WordCompleter
 example = WordCompleter(['USA', 'UK', 'Canada', 'Kenya'])
 session = Prompt(completer=example)
 session.prompt('Which country are you from?: ')

`Autosuggestion`

Auto suggestion is a way to propose some input completions to the user. Usually, the input is compared to the history and when there is another entry starting with the given text, the completion will be shown as gray text behind the current input. Pressing the right arrow → or ctrl-e will insert this suggestion, alt-f willinsert the first word of the suggestion.


 from quo.history import MemoryHistory
 from quo.prompt import Prompt

 MemoryHistory.append("import os")
 MemoryHistory.append('print("hello")') 
 MemoryHistory.append('print("world")')  
 MemoryHistory.append("import path")

 session = Prompt(history=MemoryHistory, suggest="history")

 while True:
    session.prompt('&gt; ')

Donate🎁

In order to for us to maintain this project and grow our community of contributors.
Donate

Quo is...

Simple
If you know Python you can easily use quo and it can integrate with just about anything.

Getting Help

Community

For discussions about the usage, development, and the future of quo, please join our Google community

Community👨‍👩‍👦‍👦

Resources

Bug tracker

If you have any suggestions, bug reports, or annoyances please report them
to our issue tracker at
Bug tracker or send an email to:

📥 scalabli@googlegroups.com

Blogs💻

→ How to build CLIs using quo

License📑

This software is licensed under the MIT License. See the License file in the top distribution directory for the full license text.

Code of Conduct

Code of Conduct is adapted from the Contributor Covenant,
version 1.2.0 available at
Code of Conduct

Building beautiful CLIs using Quo

Gerrishon Sirere — Tue, 10 May 2022 00:00:00 +0000

Quo is a Python based toolkit for writing Command-Line Interface(CLI) applications. Quo is making headway towards composing speedy and orderly CLI applications while forestalling any disappointments brought about by the failure to execute a CLI API.

Quo is easy to learn, and does not come with needless baggage and contains a number of builtin features you can use to create elegant output in your CLI.

Compatibility

Quo works flawlessly with Linux, OSX, and Windows.
Quo requires Python 3.8 or later.

Features

[x] Support for Ansi, RGB and Hex color models
[x] Support for tabular presentation of data
[x] Intuitive progressbars
[x] Code completions
[x] Nesting of commands
[x] Customizable Text User Interface (TUI) dialogs.
[x] Automatic help page generation
[x] Syntax highlighting
[x] Autosuggestions
[x] Key Binders

Getting Started

Installation

You can install quo via the Python Package Index (PyPI)

pip install -U quo

Run the following to test Quo output on your terminal:

python -m quo

Printing

Quo echo

To output formatted text to your terminal you can import the echo method.
Try this:

Example 1

 from quo import echo

 echo(f"Hello, World!", fg="red", italic=True, bold=True))

Example 2

 from quo import echo

 echo("Quo is ", nl=False)
 echo("scalable", bg="red", fg="black")

Quo print

Alternatively, you can import print

from quo import print

print('<b>This is bold</b>')
print('<i>This is italic</i>')
print('<u>This is underlined</u>')                      
# Colors from the ANSI palette.
print('<red>This is red</red>')
print('<style fg="green" bg="red">Green on red background</stlye>')

Prompts

Quo prompt

Using quo.prompt method.

from quo import prompt

prompt("What is your name?")

Using quo.prompt.Prompt object

from quo.prompt import Prompt

session = Prompt()
session.prompt("Type something:")

`Launching Applications`

Quo supports launching applications through Console.launch. This can be used to open the default application associated with a URL or filetype.

from quo.console import Console

console = Console()
console.launch("https://quo.rtfd.io/")

Completions

Autocompletion

Press [Tab] to autocomplete

from quo.prompt import Prompt
from quo.completion import WordCompleter
example = WordCompleter(['USA', 'UK', 'Canada', 'Kenya'])
session = Prompt(completer=example)
session.prompt('Which country are you from?: ')

Autosuggestion

from quo.history import MemoryHistory
from quo.prompt import Prompt

MemoryHistory.append("import os")
MemoryHistory.append('print("hello")') 
MemoryHistory.append('print("world")')  
MemoryHistory.append("import path")

session = Prompt(history=MemoryHistory, suggest="history")

while True:
   session.prompt('> ')

Documenting Scripts

Quo automatically generates help pages for your command-line tools.

from quo import print
from quo.console import command
from quo.console import app

@command()
@app('--count', default=1, help='number of greetings')
@app('--name', prompt="What is your name?", help="The person to greet")

def hello(count: int, name: str):
    """This script prints hello NAME COUNT times."""
       for x in range(count):
           print(f"Hello {name}!")

if __name__ == "__main__":
          hello()

And what it looks like after executing:

python example.py --help

Progress

Creating a new progress bar can be done by calling the class ProgressBar
The progress can be displayed for any iterable. This works by wrapping the iterable (like range) with the class ProgressBar

import time
from quo.progress import ProgressBar

with ProgressBar() as pb:
              for i in pb(range(800)):
                            time.sleep(.01)

Key Binding

A key binding is an association between a physical key on a keyboard and a parameter.

from quo import echo
from quo.keys import bind
from quo.prompt import Prompt

session = Prompt() 
# Print "Hello world" when ctrl-h is pressed
@bind.add("ctrl-h")
def _(event):
    echo("Hello, World!")
session.prompt(">> ")

Dialogs

This is a high level API for displaying dialog boxes to the user for informational purposes, or get input from the user.

1) Example of a message box dialog.

from quo.dialog import MessageBox

MessageBox(
        title="Message pop up window",
        text="Do you want to continue?\nPress ENTER to quit.")

The above code produces the following output

2) Example of a prompt box dialog

from quo.dialog import InputBox

InputBox(
          title="InputBox shenanigans",
          text="What Country are you from?:")

Tables

Function Table offers a number of configuration options to set the look and feel of the table, including how borders are rendered and the style and alignment of the columns.

Example

from quo.table import Table

data = [
  ["Name", "Gender", "Age"],
  ["Alice", "F", 24],
  ["Bob", "M", 19],
  ["Dave", "M", 24]
]

Table(data)

Widgets

A collection of reusable components for building full screen applications.

Label

Widget that displays the given text. It is not editable or focusable.

from quo import container
from quo.widget import Label

content = Label("Hello, World", style="fg:black bg:red")

# Press `ctrl-c` to exit
container(content, bind=True, full_screen=True)

Making a Text User Interface (TUI) dialog from Quo Renderables

Gerrishon Sirere — Wed, 16 Feb 2022 15:01:31 +0000

Installation

Install from the command line

  pip install -U quo

Quo ships with a high level API for displaying dialog boxes to the user for informational purposes, or get input from the user.

`Message Box`

Use the quo.dialog.MessageBox function to display a
simple message box. For instance:

 from quo.dialog import MessageBox

 MessageBox(
    title='Example dialog window',
    text='Do you want to continue?\nPress ENTER to quit.')

Input Box`

Function quo.dialog.InputBox function can display an
input box. It will return the user input as a string.
python from quo.dialog import InputBox InputBox( title='Input dialog example', text='Please type your name:')

The hide=True option can be passed to the quo.dialog.InputBox function to turn this into a password input box.

`Confirmation Box`

Function quo.dialog.ConfirmBoxdisplays a yes/no
confirmation dialog. It will return a boolean according to the selection.
`python
from quo.dialog import ConfirmBox

ConfirmBox(
title='Yes/No dialog example',
text='Do you want to confirm?')
`

`Choice Box`

Function quo.dialog.ChoiceBox function displays a dialog
with choices offered as buttons. Buttons are indicated as a list of tuples, each providing the label (first) and return value if clicked (second).

`python
from quo.dialog import ChoiceBox

ChoiceBox(
title='Button dialog example',
text='Do you want to confirm?',
buttons=[
('Yes', True),
('No', False),
('Maybe...', None)
])
`

`Radiolist Box`

Function quo.dialog.RadiolistBox function displays a dialog
with choices offered as a radio list. The values are provided as a list of tuples,
each providing the return value (first element) and the displayed value (second element).
`python
from quo.dialog import RadiolistBox

RadiolistBox(
title="RadioList dialog",
text="Which breakfast would you like ?",
values=[
("breakfast1", "Eggs and beacon"),
("breakfast2", "French breakfast"),
("breakfast3", "Equestrian breakfast")
])
`

`Check Box`

Function quo.dialog.CheckBox has the same usage and purpose than the Radiolist dialog, but allows several values to be selected and therefore returned.
`python
from quo.dialog import CheckBox

CheckBox(
title="CheckboxList dialog",
text="What would you like in your breakfast ?",
values=[
("eggs", "Eggs"),
("bacon", "Bacon"),
("croissants", "20 Croissants"),
("daily", "The breakfast of the day")
])
`

Styling of dialogs

A custom class quo.style.Style instance can be passed to all
dialogs to override the default style. Also, text can be styled by passing a quo.text.Text object.

`python
from quo.dialog import MessageBox
from quo.style import Style
from quo.text import Text

example = Style.add({
'dialog': 'bg:#88ff88',
'dialog frame.label': 'bg:#ffffff fg:#000000',
'dialog.body': 'bg:#000000 fg:#00ff00',
'dialog shadow': 'bg:#00aa00' })
MessageBox(
title=Text('Styled '
'dialog window'),
text='Do you want to continue?\nPress ENTER to quit.',
style=example)
`

Build CLIs with quo

Gerrishon Sirere — Sun, 26 Dec 2021 07:48:42 +0000

Forever Scalable

Quo is a Python based toolkit for writing Command-Line Interface(CLI) applications.
Quo is making headway towards composing speedy and orderly CLI applications while forestalling any disappointments brought about by the failure to execute a CLI API.
Simple to code, easy to learn, and does not come with needless baggage.

Quo requires Python 3.8 or later.

Features

[x] Support for tabular presentation of data
[x] Interactive progressbars
[x] Code completions
[x] Nesting of commands
[x] Automatic help page generation
[x] Syntax highlighting
[x] Autosuggestions
[x] Key Binders

Getting Started

Installation

You can install quo via the Python Package Index (PyPI)

pip install -U quo

quo.echo

Example 1

   from quo import echo

   echo(f"Hello, World!", fg="red", italic=True, bold=True))

Example 2

   from quo import echo

   echo(f"Quo is ", nl=False)
   echo(f"scalable", bg="red", fg="black")

Unlike the builtin print function, echo function has improved support for handling Unicode and binary data.
It also supports handling of ANSI color sequences.

quo.prompt

   from quo import prompt

   prompt("What is your name?")

quo.Prompt

   from quo.prompt import Prompt

   session = Prompt(bottom_toolbar="Python 🐍 is great")
   session.prompt("Type something:")

Quo autocompletion

   # Press [Tab] to autocomplete
   from quo.prompt import Prompt
   from quo.completion import WordCompleter

   completer = WordCompleter(['USA', 'UK', 'Canada', 'Kenya'])
   session = Prompt(completer=completer)
   session.prompt('Which country are you from?: ')

Quo frame


   from quo import container
   from quo.widget import TextArea, Frame
   # Example of a simple layout
   content = TextArea("Hello world🌍")
   container(
        Frame(
            content,
            title="Quo: python🐍")
         )

Quo table

   from quo.table import Table


   data = [
     ["Name", "Gender", "Age"],
     ["Alice", "F", 24],
     ["Bob", "M", 19],
     ["Dave", "M", 24]
   ]

   Table(data)

For more intricate examples, have a look in the examples directory and the documentation.

Donate🎁

In order to for us to maintain this project and grow our community of contributors.
Donate

Quo is...

Simple
If you know Python you can easily use quo and it can integrate with just about anything.

Getting Help

Gitter

For discussions about the usage, development, and future of quo, please join our Gitter community

Join

Resources

Bug tracker

If you have any suggestions, bug reports, or annoyances please report them
to our issue tracker at
Bug tracker

License📑

This software is licensed under the MIT License. See the License file in the top distribution directory for the full license text.

Code of Conduct

Code of Conduct is adapted from the Contributor Covenant,
version 1.2.0 available at
Code of Conduct

Print in Italics using quo

Gerrishon Sirere — Thu, 05 Aug 2021 13:54:43 +0000

Printing in Italics made easy!!
Quo is a Python based toolkit for creating Command-Line Interface (CLI) applications.
You can install through PypI:
quo