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
>2009-07-25cgitrc.5.txt: document 'embedded' and 'noheader'Lars Hjemli 2009-07-25Add support for 'noheader' optionLars Hjemli 2009-07-25cgitrc.5.txt: document 'head-include'Lars Hjemli 2009-07-25ui-blob: return 'application/octet-stream' for binary blobsLars Hjemli 2009-07-25ui-plain: Return 'application/octet-stream' for binary files.Remko Tronçon 2009-06-11use cgit_httpscheme() for atom feedDiego Ongaro 2009-06-11add cgit_httpscheme() -> http:// or https://Diego Ongaro 2009-06-07Return http statuscode 404 on unknown branchLars Hjemli 2009-06-07Add head-include configuration option.Mark Lodato 2009-03-15CGIT 0.8.2.1Lars Hjemli 2009-03-15Fix doc-related glitches in Makefile and .gitignoreLars Hjemli 2009-03-15ui-snapshot: avoid segfault when no filename is specifiedLars Hjemli 2009-03-15fix segfault when displaying empty blobsEric Wong 2009-02-19Add support for HEAD requestsLars Hjemli 2009-02-19Add support for ETag in 'plain' viewLars Hjemli 2009-02-12ui-tree: escape ascii-text properly in hexdump viewLars Hjemli 2009-02-12Makefile: add doc-related targetsLars Hjemli