DescribeIt - Funktionsheader leicht gemacht (Alpha)

[Blockierte Grafik: http://i45.tinypic.com/2je9w28.png]

Hallo,
Ich möchte euch mein neustes kleines Projekt vorstellen: DescribeIt

Findet ihr es auch mühsehlig für eure UDF Funktionen standardkonforme Funktionsheader "zu Fuß" zu erstellen?
Mit DescribeIt ist damit jetzt Schluss! Die übersichtliche GUI macht es einfach, schnell eine Beschreibung zu erstellen.

Hier mal ein paar Screenshots für den groben Überblick:
[Blockierte Grafik: http://i46.tinypic.com/245da42.png]
[Blockierte Grafik: http://i50.tinypic.com/2rxb4a0.jpg]

Was kann DescribeIt ?
Mit DescribeIt kann man in Windeseile eigene Funktionsheader erstellen, oder bereits vorhandene bearbeiten. Die Header sind standartkonform - wodurch eure UDF direkt noch professioneller wirkt. DescribeIt versucht, bereits vorhandene Header einzulesen und zu verarbeiten. Ist das nicht möglich so wird der Header so weit wie möglich ausgefüllt. (zB standardmäßig On Success/Failure im Return). DescribeIt verändert die Orginaldatei nicht.

Wie verwende ich DescribeIt ?
Zur installation einfach den Installer starten, und den Anweisungen folgen.
Die Anwendung selbst ist denkbar einfach. Zum einlesen eines Scriptes genügt bereits ein Drag & Drop. Alternativ kann eine Datei über den Datei-öffnen Dialog gewählt werden. DescribeIt unterstützt auch das Einlesen von Quellcode aus der Zwischenablage. Im kompilierten Zustand kann auch eine Datei direkt auf die .exe oder eine entsprechende Verknüpfung auf dem Desktop gezogen werden.

Ist der Code eingelesen, wählt man links oben in der ComboBox eine Funktion aus. Diese kann man nun über die einzelenen Bedienelemente der GUI bearbeiten.
Zum speichern reicht es, den entsprechenden Knopf in der GUI zu drücken. Entweder alle Funktionen mit allen erstellten Headern in eine Datei schreiben,
oder den aktuellen bearbeiteten Header in die Zwischenablage kopieren.

Mein Dank an dieser Stelle gilt TimBlo aus dem AutoItBot-Forum, der fleißig eine Projekt Speichern/Laden-Funktion für dieses Tool schreibt geschrieben hat, welche dann aber durch die Import/Export-Funktion ersetzt wurde.
Außerdem danke ich PrideRage für seine Anleitung, wie man das Script in Scite einbaut.

Download ab jetzt extern:
DescribeIt Download
Hier der VirusTotal Bericht:
http://www.virustotal.com/de/analisis/29…138b-1268008513

Sourcecodes sind dabei, falls ihr euch Sorgen machen solltet. Habe die .exen nur zur Angenehmeren Handhabung beigefügt.

Danke für das Feedback, das werd ich gleich mal korrigieren.

Habe die Parameter jetzt korrigiert und sie sind jetzt hoffentlich standardkonform.

Hinzugekommen ist auch das Importieren der Parameterbeschreibungen (die bis jetzt immer leer gelassen wurden)
Außerdem haben wir die Projekt-Funktionen fast fertig (nur noch ein bisschen bugfixing). Im Prinzip funktionieren sie, aber noch nicht 100%ig, so wie ich das gerne hätte.

Bekannte Bugs, für die ich mir noch was überlegen muss:
- Importfunktion für Parameter liest mehrzeilige Beschreibungen nicht aus.
- Bestimmte Situationen bringen die Projekt - Funktionen zum Absturz-

Neue Version in Post 1

@progandy: nicht dass du denkst, ich hätte dich überlesen: Habe den Parameter-Output entsprechend deinem Link angepasst. Danke jedenfalls dafür, das kann im späteren Projektverlauf (wenn die Kinderkrankheiten beseitigt sind) sehr nützlich werden. Vor allem wenn das Tool so weit ist,
und in SciTE integriert werden kannst, wäre ein "On-The-Fly"-Korrigieren und anpassen des Scriptes natürlich überbombig. Dein Link hilft da sehr gut weiter.

// Edit 2: Und das mit der Nicht-Mehrzeiligen Description wird auch noch gemacht. In der nächsten Version.

Neue Version:

• Das GUI ist angepasst worden, damit es übersichtlicher ist.
• Man kann nun die Anzeige zwischen Header-Preview und Orginalfunktion wechseln.
• Es ist nun möglich, related functions/links einzutragen.
• Auf wunsch können "ungenutzte" Zeilen entfernt werden.
• Die Option, interne Funktionen mit einzubeziehen, ist nun standard.
• Copy & Paste für Funktionen eingefügt. Dies ermöglicht es, Daten von einer auf die andere Funktion zu übertragen. Übertragen werden Beschreibung, Return Value, Author, Modified, Remarks, Related, Link
• Scripte können nun "exportiert" werden. (Zum jetzigen Stand allerdings nur Abwechelnd header und Funktion)
• Scripte können nun während dem "normalen" Betrieb eingelesen werden. Man muss also nicht für jedes Include neu starten.
• Einiges an Bugfixing.

Download wird in kürze in Post 1 verfügbar sein.
/EDIT: Upload fertig. Bilder eingefügt. Viel spaß damit

Zitat von PrideRage

Da kommt jetzt ein Array Error

Könntest du vielleicht ein bisschen genauer werden?
Welcher Error? Was hast du gemacht?

Sag mir was ich tun muss, um den Fehler zu reproduzieren - ich finde nämlich keinen.

Danke. Diesen Fehler habe ich heute gefunden als ich die "Code per Clipboard einlesen"-Funktion eingebaut habe. In der nächsten Version wird das auch gefixt sein.

Aber der Fehler tritt erst beim öffnen einer UDF auf, wenn schon eine andere offen war, oder?
Beim Scriptstart darf / kann das eigentlich nicht passieren.

Wenn doch postet mal bitte die UDF.

Neue Version

Ich hoffe, dass die nun bei jedem laufen wird.

Siehe Post 1

Update: Scheinbar funktinoiert das ganze nur auf meinem Rechner. ich habe mittlerweile den Fehler gefunden (zumindest glaub ich das. Allerdings habe ich es noch nicht geschafft das zu reparieren : Jetzt funktionierts auf dem anderen Rechner, nur auf meinem Notebook nicht mehr. Ich meld mich wenn ich weiter bin.