scripts/help_generator.pl
author František Kučera <franta-hg@frantovo.cz>
Fri, 23 Sep 2022 18:05:50 +0200
branchv_0
changeset 254 c4b901ff0703
parent 250 aae5009bd0af
permissions -rwxr-xr-x
recfile formatter: write record count (as a comment at the end of the relation)
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
96
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     1
#!/usr/bin/perl
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     2
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     3
# SQL-DK
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     4
# Copyright © 2013 František Kučera (frantovo.cz)
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     5
# 
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     6
# This program is free software: you can redistribute it and/or modify
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     7
# it under the terms of the GNU General Public License as published by
250
aae5009bd0af fix license version: GNU GPLv3
František Kučera <franta-hg@frantovo.cz>
parents: 200
diff changeset
     8
# the Free Software Foundation, version 3 of the License.
96
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     9
# 
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    10
# This program is distributed in the hope that it will be useful,
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    11
# but WITHOUT ANY WARRANTY; without even the implied warranty of
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    12
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    13
# GNU General Public License for more details.
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    14
# 
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    15
# You should have received a copy of the GNU General Public License
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    16
# along with this program. If not, see <http://www.gnu.org/licenses/>.
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    17
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    18
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    19
# Parses Java source code from STDIN and generates simple help
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    20
# Input (in this order):
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    21
#	info/globalcode/sql/dk/CLIParser.java
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    22
#	info/globalcode/sql/dk/CLIStarter.java
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    23
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    24
# TODO: localization
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    25
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    26
100
de65409a9f26 typo in help generator
František Kučera <franta-hg@frantovo.cz>
parents: 96
diff changeset
    27
print 'SQL-DK – an SQL batch client
96
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    28
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    29
Options:
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    30
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    31
';
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    32
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    33
while (<>) {
200
2e351d7c26c4 InfoLister: new listings: --list-java-properties and --list-environment-variables
František Kučera <franta-hg@frantovo.cz>
parents: 100
diff changeset
    34
	print "	" . sprintf("%-32s", $1) . "$3\n" if (/"(.*?)".*? \/\/\s*bash-completion:option(\s*\/\/\s*help:(.*))?/);
96
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    35
	last if (/\/\/\s*help:exit-codes/);
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    36
}
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    37
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    38
print '
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    39
Examples:
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    40
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    41
	sql-dk --db MyDatabase --sql "SELECT * FROM table"
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    42
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    43
	sql-dk --db MyDatabase --sql "SELECT * FROM table WHERE a = ? AND b = ?" --data "abc" "def"
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    44
	sql-dk --db MyDatabase --sql "SELECT * FROM table WHERE a = :paramA AND b = :paramB" --data-named "paramA" "abc" "paramB" "def"
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    45
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    46
	sql-dk --db MyDatabase --sql "SELECT * FROM table WHERE a = ? AND b = ?" --types "varchar,integer" --data "abc" "123"
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    47
	sql-dk --db MyDatabase --sql "SELECT * FROM table WHERE a = :paramA AND b = :paramB" --types "paramA:varchar,paramB:integer" --data-named "paramA" "abc" "paramB" "123"
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    48
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    49
Exit codes:
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    50
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    51
';
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    52
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    53
while (<>) {
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    54
	print "	$1 = $2\n" if (/EXIT_.*?=\s*(\d+)\s*;\s*\/\/\s*doc:(.*)/);
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    55
}
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    56
7ae30649b30b basic generated help
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    57
print "\n";