setuptools: расположение папки данных пакета

Вариант 1: установить, как данные пакета

основное преимущество размещения файлов данных внутри корня вашего пакета Python это позволяет не беспокоиться о том, где файлы будут жить на пользователя система, которая может быть Windows, Mac, Linux, некоторые мобильные платформы, или внутри яйца. Вы можете всегда находите каталог data относительно вашего корня пакета Python, независимо от того, где и как он установлен.

например, если у меня есть проект макет вроде так:

project/
    foo/
        __init__.py
        data/
            resource1/
                foo.txt

вы можете добавить функцию __init__.py найти абсолютный путь к данным файл:

import os

_ROOT = os.path.abspath(os.path.dirname(__file__))
def get_data(path):
    return os.path.join(_ROOT, 'data', path)

print get_data('resource1/foo.txt')

выходы:

/Users/pat/project/foo/data/resource1/foo.txt

после установки проекта в виде яйца путь к data изменится, но код не нужно менять:

/Users/pat/virtenv/foo/lib/python2.6/site-packages/foo-0.0.0-py2.6.egg/foo/data/resource1/foo.txt

---

Вариант 2: установить в определенном месте

альтернативой было бы разместить ваши данные вне пакета Python и затем либо:

1. имеет место data передается через файл конфигурации, аргументы командной строки или
2. вставьте местоположение в свой код Python.

это гораздо менее желательно, если вы планируете распространять свой проект. Если вы действительно хотите сделать это, вы можете установить свой data везде, где вы хотите на целевой системе, указав место назначения для каждой группы файлов, передавая в списке кортежи:

from setuptools import setup
setup(
    ...
    data_files=[
        ('/var/data1', ['data/foo.txt']),
        ('/var/data2', ['data/bar.txt'])
        ]
    )

Обновлено: пример функции оболочки для рекурсивно grep Python файлов:

atlas% function grep_py { find . -name '*.py' -exec grep -Hn $* {} \; }
atlas% grep_py ": \["
./setup.py:9:    package_data={'foo': ['data/resource1/foo.txt']}