Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BBH pipeline: prompt to edit README.md #6454

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from

Conversation

nilsvu
Copy link
Member

@nilsvu nilsvu commented Jan 24, 2025

Proposed changes

When starting runs, prompt to edit the README.md file. I hope this helps keeping better track of notes for each run. Can be disabled on the command line.

Upgrade instructions

Code review checklist

  • The code is documented and the documentation renders correctly. Run
    make doc to generate the documentation locally into BUILD_DIR/docs/html.
    Then open index.html.
  • The code follows the stylistic and code quality guidelines listed in the
    code review guide.
  • The PR lists upgrade instructions and is labeled bugfix or
    new feature if appropriate.

Further comments

@nilsvu nilsvu added the cli/pybindings Command line interface & Python bindings label Jan 24, 2025
@nilsvu nilsvu requested a review from knelli2 January 24, 2025 08:39
Copy link
Contributor

@knelli2 knelli2 left a comment

Choose a reason for hiding this comment

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

Tests are failing because everything is being p

Comment on lines 425 to +426
MaxIts: 100
Verbosity: Quiet
Verbosity: Silent
Copy link
Contributor

Choose a reason for hiding this comment

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

Leave these as quiet. We don't write this information out anywhere else (even though maybe we should) and it's useful to know. Also, it's not affecting performance (that I know of)

Comment on lines +409 to +413
"--edit-readme/--no-edit-readme",
default=None,
help=(
"Edit the README file in the pipeline directory or run directory. "
"If not specified, a prompt will ask whether to edit the README."
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not a huge fan of always being prompted for this. I'd like the option, but just not being forced to do it by default. I think this should just be a bool that defaults to false.

Copy link
Member Author

Choose a reason for hiding this comment

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

Without the prompt there's little point to have the option. The idea is to encourage writing notes into a readme file.

Comment on lines +408 to +416
# Edit README
readme = (
Path(pipeline_dir or segments_dir or run_dir or Path.cwd())
/ "README.md"
)
if edit_readme or (
edit_readme is None and click.confirm(f"Edit {readme}?", default=True)
):
click.edit(filename=readme)
Copy link
Contributor

Choose a reason for hiding this comment

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

Is there a way to not repeat this or the click option multiple times?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cli/pybindings Command line interface & Python bindings
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants