Remove deprecated parameter alias for importlib.resources.files

Argument name was replaced from package to anchor for Python 3.12.0a4 in PR #100598, and comment to remove this compatibility was added separately in PR #117054, both by @jaraco.
Looks like it was missed so I suggest to remove this compatibility.

Docs: https://docs.python.org/dev/library/importlib.resources.html#importlib.resources.files
Source:

cpython/Lib/importlib/resources/_common.py

Lines 19 to 56 in 5a7f5ea

    
           def package_to_anchor(func): 
        
               """ 
        
               Replace 'package' parameter as 'anchor' and warn about the change. 
        
               Other errors should fall through. 
        
               >>> files('a', 'b') 
        
               Traceback (most recent call last): 
        
               TypeError: files() takes from 0 to 1 positional arguments but 2 were given 
        
               Remove this compatibility in Python 3.14. 
        
               """ 
        
               undefined = object() 
        
               @functools.wraps(func) 
        
               def wrapper(anchor=undefined, package=undefined): 
        
                   if package is not undefined: 
        
                       if anchor is not undefined: 
        
                           return func(anchor, package) 
        
                       warnings.warn( 
        
                           "First parameter to files is renamed to 'anchor'", 
        
                           DeprecationWarning, 
        
                           stacklevel=2, 
        
                       ) 
        
                       return func(package) 
        
                   elif anchor is undefined: 
        
                       return func() 
        
                   return func(anchor) 
        
               return wrapper 
        
           @package_to_anchor 
        
           def files(anchor: Optional[Anchor] = None) -> Traversable: 
        
               """ 
        
               Get a Traversable resource for an anchor. 
        
               """ 
        
               return from_package(resolve(anchor))

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Remove deprecated parameter alias for `importlib.resources.files` #138044

Linked PRs

Metadata

Assignees

Labels

Fields

Projects

Milestone

Relationships

Development

	def package_to_anchor(func):
	"""
	Replace 'package' parameter as 'anchor' and warn about the change.

	Other errors should fall through.

	>>> files('a', 'b')
	Traceback (most recent call last):
	TypeError: files() takes from 0 to 1 positional arguments but 2 were given

	Remove this compatibility in Python 3.14.
	"""
	undefined = object()

	@functools.wraps(func)
	def wrapper(anchor=undefined, package=undefined):
	if package is not undefined:
	if anchor is not undefined:
	return func(anchor, package)
	warnings.warn(
	"First parameter to files is renamed to 'anchor'",
	DeprecationWarning,
	stacklevel=2,
	)
	return func(package)
	elif anchor is undefined:
	return func()
	return func(anchor)

	return wrapper


	@package_to_anchor
	def files(anchor: Optional[Anchor] = None) -> Traversable:
	"""
	Get a Traversable resource for an anchor.
	"""
	return from_package(resolve(anchor))

Search code, repositories, users, issues, pull requests...

Uh oh!

Remove deprecated parameter alias for importlib.resources.files #138044

Description

Linked PRs

Metadata

Metadata

Assignees

Labels

Fields

Projects

Milestone

Relationships

Development

Issue actions

Remove deprecated parameter alias for `importlib.resources.files` #138044