Title is kinda confusing, but basically, I followed the Python packaging process to set up my Python package development environment. My project structure is layed out the same, except for a .venv in the root directory (not in src), and additional Python files in the src/package_username directory.

I can build my package fine, but when I go to import it into other projects, I have to import it like import package_username.file or from package_username.file import SomethingInFile. For other python packages, I would only need to do import package or from package import Something.

How can I set up by build process to remove the need for the first portion in my import statements so it matches other packages like termcolor? Is there something I need to add in my __init__.py file?

    • AstroLightz@lemmy.worldOP
      link
      fedilink
      arrow-up
      3
      ·
      4 days ago

      I looked at the guide you linked. So in my __init__.py file, I should import each public name I want from my files, then add them to the __all__ list like this? (I want to make sure I understood the guide correctly)

      from file_1 import SomeClass
      from file_2 import AnotherClass
      
      __all__ = [
          "SomeClass",
          "AnotherClass",
      ]
      
      • Eager Eagle@lemmy.world
        link
        fedilink
        English
        arrow-up
        4
        ·
        edit-2
        4 days ago

        right, those names are also useful when importing your package in tests

        you can also create a __version__ string and append it to __all__ to have a mypackage.__version__

        to pull version from pyproject.toml:

        LIB_NAME: str = "mypackage"
        __version__ = importlib.metadata.version(LIB_NAME)
        
        ...
        
        __all__ = [
            "__version__",
            ...
        ]
        
  • dgdft@lemmy.world
    link
    fedilink
    English
    arrow-up
    4
    ·
    4 days ago

    You’re barking up the right tree. Add a relative import call to your top-level __init__.py and they’ll get namespaced in the way you’re wanting.

    E.g. adding from .file import SomethingInFile as Newthing will let you run import package and reference package.Newthing.

    See the docs for the __all__ dunder as well.

  • logging_strict@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    3 days ago

    Better have a damn good reason to import everything into the package level namespace.

    The reasoning sqlalchemy has is to prepare beforehand to be able to run in multiple threads without needing to import anything. Importing is slow and should be done up front.

    So there is a slight delay when importing sqlalchemy.

    Keep in mind, the sqlalchemy author and maintainers are waaaaaaay smarter than you and I. py315 may level the play field ever so slightly.

    py315 is supposed to introduce soft import. So wait for that and then everyone jump ship like every previous version has rabies.

  • bobtimus_prime@feddit.org
    link
    fedilink
    arrow-up
    2
    ·
    4 days ago

    I don’t think that there are any other options than renaming ‘src/package_username’ to ‘src/package’. But even if there was, I would advice against it.