pythonowy sposób pisać pakiet na łatwe importowanie

Question

Mam bardzo prosty pakiet, który w końcu chcesz zwolnić poprzez PyPI, który ma drzewo katalogów tak:

daterangeparser/ 
    __init__.py 
    parse_date_range.py 
    test.py 

parse_date_range.py definiuje funkcję o nazwie parse.

Jaki jest najprostszy i najbardziej pythonic sposób, aby skonfigurować pakiet do łatwego importowania funkcji parse i jak mogę to zrobić?

W tej chwili muszę zrobić from daterangeparser.parse_date_range import parse co wydaje się raczej niezgrabne. Wolę zrobić from daterangeparser import parse, co wydaje się prostsze i bardziej pythonic, ale nie mogę wydawać się pracować, jak sprawić, aby to działało (czy muszę umieścić coś innego w __init__.py? Czy istnieje lepszy sposób na zrobienie tego ?

Answer 1

Czy naprawdę potrzebujesz modułu parse_date_range? Nazwa pakietu daterangeparser już przekazuje intencję, daterangeparser.parse_date_range nie ma żadnego sensu.

można przenieść cały kod z modułu parse_date_range do __init__ a następnie można zaimportować parse jak from daterangeparser import parse.

Answer 2

można po prostu dodać:

from .parse_date_range import parse 

do __init__.py aby umożliwić użycie tego to najlepszy sposób

można również podać bezwzględną importu, jeśli chciał..

from daterangeparser.parse_date_range import parse 

Każda z tych opcji umieszcza funkcję parse() w przestrzeni nazw , co jest tym, czego potrzebujesz.

Answer 3

umieścić następujące w __init__.py:

from daterangeparser.parse_date_range import parse 

Następnie można importować tak, jak chcesz.