tools: update gyp-next to 0.20.4

PR-URL: #59690 Reviewed-By: Rafael Gonzaga <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Chengzhong Wu <[email protected]>

Author: nodejs-github-bot

tools/gyp/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.20.4](https://github.com/nodejs/gyp-next/compare/v0.20.3...v0.20.4) (2025-08-25)
+
+
+### Bug Fixes
+
+***cli:** remove duplicate usage ([#308](https://github.com/nodejs/gyp-next/issues/308)) ([0996f60](https://github.com/nodejs/gyp-next/commit/0996f60e9bc83ec9d7b31e39bebd23f8dc990130))
+***docs:** Add running gyp via uv ([#306](https://github.com/nodejs/gyp-next/issues/306)) ([0e43f61](https://github.com/nodejs/gyp-next/commit/0e43f61da8154f9b460ccba9ce4c0a25d2383ac4))
+
 ## [0.20.3](https://github.com/nodejs/gyp-next/compare/v0.20.2...v0.20.3) (2025-08-20)
 
 

tools/gyp/README.md

@@ -6,8 +6,9 @@ Documents are available at [`./docs`](./docs).
 __gyp-next__ is [released](https://github.com/nodejs/gyp-next/releases) to the [__Python Packaging Index__](https://pypi.org/project/gyp-next) (PyPI) and can be installed with the command:
 *`python3 -m pip install gyp-next`
 
-When used as a command line utility, __gyp-next__ can also be installed with [pipx](https://pypa.github.io/pipx):
-*`pipx install gyp-next`
+When used as a command line utility, __gyp-next__ can also be installed with [pipx](https://pypa.github.io/pipx) or [uv](https://docs.astral.sh/uv):
+*`pipx install gyp-next ` # --or--
+*`uv tool install gyp-next`
 ```
 Installing to a new venv 'gyp-next'
  installed package gyp-next 0.13.0, installed using Python 3.10.6
@@ -17,10 +18,11 @@ done! ✨ 🌟 ✨
 ```
 
 Or to run __gyp-next__ directly without installing it:
-*`pipx run gyp-next --help`
+*`pipx run gyp-next --help ` # --or--
+*`uvx --from=gyp-next gyp --help`
 ```
 NOTE: running app 'gyp' from 'gyp-next'
-usage: usage: gyp [options ...] [build_file ...]
+usage: gyp [options ...] [build_file ...]
 
 options:
  -h, --help show this help message and exit

tools/gyp/pylib/gyp/MSVSNew.py

@@ -32,18 +32,18 @@ def cmp(x, y):
 defMakeGuid(name, seed="msvs_new"):
 """Returns a GUID for the specified target name.
 
- Args:
- name: Target name.
- seed: Seed for MD5 hash.
- Returns:
- A GUID-line string calculated from the name and seed.
-
- This generates something which looks like a GUID, but depends only on the
- name and seed. This means the same name/seed will always generate the same
- GUID, so that projects and solutions which refer to each other can explicitly
- determine the GUID to refer to explicitly. It also means that the GUID will
- not change when the project for a target is rebuilt.
- """
+Args:
+name: Target name.
+seed: Seed for MD5 hash.
+Returns:
+A GUID-line string calculated from the name and seed.
+
+This generates something which looks like a GUID, but depends only on the
+name and seed. This means the same name/seed will always generate the same
+GUID, so that projects and solutions which refer to each other can explicitly
+determine the GUID to refer to explicitly. It also means that the GUID will
+not change when the project for a target is rebuilt.
+"""
 # Calculate a MD5 signature for the seed and name.
 d=hashlib.md5((str(seed) +str(name)).encode("utf-8")).hexdigest().upper()
 # Convert most of the signature to GUID form (discard the rest)
@@ -78,15 +78,15 @@ class MSVSFolder(MSVSSolutionEntry):
 def__init__(self, path, name=None, entries=None, guid=None, items=None):
 """Initializes the folder.
 
- Args:
- path: Full path to the folder.
- name: Name of the folder.
- entries: List of folder entries to nest inside this folder. May contain
- Folder or Project objects. May be None, if the folder is empty.
- guid: GUID to use for folder, if not None.
- items: List of solution items to include in the folder project. May be
- None, if the folder does not directly contain items.
- """
+Args:
+path: Full path to the folder.
+name: Name of the folder.
+entries: List of folder entries to nest inside this folder. May contain
+Folder or Project objects. May be None, if the folder is empty.
+guid: GUID to use for folder, if not None.
+items: List of solution items to include in the folder project. May be
+None, if the folder does not directly contain items.
+"""
 ifname:
 self.name=name
 else:
@@ -128,19 +128,19 @@ def __init__(
  ):
 """Initializes the project.
 
- Args:
- path: Absolute path to the project file.
- name: Name of project. If None, the name will be the same as the base
- name of the project file.
- dependencies: List of other Project objects this project is dependent
- upon, if not None.
- guid: GUID to use for project, if not None.
- spec: Dictionary specifying how to build this project.
- build_file: Filename of the .gyp file that the vcproj file comes from.
- config_platform_overrides: optional dict of configuration platforms to
- used in place of the default for this target.
- fixpath_prefix: the path used to adjust the behavior of _fixpath
- """
+Args:
+path: Absolute path to the project file.
+name: Name of project. If None, the name will be the same as the base
+name of the project file.
+dependencies: List of other Project objects this project is dependent
+upon, if not None.
+guid: GUID to use for project, if not None.
+spec: Dictionary specifying how to build this project.
+build_file: Filename of the .gyp file that the vcproj file comes from.
+config_platform_overrides: optional dict of configuration platforms to
+used in place of the default for this target.
+fixpath_prefix: the path used to adjust the behavior of _fixpath
+"""
 self.path=path
 self.guid=guid
 self.spec=spec
@@ -195,16 +195,16 @@ def __init__(
  ):
 """Initializes the solution.
 
- Args:
- path: Path to solution file.
- version: Format version to emit.
- entries: List of entries in solution. May contain Folder or Project
- objects. May be None, if the folder is empty.
- variants: List of build variant strings. If none, a default list will
- be used.
- websiteProperties: Flag to decide if the website properties section
- is generated.
- """
+Args:
+path: Path to solution file.
+version: Format version to emit.
+entries: List of entries in solution. May contain Folder or Project
+objects. May be None, if the folder is empty.
+variants: List of build variant strings. If none, a default list will
+be used.
+websiteProperties: Flag to decide if the website properties section
+is generated.
+"""
 self.path=path
 self.websiteProperties=websiteProperties
 self.version=version
@@ -230,9 +230,9 @@ def __init__(
 defWrite(self, writer=gyp.common.WriteOnDiff):
 """Writes the solution file to disk.
 
- Raises:
- IndexError: An entry appears multiple times.
- """
+Raises:
+IndexError: An entry appears multiple times.
+"""
 # Walk the entry tree and collect all the folders and projects.
 all_entries=set()
 entries_to_check=self.entries[:]

tools/gyp/pylib/gyp/MSVSProject.py

@@ -15,19 +15,19 @@ class Tool:
 def__init__(self, name, attrs=None):
 """Initializes the tool.
 
- Args:
- name: Tool name.
- attrs: Dict of tool attributes; may be None.
- """
+Args:
+name: Tool name.
+attrs: Dict of tool attributes; may be None.
+"""
 self._attrs=attrsor{}
 self._attrs["Name"] =name
 
 def_GetSpecification(self):
 """Creates an element for the tool.
 
- Returns:
- A new xml.dom.Element for the tool.
- """
+Returns:
+A new xml.dom.Element for the tool.
+"""
 return ["Tool", self._attrs]
 
 
@@ -37,10 +37,10 @@ class Filter:
 def__init__(self, name, contents=None):
 """Initializes the folder.
 
- Args:
- name: Filter (folder) name.
- contents: List of filenames and/or Filter objects contained.
- """
+Args:
+name: Filter (folder) name.
+contents: List of filenames and/or Filter objects contained.
+"""
 self.name=name
 self.contents=list(contentsor [])
 
@@ -54,13 +54,13 @@ class Writer:
 def__init__(self, project_path, version, name, guid=None, platforms=None):
 """Initializes the project.
 
- Args:
- project_path: Path to the project file.
- version: Format version to emit.
- name: Name of the project.
- guid: GUID to use for project, if not None.
- platforms: Array of string, the supported platforms. If null, ['Win32']
- """
+Args:
+project_path: Path to the project file.
+version: Format version to emit.
+name: Name of the project.
+guid: GUID to use for project, if not None.
+platforms: Array of string, the supported platforms. If null, ['Win32']
+"""
 self.project_path=project_path
 self.version=version
 self.name=name
@@ -84,21 +84,21 @@ def __init__(self, project_path, version, name, guid=None, platforms=None):
 defAddToolFile(self, path):
 """Adds a tool file to the project.
 
- Args:
- path: Relative path from project to tool file.
- """
+Args:
+path: Relative path from project to tool file.
+"""
 self.tool_files_section.append(["ToolFile",{"RelativePath": path}])
 
 def_GetSpecForConfiguration(self, config_type, config_name, attrs, tools):
 """Returns the specification for a configuration.
 
- Args:
- config_type: Type of configuration node.
- config_name: Configuration name.
- attrs: Dict of configuration attributes; may be None.
- tools: List of tools (strings or Tool objects); may be None.
- Returns:
- """
+Args:
+config_type: Type of configuration node.
+config_name: Configuration name.
+attrs: Dict of configuration attributes; may be None.
+tools: List of tools (strings or Tool objects); may be None.
+Returns:
+"""
 # Handle defaults
 ifnotattrs:
 attrs={}
@@ -122,23 +122,23 @@ def _GetSpecForConfiguration(self, config_type, config_name, attrs, tools):
 defAddConfig(self, name, attrs=None, tools=None):
 """Adds a configuration to the project.
 
- Args:
- name: Configuration name.
- attrs: Dict of configuration attributes; may be None.
- tools: List of tools (strings or Tool objects); may be None.
- """
+Args:
+name: Configuration name.
+attrs: Dict of configuration attributes; may be None.
+tools: List of tools (strings or Tool objects); may be None.
+"""
 spec=self._GetSpecForConfiguration("Configuration", name, attrs, tools)
 self.configurations_section.append(spec)
 
 def_AddFilesToNode(self, parent, files):
 """Adds files and/or filters to the parent node.
 
- Args:
- parent: Destination node
- files: A list of Filter objects and/or relative paths to files.
+Args:
+parent: Destination node
+files: A list of Filter objects and/or relative paths to files.
 
- Will call itself recursively, if the files list contains Filter objects.
- """
+Will call itself recursively, if the files list contains Filter objects.
+"""
 forfinfiles:
 ifisinstance(f, Filter):
 node= ["Filter",{"Name": f.name}]
@@ -151,29 +151,29 @@ def _AddFilesToNode(self, parent, files):
 defAddFiles(self, files):
 """Adds files to the project.
 
- Args:
- files: A list of Filter objects and/or relative paths to files.
+Args:
+files: A list of Filter objects and/or relative paths to files.
 
- This makes a copy of the file/filter tree at the time of this call. If you
- later add files to a Filter object which was passed into a previous call
- to AddFiles(), it will not be reflected in this project.
- """
+This makes a copy of the file/filter tree at the time of this call. If you
+later add files to a Filter object which was passed into a previous call
+to AddFiles(), it will not be reflected in this project.
+"""
 self._AddFilesToNode(self.files_section, files)
 # TODO(rspangler) This also doesn't handle adding files to an existing
 # filter. That is, it doesn't merge the trees.
 
 defAddFileConfig(self, path, config, attrs=None, tools=None):
 """Adds a configuration to a file.
 
- Args:
- path: Relative path to the file.
- config: Name of configuration to add.
- attrs: Dict of configuration attributes; may be None.
- tools: List of tools (strings or Tool objects); may be None.
+Args:
+path: Relative path to the file.
+config: Name of configuration to add.
+attrs: Dict of configuration attributes; may be None.
+tools: List of tools (strings or Tool objects); may be None.
 
- Raises:
- ValueError: Relative path does not match any file added via AddFiles().
- """
+Raises:
+ValueError: Relative path does not match any file added via AddFiles().
+"""
 # Find the file node with the right relative path
 parent=self.files_dict.get(path)
 ifnotparent: