18     'Package',
32 Package = Union[str, ModuleType]  variable
43 def _get_package(package) -> ModuleType:  argument
44     """Take a package name or module object and return the module.
47     object is not a package, raise an exception.
49     module = _resolve(package)
51         raise TypeError('{!r} is not a package'.format(package))
67         package: ModuleType) -> Optional[resources_abc.ResourceReader]:
68     # Return the package's loader if it's a ResourceReader.  We can't use
73     spec = package.__spec__
80 def _check_location(package):  argument
81     if package.__spec__.origin is None or not package.__spec__.has_location:
82         raise FileNotFoundError(f'Package has no location {package!r}')
85 def open_binary(package: Package, resource: Resource) -> BinaryIO:  argument
88     package = _get_package(package)
89     reader = _get_resource_reader(package)
93         package.__spec__.origin or 'non-existent file')
102         loader = cast(ResourceLoader, package.__spec__.loader)
104         if hasattr(package.__spec__.loader, 'get_data'):
108             package_name = package.__spec__.name
115 def open_text(package: Package,  argument
121         open_binary(package, resource), encoding=encoding, errors=errors)
124 def read_binary(package: Package, resource: Resource) -> bytes:  argument
126     with open_binary(package, resource) as fp:
130 def read_text(package: Package,  argument
139     with open_text(package, resource, encoding, errors) as fp:
143 def files(package: Package) -> resources_abc.Traversable:  argument
145     Get a Traversable resource from a package
147     return _common.from_package(_get_package(package))
151         package: Package, resource: Resource,  argument
161     reader = _get_resource_reader(_get_package(package))
165         _common.as_file(files(package).joinpath(_normalize_path(resource)))
180 def is_resource(package: Package, name: str) -> bool:  argument
181     """True if 'name' is a resource inside 'package'.
185     package = _get_package(package)
187     reader = _get_resource_reader(package)
190     package_contents = set(contents(package))
193     return (_common.from_package(package) / name).is_file()
196 def contents(package: Package) -> Iterable[str]:  argument
197     """Return an iterable of entries in 'package'.
203     package = _get_package(package)
204     reader = _get_resource_reader(package)
207     # Is the package a namespace package?  By definition, namespace packages
210         package.__spec__.origin is None or
211         package.__spec__.origin == 'namespace'
213     if namespace or not package.__spec__.has_location:
215     return list(item.name for item in _common.from_package(package).iterdir())