summary refs log tree commit diff
path: root/unscoop.1
blob: ac8a625dd6fc4d0537c49228b18226d56a5874e7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
.Dd December 12, 2019
.Dt UNSCOOP 1
.Os
.
.Sh NAME
.Nm unscoop
.Nd import IRC logs
.
.Sh SYNOPSIS
.Nm
.Op Fl C Ar context
.Op Fl N Ar network
.Op Fl d Ar path
.Op Fl f Ar format
.Ar
.
.Nm
.Fl D
.Op Fl d Ar path
.
.Sh DESCRIPTION
The
.Nm
utility imports IRC logs into the
.Xr litterbox 1
database.
The network and context (channel or query) names
are inferred from the input file paths,
so
.Nm
should be run from the log directory root.
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl C Ar context
Override the context (channel or query) name
of imported logs.
.
.It Fl D
Delete duplicate events from overlapping imports.
This operation requires SQLite version 3.25.0 or newer.
.
.It Fl N Ar network
Override the network name of the imported logs.
.
.It Fl d Ar path
Set the database path.
The database must have been initialized by
.Xr litterbox 1 .
The default path is as in
.Xr litterbox 1 .
.
.It Fl f Ar format
Set the input log format.
The default format is
.Cm generic .
.Pp
The following formats are supported:
.Bl -tag -width Ds
.It Cm catgirl
Logs from the catgirl IRC client.
.It Cm generic
Matches paths of the form
.Pa network/context/*
and messages of the following forms:
.Bd -literal -offset indent
[timestamp] <nick> privmsg
[timestamp] -nick- notice
[timestamp] * nick action
.Ed
.It Cm irc
IRC protocol messages tagged with the IRCv3.2
.Sy server-time
extension.
Network and context must be set with
.Fl N
and
.Fl C .
.It Cm textual
Logs from the Textual IRC client.
.El
.El
.
.Sh EXAMPLES
.Bd -literal
find catgirl -type f -name '*.log' -print0 | xargs -0 unscoop -f catgirl
find Textual -type f -name '*.txt' -not -path '*/Console/*' -print0 \e
	| xargs -0 unscoop -f textual
.Ed
.
.Sh SEE ALSO
.Xr litterbox 1 ,
.Xr scoop 1
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency
.
.Sh BUGS
Send mail to
.Aq Mt june@causal.agency
or join
.Li #ascii.town
on
.Li chat.freenode.net .
ader'>2022-06-08Add Maiden, Mother, CroneJune McEnroe Mixed bag like most collections of short stories. Some of them are pretty good. The author of the worst written story also has the worst written bio. 2022-06-05FIRST SHOW IN 2.5 YEARS BABEY!!!June McEnroe 2022-06-03Set line number on File linesJune McEnroe 2022-06-03Stop polling stdin after EOFJune McEnroe 2022-06-02Set TABSIZE=4June McEnroe Absolutely indiscriminately. 2022-06-02Do basic match highlightingJune McEnroe 2022-06-02Clean up parsing a littleJune McEnroe 2022-06-02Don't duplicate path stringJune McEnroe 2022-06-02Use stderr instead of /dev/tty, realloc buffer if lines too longJune McEnroe For some reason I haven't been able to figure out, trying to poll /dev/tty returns POLLNVAL (and this was using 100% CPU looping), but using stderr instead works fine. 2022-06-02Add initial working version of qfJune McEnroe 2022-05-29Set prompt for okshJune McEnroe