summary refs log tree commit diff
path: root/www/text.causal.agency/006-some-libs.7
blob: 5af65404b2c722f13284962870604a239ec1bdf7 (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
.Dd December 11, 2019
.Dt SOME-LIBS 7
.Os "Causal Agency"
.
.Sh NAME
.Nm Some Libraries
.Nd good ones
.
.Sh DESCRIPTION
This is a little list of C libraries
I've had good experiences using.
.
.Bl -tag -width Ds
.It Fl lcurl
The library behind the
.Xr curl 1
command.
It downloads or uploads things on the internet
through a number of protocols,
not just HTTP.
It has an easy-to-use library API,
appropriately named
.Xr libcurl-easy 3 .
I've used it to implement a
.Lk https://causal.agency/bin/title.html "page title fetcher" .
.
.It Fl lcurses
Okay so this one really isn't great.
Its interfaces can seem archaic
and its documentation is often poor.
However, it gets the job done
and is commonly available pretty much everywhere.
Interesting to note that
.Nx
uses its own implementation of curses
that is not GNU ncurses,
unlike
.Fx .
.
.It Fl ledit
This is a BSD line editing library,
similar to GNU readline.
It supports right-aligned prompts,
which I prefer for variable-length
information in shells.
.
.It Fl lkcgi
A CGI and FastCGI library
for web applications in C.
Don't worry,
it isolates HTTP parsing and input validation
from application logic
in sandboxed processes.
I think it's an excellent example
of how to design an API for C.
I used it to implement the
.Lk https://ascii.town/explore.html "torus web viewer" .
.
.It Fl lsqlite3
An embedded relational database engine.
It's amazing what you can do with this,
and it's super easy to use!
My one gripe with it is that the library and SQL documentation
are not available as
.Xr man 1
pages.
I'm currently working on a project using SQLite,
but it hasn't gotten very far yet.
.
.It Fl ltls
This is a new library in LibreSSL
which provides a much simpler interface for TLS sockets
compared to
.Fl lssl .
It's much more like what you'd expect
from other TLS socket wrappers,
with calls like
.Xr tls_connect 3 ,
.Xr tls_read 3
and
.Xr tls_write 3 .
I've used this for IRC clients, bouncers and bots.
.
.It Fl lz
An implementation of the DEFLATE compression algorithm
and gzip format.
It's all documented in comments in
.In zlib.h ,
which isn't bad,
but for my own use I copied the docs into
.Lk https://code.causal.agency/june/zlib-man-pages "manual pages" .
I've used this for decoding and encoding PNG images.
.El
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency
?id=39927d43b7a4bc4a3d8b16d971a0094e6a274280&follow=1'>Revert "Add first working version of imbox"June McEnroe Moved to <https://git.causal.agency/imbox>. This reverts commit 6aa7f2f6bf47fa9df9c749ce665171fa30800937. 2019-12-21Add first working version of imboxJune McEnroe 2019-12-20Respect mailmap in gl pretty formatJune McEnroe 2019-12-20Set LANG in cgit filtersJune McEnroe ttpre needs to know about UTF-8 too so it can bold/italic non-ASCII chars. 2019-12-20Source .editrc before applying -v or -eJune McEnroe Otherwise a bind -v in .editrc will take precedence and overwrite the ^I binding for sh-complete. 2019-12-20Disable signing commitsJune McEnroe Why did I ever turn this on? This gets me nothing but inconvenience. RIP to all the wasted bytes in my git repos. 2019-12-19Ignore about-filterJune McEnroe 2019-12-19Fix matching make tags with no sourcesJune McEnroe 2019-12-19Avoid matching := assignments as tagsJune McEnroe 2019-12-18Hide line numbers when rendering mdocJune McEnroe Hack: output an extra <td> after rendering mdoc so that line numbers can be hidden based on there being three. This required splitting source-filter and about-filter since on about pages there is no table. 2019-12-18Customize cgit CSSJune McEnroe 2019-12-18Use :target rather than :focus pseudo-classJune McEnroe :target persists after you click on something else. 2019-12-18Copy cgit auxiliary binaries properlyJune McEnroe 2019-12-18Add git.causal.agency cgit configJune McEnroe 2019-12-18Bail from hi if input is binaryJune McEnroe NULs in the input cause an infinite loop in htmlEscape, not to mention regexes obviously not working, etc. 2019-12-16Post "cgit setup"June McEnroe