Qu'est-ce que__import__('pkg_resources').declare_namespace (___nom_)` faire?

Dans certains __init__.py fichiers de modules je n'ai vu une seule ligne:

__import__('pkg_resources').declare_namespace(__name__)

Que fait-il et pourquoi les gens l'utilisent? Supposons que c'est lié à la dynamique de l'importation et de la création de l'espace de noms lors de l'exécution.

InformationsquelleAutor rsk | 2011-10-16
  1. 39

    Il se résume à deux choses:

    1. __import__ est une fonction Python qui va importer un package à l'aide d'une chaîne de caractères comme le nom du package. Il renvoie un nouvel objet qui représente le package importé. Donc foo = __import__('bar') d'importation d'un package nommé bar et stocker une référence à ses objets dans un objet local variable foo.

    2. À partir de l'installation utils pkg_resources' documentation, declare_namespace() "Déclarer[s] que le pointillé nom du package nom est un "espace de noms de package" dont le contenu des packages et modules peuvent être réparties entre plusieurs distributions."

    Donc __import__('pkg_resources').declare_namespace(__name__) à importer les 'pkg_resources' paquet dans un temporaire et d'appeler la declare_namespace fonction stockée dans que temporaire (le __import__ fonction est probablement utilisé plutôt que le import déclaration pour qu'il n'y a aucun symbole à gauche sur nom pkg_resources). Si ce code était en my_namespace/__init__.py, puis __name__ est my_namespace et ce module sera inclus dans le my_namespace espace de noms de package.

    Voir le outils de configuration documentation pour plus de détails

    Voir cette question pour la discussion sur l'ancien mécanisme pour atteindre le même effet.

    Voir PEP 420 pour le mécanisme normalisé qui offre des fonctionnalités similaires début avec Python 3.3.

    • import est une fonction Python, et non d'une déclaration.
    • Il fixe. Merci!
    • Quoi? Non! Ce n'est pas ce declare_namespace le fait. Il n'est pas juste de vider le contenu de la pkg_resources dans le module choisi d'espace de noms; pkg_resources est juste le module où declare_namespace vient de. Un paquet foo serait d'utiliser pkg_resources.declare_namespace(__name__) pour permettre sa mise en œuvre doit être divisé en plusieurs foo dossiers. Tirant le contenu de pkg_resources dans votre espace de noms serait totalement contre-productif.
    • pas sûr de ce que j'étais à ~5 ans. J'ai mis à jour la réponse en conséquence.
    InformationsquelleAutor Nathan
  2. 7

    C'est une façon de déclarer la soi-disant "espace de noms de paquets" en Python.

    Quelles sont-elles et quel est le problème:

    Imaginez que vous distribuer un produit logiciel qui a beaucoup de fonctionnalités, et pas tous les gens veulent tout avoir, si vous le découper en morceaux et de les expédier comme option plugins.

    Vous voulez les gens à être en mesure de faire

    import your_project.plugins.plugin1
import your_project.plugins.plugin2
...

    Qui est très bien si votre structure de répertoire est exactement comme ci-dessus, à savoir 

    your_project/
    __init__.py
    plugins/
        __init__.py
        plugin1.py
        plugin2.py

    Mais que faire si vous expédier ces deux plugins séparer les paquets python de sorte qu'ils sont situés dans deux répertoires différents? Puis vous pourriez vouloir mettre __import__('pkg_resources').declare_namespace(__name__) dans chaque paquet __init__.py de sorte que Python sait que les paquets qui font partie d'un plus grand "espace de noms de package", dans notre cas, c'est your_project.plugins.

    Veuillez vous référer à la la documentation pour plus d'info.

    InformationsquelleAutor Ivan Ivanov