Home / google / python-fire
AI Slop Code RIsk Monitor

google/python-fire

Python Fire is a library for automatically generating command line interfaces (CLIs) from absolutely any Python object.

21.5 Elevated pattern signal View on GitHub

Maintenance and Governance Review

This report summarizes scanner evidence for google/python-fire, a Python project with 28,221 GitHub stars. SynthScan examined 13,206 lines of code across 76 source files, recording 181 pattern matches distributed across 12 syntactic categories. The legacy adjusted pattern signal is 21.5 (Elevated pattern signal); it is not an authorship estimate.

Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.

21.5
Adjusted Signal
21.5
Raw Pattern Score
100%
Time Factor
2026-07-01
Last Push
28.2K
Stars
Python
Language
13.2K
Lines of Code
76
Files
181
Pattern Hits
2026-10-12
Scan Date
0.32
HC Hit Rate

Risk Review · v3

Use each vector to guide manual verification of the underlying findings.

Cognitive Ownership Risk 51.9/100 · HIGH

Can maintainers explain intent, assumptions, and trade-offs? 135 finding(s).

Hallucinated Dependency & Supply Chain Risk 13.4/100 · LOW

Are imports declared and package/API names verified? 34 finding(s).

Agent Over-Engineering Ratio 28.2/100 · MEDIUM

Are wrappers, guards, and repeated structures necessary? 49 finding(s).

PR Review Velocity Impact 68.5/100 · HIGH

Which changes need focused human review? 181 finding(s).

What These Metrics Mean

Adjusted Signal
Legacy pattern score normalized per 1,000 scanned lines and multiplied by the repository-level time factor. It is not an estimate of AI authorship.
Raw Pattern Score
Sum of severity- and context-weighted pattern findings before applying the time factor.
Time Factor
A coarse multiplier based on repository last-push metadata. It does not identify when individual code was written.
Pattern Hits
Count of configured pattern findings. Review each location and surrounding code before acting.
HC Hit Rate
High- and critical-severity findings per scanned file. Severity is a configured detector weight, not proof of a vulnerability or authorship.
Lines / Files
Scan coverage denominators used by the legacy normalized score.

Pattern-Signal History

This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.

Severity Breakdown

Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.

CRITICAL 0HIGH 24MEDIUM 2LOW 155

Directory Score Breakdown

This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.

Pattern Findings

The scanner identified 181 distinct pattern matches across 12 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.

Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.

