amd-node-scraper 1.1.2__tar.gz → 1.1.4__tar.gz

amd_node_scraper-1.1.4/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,72 @@
+name: Bug report
+description: Report a reproducible problem with Node Scraper
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please include enough detail to reproduce the issue.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened and what did you expect to happen?
+      placeholder: Clear and concise description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Minimal, concrete steps to reproduce the issue.
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: CLI output / logs
+      description: Paste relevant output (redact secrets/tokens/hosts as needed).
+      render: shell
+    validations:
+      required: false
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Output of `node-scraper --version` (or the git commit hash).
+      placeholder: "e.g. 0.6.1"
+    validations:
+      required: false
+  - type: dropdown
+    id: install_method
+    attributes:
+      label: Install method
+      options:
+        - PyPI (pip install amd-node-scraper)
+        - Editable install from source (pip install -e .)
+        - Other
+    validations:
+      required: false
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "e.g. 3.11.8"
+    validations:
+      required: false
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, target system type (LOCAL/REMOTE), and anything else relevant.
+      placeholder: |
+        OS:
+        Target:
+        Notes:
+    validations:
+      required: false

amd_node_scraper-1.1.4/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions
+    url: https://github.com/amd/node-scraper/issues
+    about: If you're not sure it's a bug/feature request yet, start with an issue and add details.
+  - name: Security reports
+    url: https://github.com/amd/node-scraper/security/policy
+    about: Please report security issues privately (see SECURITY.md).

amd_node_scraper-1.1.4/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,38 @@
+name: Feature request
+description: Suggest an enhancement or new capability
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion. Please describe the problem you're trying to solve and what success looks like.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / motivation
+      description: What problem are you trying to solve?
+      placeholder: "I want to..."
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What would you like Node Scraper to do?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What else have you tried or considered?
+    validations:
+      required: false
+  - type: textarea
+    id: scope
+    attributes:
+      label: Scope / impact
+      description: What plugins/OSes/environments would this affect?
+    validations:
+      required: false

amd_node_scraper-1.1.4/.github/pull_request_template.md

@@ -0,0 +1,12 @@
+## Summary
+-
+
+## Test plan
+- [ ] `pytest test/unit`
+- [ ] `pytest test/functional` (if applicable)
+- [ ] `pre-commit run --all-files`
+
+## Checklist
+- [ ] Added/updated tests (or explained why not)
+- [ ] Updated docs/README if behavior changed
+- [ ] No secrets or credentials committed

amd_node_scraper-1.1.4/.github/scripts/plugin_convention_warnings.py

