šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java
author František Kučera <franta-hg@frantovo.cz>
Sat Jan 07 01:57:27 2012 +0100 (2012-01-07)
changeset 57 768a7eecb0cf
parent 43 4a4364826e59
child 61 9503eb8377f1
permissions -rw-r--r--
odkaz #16 na RFCčko musí být číselný
franta-hg@6
     1
package cz.frantovo.xmlWebGenerator;
franta-hg@6
     2
franta-hg@6
     3
import java.io.File;
franta-hg@27
     4
import java.io.IOException;
franta-hg@27
     5
import java.io.PrintStream;
franta-hg@6
     6
import java.util.Date;
franta-hg@6
     7
import java.net.URI;
franta-hg@6
     8
import java.net.URISyntaxException;
franta-hg@38
     9
import static cz.frantovo.xmlWebGenerator.NástrojeCLI.*;
franta-hg@6
    10
franta-hg@28
    11
/**
franta-hg@28
    12
 * Knihovna funkcí volaných z XSLT.
franta-hg@28
    13
 *  
franta-hg@36
    14
 * TODO:
franta-hg@32
    15
 *	- rozdělit na více modulů (jmenných prostorů).
franta-hg@32
    16
 *	- CLI konektor
franta-hg@28
    17
 * 
franta-hg@28
    18
 * @author fiki
franta-hg@28
    19
 */
franta-hg@6
    20
public class Funkce {
franta-hg@27
    21
franta-hg@30
    22
	private static final String PŘÍKAZ_PYGMENTIZE = "pygmentize";
franta-hg@32
    23
	private static final String PŘÍKAZ_DOT = "dot";
franta-hg@37
    24
	private static final String PŘÍKAZ_MARKDOWN = "markdown";
franta-hg@32
    25
	private static final String ADRESÁŘ_VÝSTUPNÍ = "výstup";
franta-hg@32
    26
	private static int počítadloDiagramů = 0;
franta-hg@30
    27
franta-hg@28
    28
	/**
franta-hg@28
    29
	 * Zjištuje, kdy byl naposledy daný soubor změněn.
franta-hg@28
    30
	 * @param soubor cesta k souboru
franta-hg@28
    31
	 * @return datum poslední změny
franta-hg@28
    32
	 * @throws URISyntaxException
franta-hg@28
    33
	 */
franta-hg@21
    34
	public static Date posledníZměna(String soubor) throws URISyntaxException {
franta-hg@28
    35
		URI uri = new URI(soubor);
franta-hg@28
    36
		File f = new File(uri);
franta-hg@28
    37
		return new Date(f.lastModified());
franta-hg@21
    38
	}
franta-hg@27
    39
franta-hg@27
    40
	/**
franta-hg@27
    41
	 * Zvýrazňuje syntaxi zdrojového kódu. Používá k tomu externí program/knihovnu pygmentize.
franta-hg@27
    42
	 * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
franta-hg@27
    43
	 * @param jazyk předáme příkazu pygmentize jako parametr -l &lt;lexer&gt;
franta-hg@28
    44
	 * @return zvýrazněný text nebo null, pokud došlo k chybě.
franta-hg@31
    45
	 * TODO: 
franta-hg@36
    46
	 *	- vracet místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
franta-hg@31
    47
	 *  - nebo kontrolovat validitu vygenerovaného kódu (v současnosti se spoléháme na bezchybnost pygmentize)
franta-hg@27
    48
	 */
franta-hg@27
    49
	public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
franta-hg@28
    50
		if (jazyk == null || jazyk.length() == 0) {
franta-hg@28
    51
			System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
franta-hg@28
    52
			return null;
franta-hg@36
    53
		} else if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
franta-hg@27
    54
			Runtime r = Runtime.getRuntime();
franta-hg@30
    55
			Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-f", "html", "-l", jazyk});
franta-hg@27
    56
franta-hg@27
    57
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@27
    58
			vstupProcesu.print(zdroják);
franta-hg@27
    59
			vstupProcesu.close();
franta-hg@27
    60
franta-hg@27
    61
			String výsledek = načtiProud(p.getInputStream());
franta-hg@27
    62
			String chyby = načtiProud(p.getErrorStream());
franta-hg@27
    63
franta-hg@27
    64
			p.waitFor();
franta-hg@27
    65
franta-hg@27
    66
			if (chyby.length() == 0) {
franta-hg@28
    67
				// Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
franta-hg@27
    68
				return výsledek;
franta-hg@27
    69
			} else {
franta-hg@28
    70
				System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
franta-hg@28
    71
				return null;
franta-hg@27
    72
			}
franta-hg@27
    73
		} else {
franta-hg@30
    74
			System.err.println("Příkaz " + PŘÍKAZ_PYGMENTIZE + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
franta-hg@28
    75
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@28
    76
			System.err.println("\t$ aptitude install python-pygments   # (Debian/Ubuntu)");
franta-hg@28
    77
			System.err.println("\t$ yum install python-pygments        # (Fedora/RedHat)");
franta-hg@28
    78
			return null;
franta-hg@27
    79
		}
franta-hg@27
    80
	}
