Bearbeiten von „Projekt dgrep“

= Zielsetzung =
Es wir ein Kommandozeilenprogramm erstellt, das einen String, definiert mit einem regulären Ausdruck, in Dateien, evt. in mehreren Dateibäumen, sucht.

Mit zahlreichen Optionen kann die Suche eingegrenzt und die Ausgabe spezifiziert werden.

Das Programm hat eine Erklärfunktion (Aufruf mit Option "--help" oder "-h").

== Beschreibung ==
<pre>Usage: dgrep [<options>] <pattern> <file1> [<file2>] ..
  Searches <pattern> in <file1> <file2>...
  <fileN>: a filename pattern or a directory, e.g. "/opt" "opt/*.txt" "*.doc"
Examples:
 dgrep -r "version.*2"
 dgrep -V2 -i -r "happy|lucky" "*.txt" "--excluded=test.*" "--excluded-dirs=.git|.config" 
<option>:
-c, --count               Show only the count of lines with hits (per file)
-i, --ignore-case         The search is case insensitive
-v, --invert-match        Show lines that do not contain the pattern
    --process-binaries    Normally binary files will not be processed
-h, --help                Show the command description
-H, --hits                Show only the number of hits (per file): a line can contain many hits
-l, --list                Show the filename only, not the matching lines
-r, --recursive           Searches in all sub directories too
-w, --word                The patter describes a word: a hit will be delimited by word boundaries
-x, --excluded            A regular expression for files to skip, e.g. ".*.(bak|sic)"
-X, --excluded-dirs       A regular expression for directory to skip, e.g. "test|.git|.config
-f, --format              Describes the format of a found line
                          The format is a string with placeholders. 
                          Example: The name of the file is "/doc/data.txt", the search pattern is "(\w+).* (\d+\.\d\d) "
                            the found line is "apples: 20 kg 20.00 EUR"
                          %f% full name of the file, e.g. "/doc/data.txt"
                          %p% the path of the file, e.g. "/doc"
                          %n% the node, e.g. "data.txt"
                          %F% the filename, e.g. "data"
                          %e% the extension, e.g. ".txt"
                          %#% the line number
                          %h% the hit, e.g. ": 20 "
                          %c% the count of hit lines. Only meaningful together with option "--count"
                          %l% the line with the hit, e.g. "apples: 20 kg 20.00 EUR"
                          %1% the first group, e.g. "apple"
                          %2% the 2.nd group, e.g. "20.00"
                          ...
                          %9% the 9.th group, e.g. "" (not found)
                          A meaningful format of the above example: "%f%: product: %1% price: %2%"
-F, --format-context      Describes the format of a context line (see above-context...)
                          The format is a string with placeholders like the option --format.
-a, --above-context       That number of lines above the hit line will be showed
                          (defaults to "0")
-C, --context             That number of lines above and below the hit line will be showed
                          (defaults to "0")
-b, --below-context       That number of lines below the hit line will be showed
                          (defaults to "0")
    --break-lines         Stops the search in a file if that number of matching lines is reached
    --exit-lines          Stops the search if that number of matching lines is reached (over all files)
    --exit-files          Stops the search if that number of files with matching lines is reached
-V, --verbose-level       0: no additional info 1: summary 2: detail 3: loop 4: fine
                          (defaults to "0")
</pre>
= Kenntnisse =
* Umgang mit Verzeichnissen
* Unittests
* Generator

= Projekt erstellen =
* IdeaIC starten
* Menü: <code>File</code> - <code>New</code> - <Project>
* Linke Spalte: <code>Dart</code>
* Dart-SDK:
** Windows: c:\dart-sdk
** Linux: ~/dart-sdk
* Es erscheint eine Listbox, dort <code>Console-Application a command-line application sample</code> anklicken
* <code>Next</code>-Button 
* Project name: <code>dgrep</code>
* Project loction:
** Linux: <code>~/dev/dgrep</code>
** Windows: <code>c:\dev\dgrep</code>
* <code>Finish</code>-Button
Damit ist das Projekt names <code>dgrep</code> erstellt.

= Projekt erkunden =
* Linke Spalte: <code>Projects</code> anklicken
* Es wird ein Ordner namens <code>dgrep</code> sichtbar
* auf das Symbol ">" klicken, dann klappt das Verzeichnis aus
* Im Unterverzeichnis <code>bin</code> liegt die Datei mit dem Hauptprogramm, <code>dgrep.dart</code>.
* Herunterladen der Datei [https://github.com/flutter-tutorial-de/dart-programming Zip-Datei] und diese im Projektverzeichnis (<code>c:\dev\dgrep</code> oder <code>~/dev/dgrep</code>) entpacken.

== dgrep.dart ==
Wir tragen ein:
<pre>import 'package:dgrep/search_engine.dart';

void main(List<String> arguments) {
  SearchEngine.execute(arguments);
}
</pre>
* <code>package:dgrep/search_engine.dart</code> Wir importieren die Klasse <code>SearchEngine</code>.
* <code>SearchEngine.execute(arguments);</code> Die Klasse <code>SearchEngine</code> besitzt eine statische Methode <code>execute()</code>, die als Parameter die Liste der Programmargument erhält und die Suche erledigt.

== helper.dart ==
Durch das obige Entpacken der Zip-Datei gibt es die Datei lib/helper.dart.

Die <code>helper.dart</code> enthält nur einzelne Funktionen, die in [[dgrep-helper.dart ]] beschrieben werden.

== search_engine.dart ==
Durch das obige Entpacken der Zip-Datei gibt es die Datei lib/search_engine.dart.
Es folgt eine Besprechung von Ausschnitten der Datei.

* 
<code>
* Im Unterverzeichnis <code>lib</code> liegt eine zweite Datei <code>dsuche.dart</code>, die ergänzenden Code enthält. In diesem Projekt brauchen wir diese Datei nicht. also löschen: <code>Rechte Maustaste - Delete</code>
* ziemlich unten gibt es die Datei <code>pubspec.yaml</code> Dort werden Pakete eingetragen. 

= Programmcode in dsuche.dart =
Kopiere folgenden Code in die Datei <code>bin\dsuche.dart</code>
<pre>import 'dart:io';
/// Durchsuchen einer Datei nach einem regulären Ausdruck.
/// [args]: Programm-Argumente, z.B. [r'https?://', 'rechnung.txt']
void main(List<String> args) {
  if (args.length < 2){
    print('Gebrauch: dsuche <suchmuster> <date>\nBeispiel: dsuche "https?://" rechnung.txt');
  } else {
    final lines = File(args[1]).readAsLinesSync();
    RegExp regExp = RegExp(args[0], caseSensitive: false);
    for (var line in lines){
      if (regExp.firstMatch(line) != null){
        print(line);
      }
    }
  }
}
</pre>
= Programm in der Entwicklungsumgebung starten =
* In der Toolbar den grünen Hammer <code>Add configuration</code> klicken
* Es geht eine Dialogbox auf: Oben links auf das <code>+</code> klicken
* In der Liste <code>Dart Command Line App</code>
* Name: <code>dsuche</code>
* Dart file: Hier auf das Ordnersymbol in dem Textfeld klicken, dort Ordner <code>dsuche</code> aufklappen, im Unterordner <code>bin</code> die Datei <code>dsuche.dart</code> anklicken.
* Program arguments:
** Windows: <code>https?:// c:\dev\links.txt</code>
** Linux: <code>https?:// ~/dev/links.txt</code>
* Button <code>Ok</code>
* Im Entwicklungsordner (Windows: c:\dev, Linux: ~/dev/) eine Datei links.html anlegen:
<pre>Dies ist eine Testdatei
Suchen geht mit https://google.com
Spezialwissen findet sich auf http://wikipedia.de
Hab Spaß mit Programmieren.
</pre>

= Programm compilieren =
== Windows ==
* Eingabeaufforderung starten
* <code>gdev dsuche</code>
* <code>dcompile dsuche</code>
Danach gibt es die Datei <code>c:\dev\bin\dsuche.exe</code>
Dieses Programm kann in der Eingabeaufforderung gestartet werden.
<pre>gdev
dsuche https?:// links.txt
</pre>