SCons 4.8.1 Released

A new SCons release, 4.8.1, is now available on the SCons download page:

https://scons.org/pages/download.html

Here is a summary of the changes since 4.8.0:

CHANGED/ENHANCED EXISTING FUNCTIONALITY

• env.Dump() previously accepted a single optional "key" argument.
  It now accepts any number of optional "key" arguments; any supplied
  keys will be serialized with their values in a Python dict style.
  As a result there is a small change in behavior: if a single key
  argument is given, where it previously would return a string containing
  just the value, now it will return a string that looks like a dictionary
  including the key. For example, from "'gcc'" to "{'CC': 'gcc'}".
  This should not have any impact as the result of calling Dump is
  intended for diagnostic output, not for use by other interfaces.

FIXES

• SCons 4.8.0 added an __all__ specifier at the top of the Variables
  module (Variables/__init__.py) to control what is made available in
  a star import. However, there was existing usage of doing
  from SCons.Variables import * which expected the variable types
  to be avaiable. BoolVariable, EnumVariable, ListVariable,
  PackageVariable and PathVariable are added to __all__,
  so this form of import should now work again.

• Fix a problem with AppendUnique and PrependUnique where a value could
  be erroneously removed due to a substring match.

• Fix handling of ListVariable when supplying a quoted choice containing
  a space character (issue #4585).

• On win32 platform, SCons 4.7.0 modified the determination
  of the output encoding of piped processes. Instead of using the default
  encoding, it relied on the encoding attribute of the output stream.
  If the encoding attribute of the output stream was set to None,
  it was triggering an invalid argument exception. This was the case with
  streams of type io.StringIO for example.
  This has been changed to always use the oem encoding which should be the
  encoding in the shell where the command was spawned.

DOCUMENTATION

• Improve wording of manpage "Functions and Environment Methods" section.
• Make doc function signature style more consistent - tweaks to AddOption,
  DefaultEnvironment and Tool,.

DEVELOPMENT

• sctypes is_* functions given explicit return types. Python 3.13+ uses
  TypeIs for a near-equivalent of isinstance. Python 3.10 through 3.12
  uses TypeGuard, a less accurate implementation but still provides
  usable type hinting. Python 3.9 and earlier simply returns bool, same
  as before.

Thanks to the following contributors listed below for their contributions to this release.

.. code-block:: text

git shortlog --no-merges -ns 4.8.0..HEAD

 9  Mats Wichmann
 8  William Deegan
 1  SIEGRIST Anthony
 1  Thaddeus Crews
 1  siegria