@@ -0,0 +1,261 @@
+#!/usr/bin/env python3
+"""Checks conventions under ``nodescraper/plugins`` (stderr warnings only; non-blocking).
+
+1. **Command strings in collectors/analyzers** , for  ``Collector``
+   or ``Analyzer`` classes: a *class-level* assignment to a string (or f-string) that
+   looks like a shell/CLI invocation must use the name ``CMD`` or
+   ``CMD_<suffix>`` (e.g. ``CMD_LIST``). Names starting with ``_`` and names
+   listed in ``_CMD_CHECK_SKIP_NAMES`` are ignored; see
+   ``_looks_like_shell_command_literal`` for what counts as command-like.
+
+2. **Args models** — In ``collector_args.py`` and ``analyzer_args.py``,
+   for classes named ``*Args`` that subclass ``BaseModel``, ``CollectorArgs``,
+   ``AnalyzerArgs``, or another ``*Args``: each public field should assign
+   ``pydantic.Field(...)`` with a non-empty ``description=`` (for help/CLI
+   text). ``ClassVar`` fields, ``_``-prefixed names, and ``model_config`` are
+   skipped.
+"""
+
+from __future__ import annotations
+
+import ast
+import re
+import sys
+from pathlib import Path
+
+_REPO_ROOT = Path(__file__).resolve().parent.parent.parent
+PLUGIN_ROOT = _REPO_ROOT / "nodescraper" / "plugins"
+
+# Class-level names in collectors/analyzers that are not shell-command strings.
+_CMD_CHECK_SKIP_NAMES = frozenset(
+    {
+        "AMD_SMI_EXE",
+        "DATA_MODEL",
+        "SUPPORTED_OS_FAMILY",
+        "COLLECTOR",
+        "ANALYZER",
+        "COLLECTOR_ARGS",
+        "ANALYZER_ARGS",
+        "TYPE_CHECKING",
+    }
+)
+
+
+def _is_stringish(expr: ast.expr) -> bool:
+    if isinstance(expr, ast.Constant) and isinstance(expr.value, str):
+        return True
+    if isinstance(expr, ast.JoinedStr):
+        return True
+    return False
+
+
+def _stringish_preview(expr: ast.expr) -> str | None:
+    """Best-effort static string for command-like heuristics (f-strings may be partial)."""
+    if isinstance(expr, ast.Constant) and isinstance(expr.value, str):
+        return expr.value
+    if isinstance(expr, ast.JoinedStr):
+        parts: list[str] = []
+        for elt in expr.values:
+            if isinstance(elt, ast.Constant) and isinstance(elt.value, str):
+                parts.append(elt.value)
+            else:
+                parts.append("\x00")  # dynamic segment
+        return "".join(parts) if parts else ""
+    return None
+
+
+def _looks_like_shell_command_literal(s: str) -> bool:
+    """True if this class-level string is plausibly a shell/CLI invocation (not IDs, tokens, paths)."""
+    s = s.strip()
+    if not s:
+        return False
+    if re.fullmatch(r"0x[0-9a-fA-F]+", s):
+        return False
+    # OS / config tokens such as PRETTY_NAME, VERSION_ID
+    if re.fullmatch(r"[A-Z][A-Z0-9_]+", s):
+        return False
+    # Filenames / simple paths (no shell metacharacters)
+    if "." in s and not re.search(r"[\s|;&$`]", s):
+        return False
+    if re.search(r"[\s|;&$`<>]", s):
+        return True
+    # Typical one-word inband commands: uptime, sysctl, dmesg, amd-smi, etc.
+    if re.fullmatch(r"[a-z][a-z0-9_.-]*", s, flags=re.IGNORECASE):
+        return True
+    return False
+
+
+def _base_name(node: ast.expr) -> str | None:
+    if isinstance(node, ast.Name):
+        return node.id
+    if isinstance(node, ast.Subscript):
+        return _base_name(node.value)
+    if isinstance(node, ast.Attribute):
+        return node.attr
+    return None
+
+
+def _is_collector_or_analyzer_class(cls: ast.ClassDef) -> bool:
+    return cls.name.endswith("Collector") or cls.name.endswith("Analyzer")
+
+
+def _field_call_name(func: ast.expr) -> bool:
+    if isinstance(func, ast.Name) and func.id == "Field":
+        return True
+    if isinstance(func, ast.Attribute) and func.attr == "Field":
+        return True
+    return False
+
+
+def _field_has_nonempty_description(call: ast.Call) -> bool:
+    for kw in call.keywords:
+        if kw.arg != "description" or kw.value is None:
+            continue
+        v = kw.value
+        if isinstance(v, ast.Constant) and isinstance(v.value, str) and v.value.strip():
+            return True
+    return False
+
+
+def _check_cmd_prefixes(path: Path, tree: ast.Module) -> list[str]:
+    """Rule #1: warn when a command-like class attr is not ``CMD`` / ``CMD_*``."""
+    msgs: list[str] = []
+    for node in tree.body:
+        # Keeps only classes whose names end with Collector or Analyzer (e.g. ProcessCollector, PcieAnalyzer).
+        if not isinstance(node, ast.ClassDef) or not _is_collector_or_analyzer_class(node):
+            continue
+        for stmt in node.body:
+            if not isinstance(stmt, ast.Assign) or len(stmt.targets) != 1:
+                continue
+            t = stmt.targets[0]
+            if not isinstance(t, ast.Name):
+                continue
+            name = t.id
+            if name.startswith("_") or name in _CMD_CHECK_SKIP_NAMES:
+                continue
+            if not _is_stringish(stmt.value):
+                continue
+            preview = _stringish_preview(stmt.value)
+            if preview is None or not _looks_like_shell_command_literal(preview):
+                continue
+            if name == "CMD" or name.startswith("CMD_"):
+                continue
+            msgs.append(
+                f"{path}:{stmt.lineno}: [{node.name}] command-like class attribute {name!r} "
+                "should be renamed to CMD or to start with CMD_."
+            )
+    return msgs
+
+
+def _is_args_class(cls: ast.ClassDef) -> bool:
+    if not cls.name.endswith("Args"):
+        return False
+    if not cls.bases:
+        return False
+    for b in cls.bases:
+        bn = _base_name(b)
+        if bn in ("BaseModel", "CollectorArgs", "AnalyzerArgs"):
+            return True
+        if bn and bn.endswith("Args"):
+            return True
+    return False
+
+
+def _annotation_mentions_classvar(ann: ast.expr | None) -> bool:
+    if ann is None:
+        return False
+    if isinstance(ann, ast.Name) and ann.id == "ClassVar":
+        return True
+    if isinstance(ann, ast.Subscript):
+        return _annotation_mentions_classvar(ann.value)
+    if isinstance(ann, ast.Attribute) and ann.attr == "ClassVar":
+        return True
+    if isinstance(ann, ast.BinOp) and isinstance(ann.op, ast.BitOr):
+        return _annotation_mentions_classvar(ann.left) or _annotation_mentions_classvar(ann.right)
+    return False
+
+
+def _check_args_fields(path: Path, tree: ast.Module) -> list[str]:
+    """Rule #2: warn when Args fields lack ``Field`` with a non-empty ``description``."""
+    msgs: list[str] = []
+    for node in tree.body:
+        if not isinstance(node, ast.ClassDef) or not _is_args_class(node):
+            continue
+        for stmt in node.body:
+            if isinstance(stmt, ast.AnnAssign):
+                if _annotation_mentions_classvar(stmt.annotation):
+                    continue
+                if not isinstance(stmt.target, ast.Name):
+                    continue
+                field_name = stmt.target.id
+                if field_name.startswith("_") or field_name in ("model_config",):
+                    continue
+                if stmt.value is None:
+                    msgs.append(
+                        f"{path}:{stmt.lineno}: [{node.name}] {field_name}: "
+                        "use Field(..., description='...') for every Args field."
+                    )
+                    continue
+                if isinstance(stmt.value, ast.Call) and _field_call_name(stmt.value.func):
+                    if not _field_has_nonempty_description(stmt.value):
+                        msgs.append(
+                            f"{path}:{stmt.lineno}: [{node.name}] {field_name}: "
+                            "Field(...) must include a non-empty description= for help text."
+                        )
+                else:
+                    msgs.append(
+                        f"{path}:{stmt.lineno}: [{node.name}] {field_name}: "
+                        "must assign pydantic Field(...) with description=."
+                    )
+            elif isinstance(stmt, ast.Assign) and len(stmt.targets) == 1:
+                t = stmt.targets[0]
+                if not isinstance(t, ast.Name):
+                    continue
+                field_name = t.id
+                if field_name.startswith("_") or field_name in ("model_config",):
+                    continue
+                val = stmt.value
+                if isinstance(val, ast.Call) and _field_call_name(val.func):
+                    if not _field_has_nonempty_description(val):
+                        msgs.append(
+                            f"{path}:{stmt.lineno}: [{node.name}] {field_name}: "
+                            "Field(...) must include a non-empty description= for help text."
+                        )
+    return msgs
+
+
+def main() -> None:
+    if not PLUGIN_ROOT.is_dir():
+        sys.stderr.write(f"warning: plugins directory not found: {PLUGIN_ROOT}\n")
+        return
+
+    all_msgs: list[str] = []
+    for path in sorted(PLUGIN_ROOT.rglob("*.py")):
+        rel = path.relative_to(_REPO_ROOT)
+        name = path.name
+        try:
+            src = path.read_text(encoding="utf-8")
+            tree = ast.parse(src, filename=str(path))
+        except (OSError, SyntaxError) as e:
+            all_msgs.append(f"{rel}: could not parse: {e}")
+            continue
+
+        if "collector" in name and name.endswith(".py"):
+            all_msgs.extend(_check_cmd_prefixes(rel, tree))
+        if "analyzer" in name and name.endswith(".py"):
+            all_msgs.extend(_check_cmd_prefixes(rel, tree))
+
+        if name == "collector_args.py" or name == "analyzer_args.py":
+            all_msgs.extend(_check_args_fields(rel, tree))
+
+    if all_msgs:
+        sys.stderr.write("plugin convention warnings (commit not blocked):\n")
+        for m in all_msgs:
+            sys.stderr.write(f"  WARNING: {m}\n")
+    else:
+        sys.stdout.write("Success: no plugin convention warnings.\n")
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

