Wo soll ich die tests bei der Verpackung von python-Module?

Ich habe ein Modul, das sitzt in einem namespace. Sollten die tests und Daten die tests verlassen sich auf das gehen in der namespace oder in der obersten Ebene, wo setup.py die Seiten?

./company/__init__.py
./company/namespace/__init__.py
./company/namespace/useful.py
./company/namespace/test_useful.py
./company/namespace/test_data/useful_data.xml
./setup.py

oder

./company/__init__.py
./company/namespace/__init__.py
./company/namespace/useful.py
./test_useful.py
./test_data/useful_data.xml
./setup.py

Nicht die Frage, die Menge an tests, ob installiert werden soll oder nicht?

InformationsquelleAutor Stephen Paulger | 2011-03-17
  1. 15

    Dann sollten Sie Ihre test-Modul in der Modul-tests nach der Per Anhalter durch die Verpackung.

    Hier ist Ihr Beispiel:

    TowelStuff/
    bin/
    CHANGES.txt
    docs/
    LICENSE.txt
    MANIFEST.in
    README.txt
    setup.py
    towelstuff/
        __init__.py
        location.py
        utils.py
        test/
            __init__.py
            test_location.py
            test_utils.py

    Diese Weise Ihre module verbreitet werden, mit Ihren tests, und die Benutzer können Sie verwenden, um zu überprüfen, dass es funktioniert mit Ihrer Einrichtung.

    Sehen http://the-hitchhikers-guide-to-packaging.readthedocs.org/en/latest/creation.html.

    • was ist der import-Anweisung in den tests?
    • Tests können üblichen Modul importiert. Tests Häufig ausgeführt werden, indem Sie den absoluten Pfad und mit angepassten Umgebungsvariablen PYTHONPATH, vor allem von der IDE-wie PyCharm.
    • Man sollte nicht die Namen der Submodul-test zur Vermeidung von Verwechslungen mit der standard-Bibliothek Modul mit dem Namen test.
    • Dennoch, The Hitchhiker ' s Guide to Python schlägt die Platzierung der tests außerhalb: docs.python-guide.org/en/latest/writing/structure!
    • Ugh, ich darauf Vertrauen, dass The Hitchhiker 's Guide to Python oder The Hitchiker' s Guide to Packaging?
    • Die "The Hitchhiker' s Guide to Packaging" wurde nicht aktualisiert, seit 2010. Bitte verwenden Sie diese packaging.python.org guide
    • Ich habe eine harte Zeit finden alles, was über tests in diesem guide. Bin ich etwas fehlt?
    • bitte sagen Sie die Autoren des Leitfadens. Öffnen Sie bitte ein Thema gibt. Danke.

    InformationsquelleAutor hwiechers
  2. 24

    Den Beispiel-Projekt speichert die tests außerhalb des Moduls.

    Die Verzeichnis-Struktur sieht wie folgt aus:

    ├── data
│   └── data_file
├── MANIFEST.in
├── README.rst
├── sample
│   ├── __init__.py
│   └── package_data.dat
├── setup.cfg
├── setup.py
└── tests
    ├── __init__.py
    └── test_simple.py

    Verwandte: Die Verpackung Anleitung: https://packaging.python.org/en/latest/

    Hinweis: Folgen Sie nicht den "The Hitchhiker' s Guide to Packaging". Es hat nicht gewesen aktualisiert seit 2010!

    (nicht zu verwechseln beide Seiten. Die "The Hitchhiker' s Guide to Python" ist ein sehr solides Buch)

    • Siehe auch jeffknupp.com/blog/2013/08/16/..., was macht die tests in den root-Projekt-Verzeichnis zu.
    • Entgegenstehende genug, dieses The Hitchhiker ' s Guide to Python schlägt die Platzierung der tests außerhalb: docs.python-guide.org/en/latest/writing/structure
    • lustig genug, dass ist nicht das, was der Artikel, den Sie verlinkt sagt jetzt, ich denke, es aktualisiert zu empfehlen Platzierung Prüfungen, die außerhalb der Haupt-Paket
    • danke! Folgen Sie nicht The Hitchhiker ' s Guide to Python dann! 🙂
    • verwechseln Sie nicht die beiden Seiten. Die "The Hitchhiker' s Guide to Python" ist ein sehr solides Buch
    • Angesichts dieses Beispiel, wie wollen Sie laden die data_file in test_simple.py? Ich habe eine ähnliche Struktur, sondern führen zu Problemen beim laden der Datei mittels open('../data/data_file'). Es funktioniert, wenn ich den test direkt, sondern schlägt fehl, wenn ich "python setup.py test"
    • Ich habe diese Verzeichnis-Struktur, und nun weiß ich nicht, wie die Verteilung von meinem Paket+tests korrekt. Auch bei der Angabe package-data auf meine tests Verzeichnis setup.py... pip noch installiert myModule, dann installiert tests als separates Paket. Ich habe meine tests - Verzeichnis einfach im Umlauf in Lib/site-packages mit keine Möglichkeit zu sagen, es gehört zu meinem Modul. Wie verhindern Sie diese situation?
    • erstellen Sie bitte eine neue Frage. Ich denke, das bringt viel bessere Rückmeldung. Sie können den link hier zu deiner neuen Frage.

    InformationsquelleAutor guettli
  3. 1

    Ich persönlich erstellen Sie eine einzelne tests Paket als ein sub-Paket an das main-Paket für ein paar Gründe:

    • Wenn tests ist parallel mit dem root-Paket gibt es eine off-chance, dass Sie oder ein Benutzer kann misconfigure setup.py und versehentlich legen Sie eine Globale Paket namens tests die zu einer grossen Verwirrung und Kopfschmerzen, bis Sie realisieren, was passiert ist. Indem Sie in der main-Modul löst dieses Problem, da es jetzt unter einen (hoffentlich) weltweit eindeutigen Namensraum.

    • Ich weiß nicht, wie putting ein test-Modul innerhalb von Benutzer-Paket, weil die test-Läufer zu suchen haben, durch die Produktion von code. Dies ist wahrscheinlich nicht ein problem für die meisten. Aber, wenn Sie geschehen, ein hardware-test-Ingenieur, die Sie wahrscheinlich mit dem Wort "test" eine Menge in Ihrer Produktions-code und nicht wollen, dass die Einheit test-runner zu Holen, das Zeug. Es ist viel einfacher, wenn alle tests sind in einem Ort getrennt von den Produktions-code.

    • Kann ich weiter untergliedern mein Ordner "tests" in die Arten von tests, wie unit, functional und integration. Meine funktionalen tests neigen dazu, Abhängigkeiten auf seltsame proprietäre hardware, Daten oder sind langsam. So ist es einfach für mich, um kontinuierlich laufen nur die schnelle unit-test-Ordner, wie ich entwickeln.

    • Kann es manchmal zweckmäßig sein, haben die tests werden innerhalb der gleichen Paket-Hierarchie als das, was es ist testen.

    Insgesamt, obwohl, ich denke, es ist wichtig, für sich selbst zu denken über das, was am besten für Ihre speziellen problem-Domäne nach der Einnahme jeder Beratung berücksichtigt. 'Best practices' sind ideal Ausgangspunkt, nicht Endpunkt, für die Entwicklung eines Verfahrens.

    InformationsquelleAutor willtalmadge
Schreibe einen Kommentar