packagedata 1.2.0

Reading Text Files

Change:

from pkg_resources import resource_string
text = resource_string(__package__, 'data/README.txt').decode('utf-8')

To:

import packagedata as pkgdata
text = pkgdata.read_text(__package__, 'data/README.txt', encoding='utf-8')

Then, eventually, when you can, change it to:

from importlib import resources
text = resources.read_text(__package__, 'data/README.txt', encoding='utf-8')

Reading Binary Files

Change:

from pkg_resources import resource_string
data = resource_string(__package__, 'assets/icon.ico')

To:

import packagedata as pkgdata
data = pkgdata.read_bytes(__package__, 'assets/icon.ico')

Then, eventually, when you can, change it to:

from importlib import resources
data = resources.read_binary(__package__, 'assets/icon.ico')

Getting File Paths

Change:

import os
import os.path
from pkg_resources import resource_filename
templates_path = resource_filename(__package__, 'templates')
for filename in os.listdir(templates_path):
    filepath = os.path.join(templates_path, filename)
    print(filepath)

To:

import packagedata as pkgdata
with pkgdata.as_path(__package__, 'templates') as templates_path:
    for filepath in templates_path.iterdir():
        print(filepath)

Then, eventually, when you can, change it to:

from importlib import resources
with resources.as_file(
    resources.files(__package__).joinpath('templates')
) as templates_path:
    for filepath in templates_path.iterdir():
        print(filepath)

Entry Points

Change:

from pkg_resources import iter_entry_points
for ep in iter_entry_points('my_entry_point_group'):
    print(f"{ep.name}: {ep.module_name}:{ep.attrs}")
    plugin = ep.load()

To:

import packagedata as pkgdata
for ep in pkgdata.entry_points('my_entry_point_group'):
    print(f"{ep.name}: {ep.value}")
    plugin = ep.load()

Then, eventually, when you can, change it to:

from importlib import metadata
for ep in metadata.entry_points().select(group='my_entry_point_group'):
    print(f"{ep.name}: {ep.value}")
    plugin = ep.load()

Note on compatibility:

The packagedata.entry_points() function handles API differences between Python versions:

• Python 3.10+: Uses the new EntryPoints.select() method.

• Python 3.7-3.9: Uses the legacy dict-like interface.

So while no “selectable” entry points are exposed, the same code works across all supported Python versions and mimics the pkg_resources behavior.