Wait for all work to complete. Depending on your Finder and Target, this may take some time, and may time out before completion. Aft

Get a configuration value with a default. If a value was specified under the `DEFAULT` section, it will be returned before the defaul

Register arbitrary data results with the manager

Perform a test with the given configuration, target and flag :param config: Katana configuration file :type config: str :par

Register an artifact result with the manager

same as get but returns an integer value

Search arbitrary data for flags matching the given flag format in the manager configuration

Create a target, enumerate units, queue them, and return the target object

Generate a new artifact, and return the path and open file handle. The artifact is not automatically registered with the manager, since it

By default, we assume the unit name is the same as the containing module. This can be overridden, but should not conflict with other units.

This function will parse out a Python value regardless of the representation a number is given in the provided string. It will detect hex

Match the given target to one or more units that have previously been enumerated with the ``Finder.find`` method. This tests that the

Perform an API request to the specified endpoint :param endpoint: the endpoint to query (e.g. /user/login) :param args: Argum

Find the output directory for this unit. This will return the directory where artifacts are expected to be stored in this context and also e

Start the needed threads and begin evaluation of units. You can still add units to the queue for evaluation after start is called up

Setup the unit. The constructor should evaluate the target and make sure it makes sense to run. If the provided target does not make

Checks if the magic type is in a list of known interesting file types

Send work items with high priority to signal closing down threads

Part of the Git Dumper procedure. Process tasks in parallel.

Part of the Git Dumper procedure. Create intermediate directories, if necessary

This function actually runs the provided Brainfuck operations and returns the standard output. :param code: The code to run as Brainfuck

Locate units which conform to the Katana unit specification with the given directory. All python source file within the directory will

Returns true if either this unit or the origin target has completed

This is called upon completion of evaluation (after manager.join() is complete). `timed_out` indicates if we reached a timeout.

Notify the monitor that an exception occurred while processing a given unit. The exception is passed as the `exc` parameter

This function is used as part of Malbolge's operations.

Parse the result of a challenge/problem request (either from /problem or from a specific problem) :param result: The result dictionar

This function is used as part of Malbolge's operations.

This is a convenience function to decode a binary sequence. :param binary_sequence: A string of 1's and 0's. :return: The converted dat

Part of the Git Dumper procedure. Return all the files in the directory index webpage.

Part of the Git Dumper procedure. Return all the referenced SHA1 in the given object file

Return True if the response is a HTML webpage

This function is used as part of Malbolge's operations.

Notify the monitor that an artifact was found and may be of interest to store in a file. This may be a temporary file already open (w

Called at most once per second while downloading files for targets

Notify the monitor that a flag was found

Keep track of the thread statuses for asynchronous status updates

Queue the given unit to be evaluated. This will add the unit to the queue given it's prioritization, and the unit will be evaluated once

Register a flag that was found during processing and raise the FoundFlag exception.

Remove a unit for tracking. Also sets completed if all units are done.

This is a convenience function that will perform the most primitive operation of the Caesar Cipher -- shifting one character by a given a

This is a convenience function that will perform the most primitive operation of the Caesar Cipher -- shifting one character by a given a

Build a new target in the context of this manager

Updates the prompt with the current state

Authenticate with the remote CTF instance. Raise AuthenticationError on failure. :param username: A valid username :

Get the list of solves for this user :return: List of challenges we have solved

Prepare the results directory to house all artifacts and results from this run of katana. This is automatically called when `start` is

Signal completion to all threads, then wait for exit

Add a unit for tracking. This is called by Manager.queue

Perform the affine cipher for a single letter. :c: An integer value for the given letter (its location within the alphabet) :a: An in

Run tesseract against an image file and return the string found :param image_path: The path to an image file. :return: The string deter

This is used for the Cow operations. It will match opening and closing braces for use within the Cow program. :param code: A byte string

This method does the resource intensive part of building the target. It is done in a separate thread to decrease the time to return from the

This is used for the Brainfuck operations. It will match opening and closing braces for use within the Brainfuck program. :param code: A

Checks recursion rules and returns whether or not recursion is allowed into the given unit class. This unit has already been matched

The default dependency check will make sure that every item in self.DEPENDENCIES exists as an external executable in the current

This is used for the Cow operations. It will clean the provided code to only find the appropriate Cow operators. :param code: A byte str

This function is used for the Weiner's Little D attack. Converts a finite continued fraction ``[a0, ..., an]`` to an x/y rational.

This function is used for the Weiner's Little D attack. Computes the list of convergents using the list of partial quotients :param fra

This function is used as part of Malbolge's operations.

This function is used as part of Malbolge's operations.

This is stolen from https://github.com/rallip/substituteBreaker All it does is use the ``requests`` module to send the ciphertext to quip

Stolen from https://github.com/tothi/railfence. This is a convenience function to decrypt data with the Railfence cipher. :param ci

Shamelessly stolen from https://rot47.net/_py/rot47.txt This function takes a string and performs the ROT47 operation on it

Begin the streaming download of a URL. :param url: the URL to download :type url: str :param blocksize: The size of

This function is used for the Weiner's Little D attack. Determines the Euclidean Greatest Common Denominator between given values.

Stolen from https://github.com/tothi/railfence. This is a convenience function to encrypt data with the Railfence cipher. :param pl

r""" Yield cases for evaluation given the target and manager configuration. This allows units with multiple possible evaluations (such

r""" Run unit tasks given `case` which was returned from `Unit.enumerate`. This could happen in any thread or process of execution and

This function actually runs the provided Cow operations and returns the standard output. :param code: The code to run as Cow. :para

This function will actually evaluate the Ook code, by translating it to Brainfuck character mapping and then passing it to the ``evaluate

This function is execute Malbolge code.

This function is used as part of Malbolge's operations.

Dump a .git repository into the output directory. This is the core function of the https://github.com/arthaud/git-dumper code.

This function is used for the Cube Root attack. Determines the cube root of a number. :param n: The number to determine the cube root o