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

Update documentation on setting up shell completions #3183

Merged
merged 5 commits into from
Sep 26, 2024

Conversation

fossterer
Copy link
Contributor

@fossterer fossterer commented Sep 25, 2024

Pull Request Checklist

  • A news fragment is added in news/ describing what is new.
  • Test cases added for changed code.

Describe what you have changed in this PR.

I was not able to setup shell completion in my 'Bash' shell until I ran into python-poetry/poetry#2295

My submission is a solution that worked without any issues for me

I was not able to setup shell completion in my 'Bash' shell until I ran into python-poetry/poetry#2295

My submission is a solution that worked without any issues for me
@frostming
Copy link
Collaborator

frostming commented Sep 25, 2024

You are responsible for setting up the bash completion correctly that loads script from that location.

Your solution works, but it brings extra overhead every time you start a new shell.


You may list it as an alternative solution instead of overwriting the original.

@fossterer fossterer marked this pull request as ready for review September 25, 2024 01:40
@fossterer
Copy link
Contributor Author

Thanks for the review frostming!

I updated the script to list this non-sudo variant as an alternative. Please check now

CONTRIBUTING.md Outdated
PDM docs development requires a few dependencies. Install them as:

```bash
sudo apt install mkdocs # Or equivalent with the package manager of your choice
Copy link
Collaborator

Choose a reason for hiding this comment

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

Why do we need to install mkdocs when it is already specified in pyproject.toml

Copy link
Contributor Author

@fossterer fossterer Sep 26, 2024

Choose a reason for hiding this comment

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

I agree.

I directly started at https://github.com/pdm-project/pdm/blob/main/CONTRIBUTING.md#preview-the-documentation which threw me the mkdocs problem.
I later ran into too many other missing things at which point I realized I missed https://github.com/pdm-project/pdm/blob/main/CONTRIBUTING.md#local-development.

I read pyproject.toml. Removed this mkdocs requirement now.
Please check

@frostming frostming merged commit 16933a1 into pdm-project:main Sep 26, 2024
2 checks passed
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.

2 participants