{amd_node_scraper-1.1.2 → amd_node_scraper-1.1.4}/.github/workflows/update-plugin-docs.yml

@@ -38,7 +38,8 @@ jobs:
         source venv/bin/activate
         python docs/generate_plugin_doc_bundle.py \
           --package nodescraper.plugins.inband \
-          --output docs/PLUGIN_DOC.md
+          --output docs/PLUGIN_DOC.md \
+          --update-readme-help
 
     - name: Clean pre-commit cache
       run: |
@@ -50,7 +51,7 @@ jobs:
       run: |
         source venv/bin/activate
         pre-commit install-hooks || true
-        pre-commit run --files docs/PLUGIN_DOC.md || true
+        pre-commit run --files docs/PLUGIN_DOC.md README.md || true
 
     - name: Create Pull Request
       uses: peter-evans/create-pull-request@v6

{amd_node_scraper-1.1.2 → amd_node_scraper-1.1.4}/.pre-commit-config.yaml

@@ -1,4 +1,13 @@
 repos:
+  - repo: local
+    hooks:
+      - id: plugin-convention-warnings
+        name: plugin convention warnings (non-blocking)
+        entry: python3 .github/scripts/plugin_convention_warnings.py
+        language: system
+        pass_filenames: false
+        always_run: true
+        verbose: true
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
     hooks:

{amd_node_scraper-1.1.2 → amd_node_scraper-1.1.4}/CONTRIBUTING.md

@@ -90,3 +90,14 @@ You can also run hooks manually:
 # Run all hooks on all files
 pre-commit run --all-files
 ```
+
+### Plugin conventions
+
+We follow a few plugin design conventions so that
+generation and downstream doc tooling run cleanly—for example, naming
+command strings on `*Collector` / `*Analyzer` classes as `CMD` or `CMD_*`, and
+using `pydantic.Field(..., description=...)` on args models. The
+`plugin-convention-warnings` hook in pre-commit runs
+[`.github/scripts/plugin_convention_warnings.py`](.github/scripts/plugin_convention_warnings.py)
+to flag violations (warnings only); read the script’s module docstring for the
+exact rules.

{amd_node_scraper-1.1.2 → amd_node_scraper-1.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: amd-node-scraper
-Version: 1.1.2
+Version: 1.1.4
 Summary: A framework for automated error detection and data collection
 Project-URL: homepage, https://github.com/amd/node-scraper
 Project-URL: documentation, https://github.com/amd/node-scraper
@@ -32,6 +32,7 @@ system debug.
 
 ## Table of Contents
 - [Installation](#installation)
+  - [Install from PyPI](#install-from-pypi)
   - [Install From Source](#install-from-source)
 - [CLI Usage](#cli-usage)
   - [Execution Methods](#execution-methods)
@@ -42,7 +43,6 @@ system debug.
     - ['run-plugins' sub command](#run-plugins-sub-command)
     - ['gen-plugin-config' sub command](#gen-plugin-config-sub-command)
     - ['compare-runs' subcommand](#compare-runs-subcommand)
-    - ['show-redfish-oem-allowable' subcommand](#show-redfish-oem-allowable-subcommand)
     - ['summary' sub command](#summary-sub-command)
 - [Configs](#configs)
   - [Global args](#global-args)
@@ -53,6 +53,19 @@ system debug.
 invoked by collectors** -> See [docs/PLUGIN_DOC.md](docs/PLUGIN_DOC.md)
 
 ## Installation
+### Install from PyPI
+Node Scraper is published on [PyPI](https://pypi.org/project/amd-node-scraper/) as **amd-node-scraper**. Install it with Python 3.9 or newer:
+
+```sh
+pip install amd-node-scraper
+```
+
+Use a virtual environment if you prefer. After installation, confirm the CLI is available:
+
+```sh
+node-scraper --help
+```
+
 ### Install From Source
 Node Scraper requires Python 3.9+ for installation. After cloning this repository,
 call dev-setup.sh script with 'source'. This script creates an editable install of Node Scraper in
@@ -87,46 +100,71 @@ Sets up pre-commit hooks for code quality checks. On Debian/Ubuntu, you may need
 The Node Scraper CLI can be used to run Node Scraper plugins on a target system. The following CLI
 options are available:
 
+<!-- node-scraper -h start -->
 ```sh
