Skip to content

Improve_quality_fixes: missing docstrings, and raised exceptions missing from docstrings#4462

Draft
clmould wants to merge 7 commits into
mainfrom
improve_quality_fixes
Draft

Improve_quality_fixes: missing docstrings, and raised exceptions missing from docstrings#4462
clmould wants to merge 7 commits into
mainfrom
improve_quality_fixes

Conversation

@clmould

@clmould clmould commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

Description

Some more improve_quality_fixes - currently focussing on missing docstrings, and raised exceptions missing from docstrings

Having to leave some:
Missing ProcessValueError in peak_b_field_at_pf_coil - from the way this error is currently written, I can't determine concisely why it is being raised (#4467 should make the ProcessValueError clearer, then this can be documented in the docstring)

Missing BadParameter in process_cli - if I included this in the docstring, it would appear in the process --help menu

Checklist

I confirm that I have completed the following checks:

  • My changes follow the PROCESS style guide
  • I have justified any large differences in the regression tests caused by this pull request in the comments.
  • I have added new tests where appropriate for the changes I have made.
  • If I have had to change any existing unit or integration tests, I have justified this change in the pull request comments.
  • If I have made documentation changes, I have checked they render correctly.
  • I have added documentation for my change, if appropriate.

@clmould
clmould force-pushed the improve_quality_fixes branch from 12e6870 to d7b6c83 Compare July 23, 2026 17:44
@codecov-commenter

codecov-commenter commented Jul 23, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 48.68%. Comparing base (84679f5) to head (143ca08).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #4462      +/-   ##
==========================================
+ Coverage   48.64%   48.68%   +0.03%     
==========================================
  Files         151      151              
  Lines       29703    29724      +21     
==========================================
+ Hits        14449    14470      +21     
  Misses      15254    15254              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@clmould
clmould force-pushed the improve_quality_fixes branch from f5737c1 to 1b831b9 Compare July 23, 2026 17:57
@@ -1125,15 +1137,7 @@ def calculate_croco_cable_geometry(
Returns
-------
CroCoCableGeometry

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

You dont need the type here it will be autofilled by the function definition by ide's and docs

Suggested change
CroCoCableGeometry
:

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.

3 participants