(g)ULP!
Loading...
Searching...
No Matches
Contributing To Gulp

We'd love the the community to be part of our project both as developers and as users!

For developers

To submit PRs, just stick with these simple rules:

  1. follow the install docs for developers to setup the dev environment.
  2. be modular!
  3. use (and extend it, you are welcome!) our utility library muty-python instead of repeating common code, or to abstract complex functionality.
  4. use FFI if you need performances, i.e. as the win_evtx plugin which uses a pyevtx-rs rust's backend
  5. plugin.ingest() should not throw exceptions: instead, eat it and loop to be sure to ingest as much data as you can from the input.
  6. use microsoft's black formatter with the default settings.

Bug reporting

  1. gulp --version
    1. if you are a developer, output of the above command may not be correct if you updated the repository/ies manually: so, please provide the last commit hash of your local gulp and muty-python repositories.
  2. error dump from gulp's console, issues with "this/that does not work" missing an error dump will be rejected.
  3. steps for reproducing, including OS flavor (linux, WSL, macos, ...), arch and version.