-usage: node-scraper [-h] [--sys-name STRING] [--sys-location {LOCAL,REMOTE}] [--sys-interaction-level {PASSIVE,INTERACTIVE,DISRUPTIVE}] [--sys-sku STRING]
-                    [--sys-platform STRING] [--plugin-configs [STRING ...]] [--system-config STRING] [--connection-config STRING] [--log-path STRING]
-                    [--log-level {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG,NOTSET}] [--gen-reference-config] [--skip-sudo]
-                    {summary,run-plugins,describe,gen-plugin-config} ...
+usage: cli.py [-h] [--version] [--sys-name STRING]
+              [--sys-location {LOCAL,REMOTE}]
+              [--sys-interaction-level {PASSIVE,INTERACTIVE,DISRUPTIVE}]
+              [--sys-sku STRING] [--sys-platform STRING]
+              [--plugin-configs LIST] [--system-config STRING]
+              [--connection-config STRING] [--log-path STRING]
+              [--log-level {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG,NOTSET}]
+              [--no-console-log] [--gen-reference-config] [--skip-sudo]
+              {summary,run-plugins,describe,gen-plugin-config,compare-runs,show-redfish-oem-allowable}
+              ...
 
 node scraper CLI
 
 positional arguments:
-  {summary,run-plugins,describe,gen-plugin-config}
+  {summary,run-plugins,describe,gen-plugin-config,compare-runs,show-redfish-oem-allowable}
                         Subcommands
     summary             Generates summary csv file
     run-plugins         Run a series of plugins
     describe            Display details on a built-in config or plugin
     gen-plugin-config   Generate a config for a plugin or list of plugins
+    compare-runs        Compare datamodels from two run log directories
+    show-redfish-oem-allowable
+                        Fetch OEM diagnostic allowable types from Redfish
+                        LogService (for oem_diagnostic_types_allowable)
 
 options:
   -h, --help            show this help message and exit
-  --sys-name STRING     System name (default: <my_system_name>)
+  --version             show program's version number and exit
+  --sys-name STRING     System name (default: <current hostname>)
   --sys-location {LOCAL,REMOTE}
                         Location of target system (default: LOCAL)
   --sys-interaction-level {PASSIVE,INTERACTIVE,DISRUPTIVE}
-                        Specify system interaction level, used to determine the type of actions that plugins can perform (default: INTERACTIVE)
+                        Specify system interaction level, used to determine
+                        the type of actions that plugins can perform (default:
+                        INTERACTIVE)
   --sys-sku STRING      Manually specify SKU of system (default: None)
   --sys-platform STRING
                         Specify system platform (default: None)
