Source code

Download source archive ↓

src/rdflib/extras/cmdlineutils.py

1from __future__ import annotations
2
3import codecs
4import getopt
5import sys
6import time
7from typing import TextIO, Union
8
9import rdflib
10from rdflib.util import guess_format
11
12
13def _help():
14    sys.stderr.write(
15        """
16program.py [-f <format>] [-o <output>] [files...]
17Read RDF files given on STDOUT - does something to the resulting graph
18If no files are given, read from stdin
19-o specifies file for output, if not given stdout is used
20-f specifies parser to use, if not given it is guessed from extension
21
22"""
23    )
24
25
26def main(target, _help=_help, options="", stdin=True):
27    """
28    A main function for tools that read RDF from files given on commandline
29    or from STDIN (if stdin parameter is true)
30    """
31
32    args, files = getopt.getopt(sys.argv[1:], "hf:o:" + options)
33    dargs = dict(args)
34
35    if "-h" in dargs:
36        _help()
37        sys.exit(-1)
38
39    g = rdflib.Graph()
40
41    if "-f" in dargs:
42        f = dargs["-f"]
43    else:
44        f = None
45
46    out: Union[TextIO, codecs.StreamReaderWriter]
47    if "-o" in dargs:
48        sys.stderr.write("Output to %s\n" % dargs["-o"])
49        out = codecs.open(dargs["-o"], "w", "utf-8")
50    else:
51        out = sys.stdout
52
53    start = time.time()
54    if len(files) == 0 and stdin:
55        sys.stderr.write("Reading from stdin as %s..." % f)
56        g.parse(sys.stdin, format=f)
57        sys.stderr.write("[done]\n")
58    else:
59        size = 0
60        for x in files:
61            if f is None:
62                f = guess_format(x)
63            start1 = time.time()
64            sys.stderr.write("Loading %s as %s... " % (x, f))
65            g.parse(x, format=f)
66            sys.stderr.write(
67                "done.\t(%d triples\t%.2f seconds)\n"
68                % (len(g) - size, time.time() - start1)
69            )
70            size = len(g)
71
72    sys.stderr.write(
73        "Loaded a total of %d triples in %.2f seconds.\n"
74        % (len(g), time.time() - start)
75    )
76
77    target(g, out, args)