Skip to content

electrostatics: fix ELC delta_mid_bot docstring typo (bug-sweep #54)#5377

Draft
RudolfWeeber wants to merge 1 commit into
espressomd:pythonfrom
RudolfWeeber:fix/bug-54-elc-delta-mid-bot-doc
Draft

electrostatics: fix ELC delta_mid_bot docstring typo (bug-sweep #54)#5377
RudolfWeeber wants to merge 1 commit into
espressomd:pythonfrom
RudolfWeeber:fix/bug-54-elc-delta-mid-bot-doc

Conversation

@RudolfWeeber

Copy link
Copy Markdown
Contributor

The ELC parameter-list docstring documented 'delta_mid_bottom', but the
accepted parameter name (used by default_params(), the script-interface
AutoParameters/constructor, the docstring's own prose, the Sphinx docs,
the tutorials, and every testsuite usage) is 'delta_mid_bot'. A user
following the documented name hit a RuntimeError
"Parameter 'delta_mid_bottom' is not a valid parameter".

Fix the docstring to the established public name 'delta_mid_bot' (the
checkpoint-serialized name). Add a docstring-consistency test in
coulomb_interface.py that parses the ELC "Parameters" block and asserts
every documented field is an accepted parameter (a key of
default_params() or a member of required_keys()).

Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com

🤖 Generated with Claude Code

The ELC parameter-list docstring documented 'delta_mid_bottom', but the
accepted parameter name (used by default_params(), the script-interface
AutoParameters/constructor, the docstring's own prose, the Sphinx docs,
the tutorials, and every testsuite usage) is 'delta_mid_bot'. A user
following the documented name hit a RuntimeError
"Parameter 'delta_mid_bottom' is not a valid parameter".

Fix the docstring to the established public name 'delta_mid_bot' (the
checkpoint-serialized name). Add a docstring-consistency test in
coulomb_interface.py that parses the ELC "Parameters" block and asserts
every documented field is an accepted parameter (a key of
default_params() or a member of required_keys()).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@RudolfWeeber

Copy link
Copy Markdown
Contributor Author

Again,, the docstring fix is proabbly valid, but the testcase is over the top.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant