Skip to content

Fix docstring Args entries that name a parameter the function does not take - #24925

Merged
harupy merged 1 commit into
mlflow:masterfrom
darkdi:fix/docstring-arg-names
Aug 13, 2026
Merged

harupy merged 1 commit into
mlflow:masterfrom
darkdi:fix/docstring-arg-names

Conversation

@darkdi

@darkdi darkdi commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Related Issues/PRs

Relates to no existing issue — found by reading Args: blocks against the signatures they sit above.

What changes are proposed in this pull request?

Twenty Args: entries name a parameter the function does not take. Docstrings only; no signature, no behaviour, no test touched.

Seven are renames where the docstring kept the old name:

Where Documented Actual
MetaDataset schame schema (typo)
DatabricksApp table_name app_name
DatabricksJobRunner databricks_profile databricks_profile_uri
_get_temporary_model_version_write_credentials_oss name model_name
_upgrade_db url engine
AsyncArtifactsLoggingQueue logging_func artifact_logging_func
_run_download_artifact_command command args

_upgrade_db needed a new description as well as a new name — the old entry described a database URL string, and the argument is a SQLAlchemy engine.

The rest document a parameter that no longer exists: f and span_name in AG2Logger._get_patch_function, raw_model in _extract_predict_fn, fit_args and fit_kwargs in the three mlflow/sklearn/utils.py helpers, path in SqlAlchemyStore._set_tags, manager in _export_spans_incrementally, extras in _get_pinned_requirement, and id_length in _generate_unique_integer_id, which takes no arguments at all.

Two things I noticed but did not touch, since they are a different kind of fix and yours to judge:

  • DatabricksApp's summary is a verbatim copy of DatabricksTable's — it still says "Defines a Databricks Unity Catalog (UC) Table". I only corrected the argument name.
  • The Steps: prose in the three mlflow/sklearn/utils.py helpers still says "Extract X and y_true from fit_args and fit_kwargs", which predates the refactor that made X and y_true direct arguments.

How is this PR tested?

  • Existing unit/integration tests
  • New unit/integration tests
  • Manual tests

Every entry was opened and read against its signature. ruff check and ruff format --check pass on all fourteen files with the pinned ruff==0.16.0.

Does this PR require documentation update?

  • No.
  • Yes. I've updated:
    • Examples
    • API references
    • Instructions

Does this PR require updating the MLflow Skills repository?

  • No.

Release Notes

Is this a user-facing change?

  • No.

What component(s), interfaces, languages, and integrations does this PR affect?

Components

  • area/docs: MLflow documentation pages

How should the PR be classified in the release notes? Choose one:

  • rn/none - No description will be included. The PR will be mentioned only by the PR number in the "Small Bugfixes and Documentation Updates" section

Is this PR a critical bugfix or security fix that should go into the next patch release?

  • This PR is critical and needs to be in the next patch release
  • This PR can wait for the next minor release

Copilot AI balanced review requested due to automatic review settings August 6, 2026 00:29
@github-actions github-actions Bot added community Community/external contribution size/S Small PR (10-49 LoC) labels Aug 6, 2026
@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor
Install mlflow from this PR

Install mlflow from this PR

# mlflow
pip install git+https://github.com/mlflow/mlflow.git@refs/pull/24925/merge
# mlflow-skinny
pip install git+https://github.com/mlflow/mlflow.git@refs/pull/24925/merge#subdirectory=libs/skinny

For Databricks, use the following command:

%sh curl -LsSf https://raw.githubusercontent.com/mlflow/mlflow/HEAD/dev/install-skinny.sh | sh -s pull/24925/merge

PR author's recent activity

In the last 14 days, @darkdi opened 24 PRs across 19 repos (showing top 10):

Repository Open Closed Merged Total
bagisto/bagisto 0 0 3 3
astropy/astropy 1 0 1 2
statamic/cms 0 0 2 2
raycast/extensions 1 0 1 2
mlflow/mlflow 1 0 0 1
Textualize/textual 1 0 0 1
langflow-ai/langflow 1 0 0 1
lightgbm-org/LightGBM 1 0 0 1
karpovantonme/driftkit 1 0 0 1
tesseract-ocr/tesseract 1 0 0 1

@github-actions github-actions Bot added area/docs Documentation issues rn/none List under Small Changes in Changelogs. labels Aug 6, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Corrects stale or invalid parameter names in Python docstrings without changing runtime behavior.

Changes:

  • Renames seven outdated or misspelled Args entries.
  • Removes documentation for parameters no longer accepted.
  • Updates _upgrade_db’s parameter description for its SQLAlchemy engine.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated no comments.

Show a summary per file
File Description
tests/store/artifact/test_cli.py Corrects the helper argument name.
mlflow/utils/requirements_utils.py Removes the obsolete extras entry.
mlflow/utils/name_utils.py Removes the nonexistent id_length entry.
mlflow/utils/async_logging/async_artifacts_logging_queue.py Corrects the callback parameter name.
mlflow/tracing/export/mlflow_v3.py Removes the obsolete manager entry.
mlflow/store/tracking/sqlalchemy_store.py Removes the obsolete path entry.
mlflow/store/db/utils.py Documents the actual engine parameter.
mlflow/store/_unity_catalog/registry/uc_oss_rest_store.py Corrects the model-name parameter.
mlflow/sklearn/utils.py Removes obsolete fit-argument entries.
mlflow/projects/databricks.py Corrects the profile URI parameter.
mlflow/models/resources.py Corrects the application-name parameter.
mlflow/models/evaluation/default_evaluator.py Removes the nonexistent raw_model entry.
mlflow/data/meta_dataset.py Fixes the schema parameter typo.
mlflow/ag2/ag2_logger.py Removes obsolete patch-function entries.

@harupy
harupy enabled auto-merge (squash) August 13, 2026 10:18
@github-actions

Copy link
Copy Markdown
Contributor

Documentation preview for 56ddc62 is available at:

More info
  • Ignore this comment if this PR does not change the documentation.
  • The preview is updated when a new commit is pushed to this PR.
  • This comment was created by this workflow run.
  • The documentation was built by this workflow run.

@harupy
harupy merged commit 6bc06f1 into mlflow:master Aug 13, 2026
91 of 105 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation issues community Community/external contribution rn/none List under Small Changes in Changelogs. size/S Small PR (10-49 LoC)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants