Package ghidra.python

Class PythonScriptProvider

java.lang.Object
ghidra.app.script.GhidraScriptProvider
ghidra.python.PythonScriptProvider
All Implemented Interfaces:
ExtensionPoint, Comparable<GhidraScriptProvider>
public class PythonScriptProvider extends GhidraScriptProvider

  • Constructor Details

    • PythonScriptProvider

      public PythonScriptProvider()

  • Method Details

    • createNewScript

      public void createNewScript(ResourceFile newScript, String category) throws IOException
      Description copied from class: GhidraScriptProvider
      Creates a new script using the specified file.
      Specified by:
      createNewScript in class GhidraScriptProvider
      Parameters:
      newScript - the new script file
      category - the script category
      Throws:
      IOException - if an error occurs writing the file

    • getBlockCommentStart

      public Pattern getBlockCommentStart()
      Returns a Pattern that matches block comment openings.

      If block comments are not supported by this provider, then this returns null.

      In Python this is a triple single quote sequence, "'''".

      Overrides:
      getBlockCommentStart in class GhidraScriptProvider
      Returns:
      the Pattern for Python block comment openings

    • getBlockCommentEnd

      public Pattern getBlockCommentEnd()
      Returns a Pattern that matches block comment closings.

      If block comments are not supported by this provider, then this returns null.

      In Python this is a triple single quote sequence, "'''".

      Overrides:
      getBlockCommentEnd in class GhidraScriptProvider
      Returns:
      the Pattern for Python block comment openings

    • getCommentCharacter

      public String getCommentCharacter()
      Description copied from class: GhidraScriptProvider
      Returns the comment character.

      For example, "//" or "#".

      Specified by:
      getCommentCharacter in class GhidraScriptProvider
      Returns:
      the comment character

    • getCertifyHeaderStart

      protected String getCertifyHeaderStart()
      Description copied from class: GhidraScriptProvider
      Return the start of certification header line if this file type is subject to certification.
      Overrides:
      getCertifyHeaderStart in class GhidraScriptProvider
      Returns:
      start of certification header or null if not supported

    • getCertificationBodyPrefix

      protected String getCertificationBodyPrefix()
      Description copied from class: GhidraScriptProvider
      Return the prefix for each certification header body line if this file is subject to certification.
      Overrides:
      getCertificationBodyPrefix in class GhidraScriptProvider
      Returns:
      certification header body prefix or null if not supported

    • getCertifyHeaderEnd

      protected String getCertifyHeaderEnd()
      Description copied from class: GhidraScriptProvider
      Return the end of certification header line if this file type is subject to certification.
      Overrides:
      getCertifyHeaderEnd in class GhidraScriptProvider
      Returns:
      end of certification header or null if not supported

    • getDescription

      public String getDescription()
      Description copied from class: GhidraScriptProvider
      Returns a description for this type of script.
      Specified by:
      getDescription in class GhidraScriptProvider
      Returns:
      a description for this type of script

    • getExtension

      public String getExtension()
      Description copied from class: GhidraScriptProvider
      Returns the file extension for this type of script.

      For example, ".java" or ".py".

      Specified by:
      getExtension in class GhidraScriptProvider
      Returns:
      the file extension for this type of script

    • getScriptInstance

      public GhidraScript getScriptInstance(ResourceFile sourceFile, PrintWriter writer) throws GhidraScriptLoadException
      Description copied from class: GhidraScriptProvider
      Returns a GhidraScript instance for the specified source file.
      Specified by:
      getScriptInstance in class GhidraScriptProvider
      Parameters:
      sourceFile - the source file
      writer - the print writer to write warning/error messages. If the error prevents success, throw an exception instead. The caller will print the error.
      Returns:
      a GhidraScript instance for the specified source file
      Throws:
      GhidraScriptLoadException - when the script instance cannot be created