franta-hg@27
    81
franta-hg@28
    82
	/**
franta-hg@31
    83
	 * Vygeneruje CSS styl pro zvýrazňování syntaxe.
franta-hg@31
    84
	 * @return obsah CSS souboru nebo null, pokud generování nebylo možné
franta-hg@31
    85
	 */
franta-hg@31
    86
	public static String generujCssSyntaxe() throws IOException, InterruptedException {
franta-hg@36
    87
		if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
franta-hg@31
    88
			Runtime r = Runtime.getRuntime();
franta-hg@31
    89
			Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-S", "default", "-f", "html"});
franta-hg@31
    90
			return načtiProud(p.getInputStream());
franta-hg@31
    91
		} else {
franta-hg@31
    92
			return null;
franta-hg@31
    93
		}
franta-hg@31
    94
	}
franta-hg@31
    95
franta-hg@31
    96
	/**
franta-hg@32
    97
	 * Vytvoří obrázek s diagramem.
franta-hg@32
    98
	 * @param zadání definice diagramu ve formátu dot
franta-hg@52
    99
	 * @param vodorovně zda má být graf orientovaný vodorovně (funguje jen při <code>kompletní = false</code>)
franta-hg@52
   100
	 * @param kompletní false, pokud k zadání chceme doplnit <code>digraph d {…}</code>
franta-hg@32
   101
	 * @return název souboru bez přípony, který byl vytvořen, nebo null, pokud došlo k chybě.
franta-hg@32
   102
	 */
