Assorted minor fixes

Author: apdavison

doc/developers_guide.txt

@@ -40,17 +40,18 @@ should fork the main `Sumatra repository on Github`_, then clone your own fork.:
 
     $ cd /some/directory
     $ git clone https://github.com/<username>/sumatra.git
+    $ cd sumatra
 
 Now you need to make sure that the ``sumatra`` package is on your PYTHONPATH and
 that the ``smt`` and ``smtweb`` scripts are on your PATH. You can do this either
-by installing Sumatra normally::
+by installing Sumatra normally from the local checkout::
 
-    $ pip install ./sumatra
+    $ pip install .[dev]
 
 (if you do this, you will have to re-run ``pip install`` any time you make
 changes to the code) *or* using the "editable" option::
 
-    $ pip install --editable ./sumatra
+    $ pip install --editable .[dev]
 
 To ensure you always have access to the most recent version, add the main repository as "upstream"::
 

doc/parameter_files.txt

@@ -14,6 +14,20 @@ If the name of your parameter file ends in a recognized extension, such as
 ".json" or ".yaml", Sumatra will use the associated format, otherwise it
 chooses the appropriate format based on file contents.
 
+
+Enabling and disabling parameter file parsing
+=============================================
+
+By default, Sumatra will try to parse your parameter files.
+You can turn this off with::
+
+  $ smt configure --ignore-parameters
+
+To re-enable parsing::
+
+  $ smt configure --parse-parameters
+
+
 Supported formats
 =================
 
@@ -84,6 +98,7 @@ sub-parameter sets to be included from other files. Example::
       }
     }
 
+
 Adding new formats
 ==================
 

doc/releases/0.8.0.txt

@@ -2,7 +2,7 @@
 Sumatra 0.8.0 release notes
 ===========================
 
-*17th April 2025*
+*18th April 2025*
 
 It is almost ten years since the last release of Sumatra!
 

pyproject.toml

@@ -95,9 +95,10 @@ test = [
 ]
 
 dev = [
-    "sumatra[web,git,hg,remote,postgres,latex,mpi,docs,test]",
+    "sumatra[web,git,hg,remote,postgres,mysql,latex,mpi,docs,test]",
     "build",
-    "twine"
+    "twine",
+    "docker"
 ]
 
 [tool.black]

sumatra/commands.py

@@ -333,7 +333,6 @@ def configure(argv):
         project.allow_command_line_parameters = not args.plain
     if args.ignore_parameters is not None:
         project.ignore_parameters = args.ignore_parameters
-        print("Setting ignore parameters to {}".format(args.ignore_parameters))
     if args.add_plugin:
         project.load_plugins(args.add_plugin)
     if args.remove_plugin:

sumatra/parameters.py

@@ -70,7 +70,7 @@ def parse_command_line_parameter(self, p):
         Uses ParameterSet format-specific type parsers stored in self.casts
 
         Raises ValueError with args tuple containing name, value if parameter name
-        isn't in self.values.
+        isn't in self._values.
         """
         pos = p.find('=')
         if pos == -1: