dissect.target.plugins.apps.browser.browser#

Module Contents#

Classes#

BrowserPlugin

Base class for plugins.

Functions#

try_idna

Attempts to convert a possible Unicode url to ASCII using the IDNA standard.

Attributes#

dissect.target.plugins.apps.browser.browser.GENERIC_DOWNLOAD_RECORD_FIELDS = [('datetime', 'ts_start'), ('datetime', 'ts_end'), ('string', 'browser'), ('varint', 'id'),...#
dissect.target.plugins.apps.browser.browser.GENERIC_EXTENSION_RECORD_FIELDS = [('datetime', 'ts_install'), ('datetime', 'ts_update'), ('string', 'browser'), ('string', 'id'),...#
dissect.target.plugins.apps.browser.browser.GENERIC_HISTORY_RECORD_FIELDS = [('datetime', 'ts'), ('string', 'browser'), ('string', 'id'), ('uri', 'url'), ('string',...#
dissect.target.plugins.apps.browser.browser.BrowserDownloadRecord#
dissect.target.plugins.apps.browser.browser.BrowserExtensionRecord#
dissect.target.plugins.apps.browser.browser.BrowserHistoryRecord#
class dissect.target.plugins.apps.browser.browser.BrowserPlugin(target: dissect.target.Target)#

Bases: dissect.target.plugin.NamespacePlugin

Base class for plugins.

Plugins can optionally be namespaced by specifying the __namespace__ class attribute. Namespacing results in your plugin needing to be prefixed with this namespace when being called. For example, if your plugin has specified test as namespace and a function called example, you must call your plugin with test.example:

A Plugin class has the following private class attributes:

  • __namespace__

  • __record_descriptors__

With the following three being assigned in register():

  • __plugin__

  • __functions__

  • __exports__

Additionally, the methods and attributes of Plugin receive more private attributes by using decorators.

The export() decorator adds the following private attributes

  • __exported__

  • __output__: Set with the export() decorator.

  • __record__: Set with the export() decorator.

The internal() decorator and InternalPlugin set the __internal__ attribute. Finally. args() decorator sets the __args__ attribute.

Parameters:

target – The Target object to load the plugin for.

__namespace__ = 'browser'#
dissect.target.plugins.apps.browser.browser.try_idna(url: str) bytes#

Attempts to convert a possible Unicode url to ASCII using the IDNA standard.

Parameters:

url – A String containing the url to be converted.

Returns: Bytes object with the ASCII version of the url.