Skip to content

Rename base_name => basename for consistency's sake #5990

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

Merged
merged 2 commits into from
Jul 6, 2018

Conversation

rpkilby
Copy link
Member

@rpkilby rpkilby commented May 16, 2018

The viewsets and routers use both base_name and basename. It would be nice if this were consistent.

I've deprecated base_name in favor of basename, and get_default_base_name in favor of get_default_basename. Fortunately, the deprecation is fairly straightforward.

  • Router.register needs to handle both arguments appropriately (fallback to the old value if present, raise deprecation warnings, complain if both arguments are provided)
  • Django has a deprecation utility metaclass that already handles method renames.

@tomchristie
Copy link
Member

Seems fair enough, yup.

Given that we work against master we typically don't pull in deprecation changes until we're confident that the next release will be one of the major version bumps. I guess we could leave this on hold until we're getting ready to release 3.9

@rpkilby
Copy link
Member Author

rpkilby commented May 21, 2018

Makes sense to me. Adding it to the milestone.

@rpkilby rpkilby added this to the 3.9 Release milestone May 21, 2018
@@ -65,7 +65,7 @@ For example, you can append `router.urls` to a list of existing views…

urlpatterns += router.urls

Alternatively you can use Django's `include` function, like so
Alternatively you can use Django's `include` function, like so...
Copy link
Collaborator

Choose a reason for hiding this comment

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

Why don't you like ?

Copy link
Member Author

Choose a reason for hiding this comment

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

Oh - that was unintentional. I have a plugin that converts magic quotes to their ascii equivalent, but it also catches ellipses apparently.

Copy link
Collaborator

@carltongibson carltongibson left a comment

Choose a reason for hiding this comment

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

OK. Let's have this. 👍

@carltongibson carltongibson merged commit 7095021 into encode:master Jul 6, 2018
@rpkilby rpkilby deleted the basename branch July 6, 2018 14:21
@minusf
Copy link
Contributor

minusf commented Sep 14, 2018

This is very confusing at the moment. The online docs already talk only about basename while the last PyPi released version expects base_name.

I understand that the online docs are not versioned like the django ones, but I think in that case they should be either clearly marked as DEV, or they should follow the latest stable release, used in production environments...

@carltongibson
Copy link
Collaborator

@minusf Yes. That's not great. A recent docs roll-out will have updated this. I'll see if I can patch-up something correct for the time before v3.9.

@carltongibson
Copy link
Collaborator

@minusf I've redeployed the docs. They look correct for v3.8 now. Thanks for pinging in the issue.

@minusf
Copy link
Contributor

minusf commented Sep 14, 2018

thanks for looking into this.

kmohrf pushed a commit to grouprise/grouprise that referenced this pull request Jul 12, 2020
djangorestframework v3.9 deprecated the keyword argument "base_name" for
routers.  The old name works up to djangorestframework 3.10, but fails
later.

See encode/django-rest-framework#5990
pchiquet pushed a commit to pchiquet/django-rest-framework that referenced this pull request Nov 17, 2020
* Rename base_name => basename for consistency

* Update tests to use basename
slamora added a commit to ribaguifi/django-orchestra that referenced this pull request Jul 8, 2021
jsugarman added a commit to ministryofjustice/laa-fee-calculator that referenced this pull request Feb 4, 2022
jsugarman added a commit to ministryofjustice/laa-fee-calculator that referenced this pull request Feb 7, 2022
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.

4 participants