franta-hg@52
   103
	public static String vytvořDiagram(String zadání, boolean vodorovně, boolean kompletní) throws IOException, InterruptedException {
franta-hg@36
   104
		if (isPříkazDostupný(PŘÍKAZ_DOT)) {
franta-hg@32
   105
			počítadloDiagramů++;
franta-hg@32
   106
			String soubor = "diagram-" + počítadloDiagramů;
franta-hg@32
   107
			String souborSložka = ADRESÁŘ_VÝSTUPNÍ + File.separator + soubor;
franta-hg@32
   108
franta-hg@52
   109
			String zdroják;
franta-hg@52
   110
			if (kompletní) {
franta-hg@52
   111
				zdroják = zadání;
franta-hg@52
   112
			} else {
franta-hg@52
   113
				StringBuilder b = new StringBuilder(zadání.length() + 200);
franta-hg@52
   114
				b.append("digraph d {\n");
franta-hg@52
   115
				b.append("\tbgcolor=\"transparent\";\n");
franta-hg@52
   116
				if (vodorovně) {
franta-hg@52
   117
					b.append("\trankdir=LR;");
franta-hg@52
   118
				}
franta-hg@52
   119
				b.append(zadání);
franta-hg@52
   120
				b.append("}\n");
franta-hg@52
   121
				zdroják = b.toString();
franta-hg@32
   122
			}
franta-hg@32
   123
franta-hg@32
   124
			Runtime r = Runtime.getRuntime();
franta-hg@32
   125
			Process p = r.exec(new String[]{PŘÍKAZ_DOT, "-T", "svg", "-o", souborSložka + ".svg"});
franta-hg@32
   126
franta-hg@32
   127
			/**
franta-hg@32
   128
			 * TODO: generovat i PNG bitmapu
franta-hg@32
   129
			 */
franta-hg@32
   130
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@32
   131
			vstupProcesu.print(zdroják.toString());
franta-hg@32
   132
			vstupProcesu.close();
franta-hg@32
   133
franta-hg@32
   134
			String chyby = načtiProud(p.getErrorStream());
franta-hg@32
   135
franta-hg@32
   136
			p.waitFor();
franta-hg@32
   137
franta-hg@32
   138
			if (chyby.length() == 0) {
franta-hg@32
   139
				return soubor;
franta-hg@32
   140
			} else {
franta-hg@32
   141
				System.err.print("Při vytváření diagramu došlo k chybě: " + chyby);
franta-hg@32
   142
				return null;
franta-hg@32
   143
			}
franta-hg@32
   144
		} else {
franta-hg@32
   145
			System.err.println("Příkaz " + PŘÍKAZ_DOT + " není na vašem systému dostupný → diagramy nelze vygreslit.");
franta-hg@32
   146
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@32
   147
			System.err.println("\t$ aptitude install graphviz   # (Debian/Ubuntu)");
franta-hg@32
   148
			System.err.println("\t$ yum install graphviz        # (Fedora/RedHat)");
franta-hg@32
   149
			return null;
franta-hg@32
   150
		}
franta-hg@32
   151
	}
franta-hg@32
   152
franta-hg@32
   153
	/**
franta-hg@37
   154
	 * Převede text ve wiki syntaxi do XHTML.
franta-hg@37
   155
	 * @param wiki vstupní text v dané wiki syntaxi
franta-hg@37
   156
	 * @param syntaxe null nebo volitelně syntaxe (markdown, texy)
franta-hg@37
   157
	 * @return naformátované XHTML
franta-hg@37
   158
	 */
franta-hg@37
   159
	public static String formátujWiki(String wiki, String syntaxe) throws IOException {
franta-hg@37
   160
		if (isPříkazDostupný(PŘÍKAZ_MARKDOWN)) {
franta-hg@37
   161
			Runtime r = Runtime.getRuntime();
franta-hg@37
   162
			Process p = r.exec(new String[]{PŘÍKAZ_MARKDOWN});
franta-hg@37
   163
franta-hg@37
   164
			/**
franta-hg@37
   165
			 * TODO: oříznout mezery na začátcích řádků, pokud je jich všude stejně?
franta-hg@37
   166
			 * (odsazení v XML)
franta-hg@37
   167
			 */
franta-hg@37
   168
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@37
   169
			vstupProcesu.print(wiki);
franta-hg@37
   170
			vstupProcesu.close();
franta-hg@37
   171
franta-hg@37
   172
			String chyby = načtiProud(p.getErrorStream());
franta-hg@37
   173
			String xhtml = načtiProud(p.getInputStream());
franta-hg@37
   174
franta-hg@37
   175
			if (chyby.length() == 0) {
franta-hg@37
   176
				return xhtml;
franta-hg@37
   177
			} else {
franta-hg@37
   178
				System.err.print("Při zpracování wiki syntaxe došlo k chybě: " + chyby);
franta-hg@37
   179
				return null;
franta-hg@37
   180
			}
franta-hg@37
   181
		} else {
franta-hg@37
   182
			System.err.println("Příkaz " + PŘÍKAZ_MARKDOWN + " není na vašem systému dostupný → nelze formátovat texty ve wiki syntaxi.");
franta-hg@37
   183
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@37
   184
			System.err.println("\t$ aptitude install markdown         # (Debian/Ubuntu)");
franta-hg@37
   185
			System.err.println("\t$ yum install perl-Text-Markdown    # (Fedora/RedHat)");
franta-hg@37
   186
			return null;
franta-hg@37
   187
		}
franta-hg@37
   188
	}
franta-hg@6
   189
}