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)