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

pydocstyle is deprecated; GitHub repo has been archived #561

Open
penguinpee opened this issue May 19, 2024 · 6 comments
Open

pydocstyle is deprecated; GitHub repo has been archived #561

penguinpee opened this issue May 19, 2024 · 6 comments

Comments

@penguinpee
Copy link
Contributor

I just noticed that the maintainer of pydocstyle in Fedora has retired the package with a note that upstream abandoned the project. The GitHub repo has been archived as of Nov 3, 2023:

The Pydocstyle project is officially deprecated, and it is no longer actively maintained.

Are there any plans of replacing it? It's listed as a dependency of the all extra, which in turn spyder depends on.

@michalspano
Copy link

Good catch, I noticed the same.

@penguinpee
Copy link
Contributor Author

Upstream recommends using ruff. It feels a bit overkill using that only for checking docstrings. It could easily replace other linters like flake8, black etc. as well.

Some guidance as to possible replacement candidates would be helpful.

@ccordoba12
Copy link
Member

ccordoba12 commented May 31, 2024

Hey @penguinpee, thanks for reporting. You said:

Are there any plans of replacing it? It's listed as a dependency of the all extra, which in turn spyder depends on.

Not for now, and sorry to say it, but I think the decision you mentioned breaks Spyder's code completion and linting in Fedora.

Upstream recommends using ruff. It feels a bit overkill using that only for checking docstrings.

Agreed. Furthermore, I don't think ruff options map exactly to Pydocstyle ones.

Some guidance as to possible replacement candidates would be helpful.

I don't think there's a direct replacement and we're not going to address this here nor in Spyder for at least six months (perhaps more) because the package is still working (even if not actively developed).

So, I guess your only choice is to patch pylsp and Spyder in Fedora to make things work without Pydocstyle.

@penguinpee
Copy link
Contributor Author

Thanks for the reply @ccordoba12. If push comes to shove I will have to bite the bullet. But first I will try to get maintenance of pydocstyle transferred to me and resurrect the package.

I'll leave it to you to keep this ticket open as a reminder or close it as deferred.

@ccordoba12
Copy link
Member

But first I will try to get maintenance of pydocstyle transferred to me and resurrect the package.

That's a good idea and will save you from a lot of trouble.

I'll leave it to you to keep this ticket open as a reminder or close it as deferred.

I'll leave it open to not forget to address it in a later release.

@penguinpee
Copy link
Contributor Author

I was looking at the python-lsp-ruff plugin and what it would take to make that available in Spyder akin to python-lsp-black, when I came across this snippet:

'ruff': {
    # Disable it until we have a graphical option for users to
    # enable it.
    'enabled': False,
},

Is this part of spyder-ide/spyder#21357 or spyder-ide/spyder#21040?

I'll be reading through the plugin development documentation next. But before embarking on this adventure, if I feel up to it, I just wanted to make sure, I'm not starting on a project that someone else is already working on.

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

No branches or pull requests

3 participants