Das deutsche Python-Forum

Hallo liebe Gemeinde,

Ich stehe vor einem Problem. Und zwar habe ich bereits für Python 2.1.3 ein paar ganz kleine Skripte geschrieben womit man kleinere Sachen machen kann.

Da es mittlerweile schon über 30 Skripte geworden sind, möchte ich mir diese ausdokumtieren lassen. Ich habe schon einiges mit PyDoc versucht, aber ich schaffe es irgendwie nicht.

Meine Skripte liegen also also auf einem Netzwerklaufwerk und über diese möchte ich nun pydoc laufen lassen. Wenn ich eine Kommandozeile öffne, kann ich python.exe -V eingeben und es wird Python 2.1.3 ausgegeben.

Das funktioniert also. Es ist notwendig diese Version von Python zu benutzen, da ich mit dem wsadmin die Skripte lade und diverse Abfrage an eine WebSphere Application Server V6.1 Umgebung mache. Dieser wsadmin unterstützt leider nur Version 2.1.3

Kann mir jemand auf dem einfachsten Wege sagen wie ich die Skripte von PyDoc ausdokumentieren lassen kann? Ich hab schon in die Doku geguckt, google benutzt und auch über das Forum habe ich bisher keine Lösung finden können.

Ich bin für jeden Ratschlag dankbar

Kikone

Wenn ich zum Beispiel

python.exe Z:\MeinSkript.py ausführe kommt dieser Fehler


"NameError: name ÀdminControl`is not defined



Woran liegt das?

Python kann dem Element "AdminControl" nichts zuordnen. Mit etwas Code von dir könnte man mehr sagen.

Hier mal ein Beispiel...

node = AdminConfig.getid('/Node:mynode/')

AdminTask.createApplicationServer(mynode,
['-name', 'test1', '-templateName', 'default'])

Die Codes funktionieren auch ... nur das mit dem Dokumentieren will halt nicht ... ((

kikone hat geschrieben:Hier mal ein Beispiel...

node = AdminConfig.getid('/Node:mynode/')

AdminTask.createApplicationServer(mynode,
['-name', 'test1', '-templateName', 'default'])

Bitte komplett. Woher kommt AdminConfig? Importierst du das? Wie gesagt, bitte soviel daß man es zurückverfolgen kann. Und auch komplette Fehlermeldungen (inkl. der Zeilenangabe). Nutze bitte auch die Code-Tags zwecks besserer Lesbarkeit.

Das war komplett

Die Kommentare die ich geschrieben habe, willst du doch nicht lesen oder?

Das kommt von der IBM

Wenn dein Code funktioniert woher kommt dann die Fehlermeldung? Was hat die mit pydoc zu tun? Ohne eine präzise Problembeschreibung wird dir keiner weiterhelfen können außer mit RTFM.

x-post: http://www.macuser.de/forum/f25/pydoc-427467/

kikone hat geschrieben:Die Kommentare die ich gelesen habe, willst du doch nicht lesen oder?

Was sind denn das für Kommentare? Aber die werden wohl auch nicht allzu viel zur Sache tun. Ich glaube jedenfalls nicht, dass dieser Code - so ganz ohne Imports - komplett ist. Falls doch, dann weiß man ja, wo der Fehler liegt...

sagst du es mir auch?

also muss ich dann extra was importieren um den code aus dokumentieren lassen zu können?

`pydoc` importiert die Module und untersucht dann die Objekte darin. Das heisst das geht nur, wenn man die Module auch importieren kann. Das geht offenbar nicht aussehalb des Produkts für das diese Module geschrieben wurden, weil das anscheinend Objekte erstellt, bevor das Modul ausgeführt wird, die im alleinstehenden Python nicht vorhanden sind.

Also gibts nicht wirklich eine Möglichkeit?

Du könntest versuchen das Modul `pydoc` innerhalb der Anwendung zu verwenden, um Dokumentation zu den anderen Modulen zu erstellen.

Und wie mache ich das?

Wäre dir sehr dankbar für einen Hinweis ...

Kikone

Hat keiner einen Tipp??

``import pydoc``

Das soll in das Skript was ich geschrieben habe? Oder wie jetzt?

So ich bin einen Schritt weitergekommen.

Ich kann jetzt PyDoc über meine Skripte laufen lassen.
Aber wenn ich die erstellte HTML Datei öffnen will, steht da folgendes:

problem in C:\Python21\Alle_Applikation_stoppen.pyc - NameError: name 'AdminControl' is not defined

Wo finde ich das PythonDocs? Da könnte ich doch evtl. was hinzufügen damit Pydoc weiss wo es gucken muss.

Bin dankbar für jeden Rat.

Kikone

Hab das hier gefunden:

Module docs for core modules are assumed to reside in http://docs.python.org/library/. This can be overridden by setting the PYTHONDOCS environment variable to a different URL or to a local directory containing the Library Reference Manual pages.

Aber leider weiss ich nicht genau was das bedeuten soll....