Python updates

.gitignore

@@ -64,3 +64,8 @@ missing
 /curl_fuzzer_smtp_seed_corpus.zip
 /curl_fuzzer_tftp
 /curl_fuzzer_tftp_seed_corpus.zip
+
+# Python
+.venv/
+__pycache__/
+logs/

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "[python]": {
+        "editor.defaultFormatter": "charliermarsh.ruff"
+    },
+}

README.md

@@ -50,18 +50,32 @@ The public corpus links for each target should be accessible here:
 
 Check out [REPRODUCING.md](REPRODUCING.md) for more detailed instructions.
 
+## How do I install the Python tooling?
+
+- Create a virtual environment using your favourite method.
+  - For example:
+    ```shell
+    python3 -m venv .venv
+    ```
+- Within that virtual environment, from the root directory of this repository, install the tooling with `pip install .`
+
+Alternatively you can use Poetry to run tools directly, using `poetry run <tool>`.
+
 ## What's in this testcase?
 
 To look at the contents of a testcase, run
-```
-python read_corpus.py --input <path/to/file>
+```shell
+read_corpus <path/to/file>
 ```
 This will print out a list of contents inside the file.
 
 ## I want to generate a new testcase
 
-To generate a new testcase, run `python generate_corpus.py` with appropriate
-options.
+To generate a new testcase, run
+```shell
+generate_corpus
+```
+with appropriate options - pass `--help` for all options.
 
 # I want to enhance the fuzzer!