Docstring Block Structure14 hits · 70 pts
SeverityFileLineSnippetContext
HIGHfire/test_components.py375Generators have a ``Yields`` section instead of a ``Returns`` section. Args: n (int): The upper limit of thSTRING
HIGHfire/core.py74This function, Fire, is the main entrypoint for Python Fire. Executes a command either from the `command` argument orSTRING
HIGHfire/core.py362Execute a Fire command on a target component using the args supplied. Arguments that come after a final isolated '--'STRING
HIGHfire/core.py623Returns a subcomponent of component by consuming an arg from args. Given a starting component and args, this functionSTRING
HIGHfire/core.py765Parses the positional and named arguments from the available supplied args. Modifies kwargs, removing args as they arSTRING
HIGHfire/core.py823Parses the supplied arguments for keyword arguments. Given a list of arguments, finds occurrences of --name value, anSTRING
HIGHfire/parser.py80Parse value as a Python literal, or container of containers and literals. First the AST of the value is updated so thSTRING
HIGHfire/__main__.py43Performs a module import given the filename. Args: path (str): the path to the file to be imported. Raises: STRING
HIGHfire/__main__.py79Imports a given module or filename. If the module_or_filename exists in the file system and ends with .py, we attemSTRING
HIGHfire/console/files.py34Internal function to a find an executable. Args: executable: The name of the executable to find. path: A listSTRING
HIGHfire/console/files.py75Searches for `executable` in the directories listed in `path` or $PATH. Executable must not contain a directory or anSTRING
HIGHfire/console/platforms.py116Gets the enum corresponding to the given operating system id. Args: os_id: str, The operating system id to paSTRING
HIGHfire/console/platforms.py240Gets the enum corresponding to the given architecture id. Args: architecture_id: str, The architecture id to STRING
HIGHfire/console/platforms.py422Ensure that the Python version we are using is compatible. This will print an error message if not compatible. STRING
Over-Commented Block57 hits · 57 pts
SeverityFileLineSnippetContext
LOWfire/custom_descriptions.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/fire_import_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/interact_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/trace.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/test_components.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/decorators_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/test_components_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/formatting_windows.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/docstrings_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/trace_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/completion.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/helptext_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/testutils.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/inspectutils.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/fire_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/__init__.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/completion_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/core.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/parser_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/formatting.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/custom_descriptions_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/core_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/docstrings.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/parser.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/parser_fuzz_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/formatting_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/test_components_py3.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/test_components_bin.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/helptext.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/docstrings_fuzz_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/value_types.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/main_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/testutils_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/interact.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/__main__.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/inspectutils_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/decorators.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWfire/console/files.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/encoding.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/encoding.py101 return string.decode(sys.getdefaultencoding())COMMENT
LOWfire/console/console_io.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/platforms.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/console_attr_os.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/console_pager.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/text.py1# -*- coding: utf-8 -*- #COMMENT
LOWfire/console/console_attr.py1# -*- coding: utf-8 -*- #COMMENT
LOWexamples/widget/widget_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/widget/widget.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/widget/collector.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/widget/collector_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/identity/identity.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/cipher/cipher_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/cipher/cipher.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/diff/diff_test.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/diff/diff.py1# Copyright (C) 2018 Google Inc.COMMENT
LOWexamples/diff/difffull.py1# Copyright (C) 2018 Google Inc.COMMENT
LOW.github/scripts/build.sh1# Copyright (C) 2018 Google Inc.COMMENT
Empty Error Handlers10 hits · 50 pts
SeverityFileLineSnippetContext
HIGHfire/inspectutils.py306except (TypeError, AttributeError):CODE
HIGHfire/console/encoding.py71except UnicodeError:CODE
HIGHfire/console/encoding.py88except UnicodeError:CODE
HIGHfire/console/encoding.py95except UnicodeError:CODE
HIGHfire/console/encoding.py102except UnicodeError:CODE
HIGHfire/console/encoding.py79except UnicodeError:CODE
HIGHfire/console/console_attr_os.py47except: # pylint: disable=bare-exceptCODE
HIGHfire/console/console_attr_os.py153except: # pylint: disable=bare-exceptCODE
HIGHfire/console/console_attr.py785except UnicodeEncodeError:CODE
HIGHfire/console/console_attr.py791except UnicodeEncodeError:CODE
Hyper-Verbose Identifiers35 hits · 34 pts
SeverityFileLineSnippetContext
LOWfire/test_components.py30def multiplier_with_docstring(num, rate=2):CODE
LOWfire/test_components.py448def function_with_keyword_arguments(arg1, arg2=3, **kwargs):CODE
LOWfire/test_components.py453def fn_with_code_in_docstring():CODE
LOWfire/test_components.py548def fn_with_kwarg_and_defaults(arg1, arg2, opt=True, **kwargs):CODE
LOWfire/test_components.py559def fn_with_multiple_defaults(first='first', last='last', late='late'):CODE
LOWfire/docstrings_test.py37 def test_one_line_simple_whitespace(self):CODE
LOWfire/docstrings_test.py73 def test_one_line_runs_over_whitespace(self):STRING
LOWfire/docstrings_test.py85 def test_google_format_args_only(self):STRING
LOWfire/docstrings_test.py102 def test_google_format_arg_named_args(self):STRING
LOWfire/docstrings_test.py115 def test_google_format_typed_args_and_returns(self):STRING
LOWfire/docstrings_test.py143 def test_google_format_multiline_arg_description(self):STRING
LOWfire/docstrings_test.py169 def test_rst_format_typed_args_and_returns(self):STRING
LOWfire/docstrings_test.py198 def test_numpy_format_typed_args_and_returns(self):STRING
LOWfire/docstrings_test.py232 def test_numpy_format_multiline_arg_description(self):STRING
LOWfire/docstrings_test.py261 def test_multisection_docstring(self):STRING
LOWfire/docstrings_test.py280 def test_google_section_with_blank_first_line(self):STRING
LOWfire/docstrings_test.py293 def test_ill_formed_docstring(self):STRING
LOWfire/docstrings_test.py309 def test_numpy_colon_in_description(self):STRING
LOWfire/docstrings_test.py335 def test_rst_format_typed_args_and_kwargs(self):STRING
LOW⚡fire/custom_descriptions_test.py25 def test_string_type_summary_enough_space(self):CODE
LOW⚡fire/custom_descriptions_test.py31 def test_string_type_summary_not_enough_space_truncated(self):CODE
LOW⚡fire/custom_descriptions_test.py37 def test_string_type_summary_not_enough_space_new_line(self):CODE
LOW⚡fire/custom_descriptions_test.py43 def test_string_type_summary_not_enough_space_long_truncated(self):CODE
LOW⚡fire/custom_descriptions_test.py49 def test_string_type_description_enough_space(self):CODE
LOW⚡fire/custom_descriptions_test.py55 def test_string_type_description_not_enough_space_truncated(self):CODE
LOW⚡fire/custom_descriptions_test.py61 def test_string_type_description_not_enough_space_new_line(self):CODE
LOWfire/docstrings.py274def _get_or_create_arg_by_name(state, name, is_kwarg=False):CODE
LOWfire/docstrings.py386def _consume_google_args_line(line_info, state):CODE
LOWfire/docstrings.py577def _google_section_permitted(line_info, state):CODE
LOWfire/docstrings.py639def _section_from_possible_title(possible_title):CODE
LOWfire/docstrings.py751def _line_is_numpy_parameter_type(line_info):CODE
LOWfire/formatting_test.py37 def test_indent_multiple_lines(self):CODE
LOW⚡fire/formatting_test.py58 def test_ellipsis_truncate_not_enough_space(self):CODE
LOW⚡fire/formatting_test.py64 def test_ellipsis_middle_truncate(self):CODE
LOW⚡fire/formatting_test.py70 def test_ellipsis_middle_truncate_not_enough_space(self):CODE
Unused Imports26 hits · 26 pts
SeverityFileLineSnippetContext
LOWfire/interact_test.py24CODE
LOWfire/test_components.py21CODE
LOWfire/__init__.py17CODE
LOWfire/formatting.py17CODE
LOWfire/test_components_py3.py17CODE
LOWfire/console/files.py18CODE
LOWfire/console/files.py19CODE
LOWfire/console/files.py20CODE
LOWfire/console/encoding.py19CODE
LOWfire/console/encoding.py20CODE
LOWfire/console/encoding.py21CODE
LOWfire/console/platforms.py18CODE
LOWfire/console/platforms.py19CODE
LOWfire/console/platforms.py20CODE
LOWfire/console/console_attr_os.py18CODE
LOWfire/console/console_attr_os.py19CODE
LOWfire/console/console_attr_os.py20CODE
LOWfire/console/console_pager.py18CODE
LOWfire/console/console_pager.py19CODE
LOWfire/console/console_pager.py20CODE
LOWfire/console/text.py17CODE
LOWfire/console/text.py18CODE
LOWfire/console/text.py19CODE
LOWfire/console/console_attr.py90CODE
LOWfire/console/console_attr.py91CODE
LOWfire/console/console_attr.py92CODE
Deep Nesting21 hits · 21 pts
SeverityFileLineSnippetContext
LOWfire/formatting_windows.py30CODE
LOWfire/completion.py479CODE
LOWfire/testutils.py71CODE
LOWfire/inspectutils.py49CODE
LOWfire/inspectutils.py87CODE
LOWfire/core.py239CODE
LOWfire/core.py361CODE
LOWfire/core.py763CODE
LOWfire/core.py822CODE
LOWfire/core.py965CODE
LOWfire/docstrings.py386CODE
LOWfire/docstrings.py411CODE
LOWfire/parser.py79CODE
LOWfire/helptext.py191CODE
LOWfire/helptext.py597CODE
LOWfire/console/console_io.py68CODE
LOWfire/console/platforms.py141CODE
LOWfire/console/platforms.py421CODE
LOWfire/console/console_attr_os.py158CODE
LOWfire/console/console_attr_os.py165CODE
LOWfire/console/console_pager.py169CODE
Fake / Example Data8 hits · 12 pts
SeverityFileLineSnippetContext
LOW⚡fire/custom_descriptions_test.py44 component = 'Lorem ipsum dolor sit amet'CODE
LOW⚡fire/custom_descriptions_test.py44 component = 'Lorem ipsum dolor sit amet'CODE
LOW⚡fire/custom_descriptions_test.py56 component = 'Lorem ipsum dolor sit amet'CODE
LOW⚡fire/custom_descriptions_test.py56 component = 'Lorem ipsum dolor sit amet'CODE
LOW⚡fire/custom_descriptions_test.py62 component = 'Lorem ipsum dolor sit amet'CODE
LOW⚡fire/custom_descriptions_test.py62 component = 'Lorem ipsum dolor sit amet'CODE
LOW⚡fire/custom_descriptions_test.py65 self.assertEqual(description, 'The string "Lorem ipsum dolor sit amet"')CODE
LOW⚡fire/custom_descriptions_test.py65 self.assertEqual(description, 'The string "Lorem ipsum dolor sit amet"')CODE
Redundant / Tautological Comments4 hits · 6 pts
SeverityFileLineSnippetContext
LOWfire/core.py221 # Check if --help would be consumed as a keyword argument, or is a member.COMMENT
LOWfire/helptext.py196 # Check if positional args are allowed. If not, require flag syntax for args.COMMENT
LOWfire/helptext.py336 # Check if positional args are allowed. If not, require flag syntax for args.COMMENT
LOWfire/helptext.py708 # Check if positional args are allowed. If not, show flag syntax for args.COMMENT
Self-Referential Comments2 hits · 4 pts
SeverityFileLineSnippetContext
MEDIUMfire/formatting_windows.py15"""This module is used for enabling formatting on Windows."""STRING
MEDIUMfire/console/platforms.py371 # Create a new session with the new process the group leader.COMMENT
AI Structural Patterns2 hits · 2 pts
SeverityFileLineSnippetContext
LOWfire/trace.py246CODE
LOWfire/core.py164CODE
Excessive Try-Catch Wrapping1 hit · 1 pts
SeverityFileLineSnippetContext
LOWfire/inspectutils.py109 except Exception:CODE
Modern Structural Boilerplate1 hit · 1 pts
SeverityFileLineSnippetContext
LOWfire/__init__.py19__all__ = ['Fire']CODE