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

Change the primary name of the console script to setuptools-pyproject-migration #127

Merged
merged 5 commits into from
Dec 6, 2023

Conversation

diazona
Copy link
Owner

@diazona diazona commented Dec 5, 2023

This PR changes the name of the console script that users should use to match the name of the package, setuptools-pyproject-migration, to support pipx run.

We could have kept multiple console script names, but I thought that was more confusion than it's worth.

The intent will be to remove the old console script name in some future version, though I'm not sure if it makes sense to advertise a specific version in which it will be removed or how long we should wait before actually removing it. (Especially given that it didn't even seem to work properly, see #100)

Closes #107

In this commit I'm changing the primary name of the console script to
match the name of the package, setuptools-pyproject-migration. This will
allow people to run the program directly with
  pipx run setuptools-pyproject-migration
without an explicit installation step.

We could keep both console script names, but I think that's going to be
more confusion than it's worth, so I've marked the old name
setup-to-pyproject as deprecated. This was simply done by writing
a wrapper function that issues a FutureWarning and redirecting the old
console script name to call it. (Our users don't need anything fancy.)
I added a couple tests to verify that the deprecated script emits
the expected FutureWarning and that it invokes the plugin. Since
the plan is to remove this console script name after a while, I didn't
bother to write extensive tests for it.
@diazona diazona added this to the v0.2 milestone Dec 5, 2023
@diazona diazona requested a review from sjlongland December 5, 2023 18:11
@diazona
Copy link
Owner Author

diazona commented Dec 5, 2023

I know we had a bit of discussion about this on the issue so I'm happy to iterate on this change if we could/should be doing it a different way.

@sjlongland sjlongland merged commit 2687d31 into main Dec 6, 2023
11 checks passed
@sjlongland sjlongland deleted the console-script/2/dev branch December 6, 2023 11:25
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.

Change name of console script to match name of package
2 participants