-  --plugin-configs [STRING ...]
-                        built-in config names or paths to plugin config JSONs. Available built-in configs: AllPlugins, NodeStatus (default: None)
+  --plugin-configs LIST
+                        Comma-separated built-in names and/or plugin config
+                        JSON paths (e.g. --plugin-
+                        configs=NodeStatus,/path/c.json). Built-ins:
+                        NodeStatus, AllPlugins (default: None)
   --system-config STRING
                         Path to system config json (default: None)
   --connection-config STRING
                         Path to connection config json (default: None)
-  --log-path STRING     Specifies local path for node scraper logs, use 'None' to disable logging (default: .)
+  --log-path STRING     Specifies local path for node scraper logs, use 'None'
+                        to disable logging (default: .)
   --log-level {CRITICAL,FATAL,ERROR,WARN,WARNING,INFO,DEBUG,NOTSET}
                         Change python log level (default: INFO)
+  --no-console-log      Write logs only to nodescraper.log under the run
+                        directory; do not print to stdout. If no run log
+                        directory would be created (e.g. --log-path None),
+                        uses ./scraper_logs_<host>_<timestamp>/ like the
+                        default layout. (default: False)
   --gen-reference-config
-                        Generate reference config from system. Writes to ./reference_config.json. (default: False)
-  --skip-sudo           Skip plugins that require sudo permissions (default: False)
-
+                        Generate reference config from system. Writes to
+                        ./reference_config.json. (default: False)
+  --skip-sudo           Skip plugins that require sudo permissions (default:
+                        False)
 ```
+<!-- node-scraper -h end -->
 
 ### Execution Methods
 
@@ -328,6 +366,16 @@ You can extend the built-in error detection with custom regex patterns. Create a
             "event_category": "SW_DRIVER",
             "event_priority": 4
           }
+        ],
+        "priority_override_rules": [
+          {
+            "message": "Application Crash",
+            "new_priority": "ERROR"
+          },
+          {
+            "event_category": "SW_DRIVER",
+            "new_priority": "WARNING"
+          }
         ]
       }
     }
@@ -339,7 +387,7 @@ You can extend the built-in error detection with custom regex patterns. Create a
 Save this to `dmesg_custom_config.json` and run:
 
 ```sh
-node-scraper --plugin-configs dmesg_custom_config.json run-plugins DmesgPlugin
+node-scraper --plugin-configs=dmesg_custom_config.json run-plugins DmesgPlugin
 ```
 
 #### **'compare-runs' subcommand**
@@ -529,9 +577,21 @@ A plugin config can be used to compare the system data against the config specif
 Built-in configs include **NodeStatus** (a subset of plugins) and **AllPlugins** (runs every
 registered plugin with default arguments—useful for generating a reference config from the full system).
 
+**NodeStatus plus additional plugins** — built-in configs merge with plugins named after `run-plugins`.
+Values are comma-separated; pass as **`--plugin-configs=…`** or **`--plugin-configs` …** (same as other
+optional flags), e.g. `--plugin-configs=NodeStatus,/path/extra.json`.
+Examples:
+```sh
+node-scraper --plugin-configs=NodeStatus run-plugins PciePlugin
+```
+
+```sh
+node-scraper --log-path ./logs --plugin-configs=NodeStatus run-plugins PciePlugin
+```
+
 Using a JSON file:
 ```sh
-node-scraper --plugin-configs plugin_config.json
+node-scraper --plugin-configs=plugin_config.json
 ```
 Here is an example of a comprehensive plugin config that specifies analyzer args for each plugin:
 ```json
@@ -593,7 +653,7 @@ data.
 
 **Run all registered plugins (AllPlugins config):**
 ```sh
-node-scraper --plugin-config AllPlugins
+node-scraper --plugin-configs=AllPlugins
 
 ```
 
@@ -627,7 +687,7 @@ This will generate the following config:
 ```
 This config can later be used on a different platform for comparison, using the steps at #2:
 ```sh
-node-scraper --plugin-configs reference_config.json
+node-scraper --plugin-configs=reference_config.json
 
 ```