Something like GLib but tiny
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Přemysl Eric Janouch 0f3ed14575
asciiman: support attribute passing
1 day ago
cmake Get rid of CMake dev warnings 2 years ago
meson/packaging Little improvements 5 years ago
tests Import protocol code generator from xK, add tests 2 days ago
tools asciiman: support attribute passing 1 day ago
.clang-format Add clang-format configuration, clean up 11 months ago
.gitignore Update .gitignore 11 months ago
CMakeLists.txt Document the recently added scripts 2 days ago
LICENSE Extend string syntax in config 2 months ago
README.adoc Document the recently added scripts 2 days ago
fuzz Add remaining fuzzing entry points 2 years ago
liberty-proto.c Remove pointless, wrong constant 10 months ago
liberty-pulse.c Import libpulse poller integration, add tests 11 months ago
liberty-tui.c Name change 2 years ago
liberty.c Allow for overriding feature test macros 3 weeks ago
libertyconf.vim Add VIM syntax highlight for "config" 5 years ago
libertyxdr.adoc Document the recently added scripts 2 days ago
libertyxdr.vim Import protocol code generator from xK, add tests 2 days ago
siphash.c Add clang-format configuration, clean up 11 months ago

README.adoc

liberty

liberty is a pseudolibrary of all the common C code I have written for various projects. I used to copy-paste large swaths of code with minimal changes to it and it slowly became awfully painful to synchronize. The project can be thought of as a successor to my other C library, libxtnd.

You are supposed to import it as a git submodule and include the main source file directly everywhere you need it. Everything is declared "static". I have come to the conclusion that this style of C programming suits me the best, as it allows me to nearly forget about the mess that are header files.

The API is intentionally unstable, which allows for easy refactoring.

All development is done on Linux, but other POSIX-compatible operating systems should be supported as well. They have an extremely low priority, however, and I’m not testing them at all, with the exception of OpenBSD.

Tools

This project also hosts a number of supporting scripts written in portable AWK:

asciiman.awk

A fallback manual page generator for AsciiDoc documents, motivated by the hugeness of AsciiDoc’s and Asciidoctor’s dependency trees. It uses the man macro package.

cmake-parser.awk

Parses the CMake language to the extent that is necessary to reliably extract project versions. Its greatest limitation is its inability to expand variables, which would require a full interpreter.

cmake-dump.awk

This can be used in conjunction with the previous script to dump CMake scripts in a normalized format for further processing.

lxdrgen.awk

Protocol code generator for a variant of XDR, which is documented separately. Successfully employed in xK.

lxdrgen-c.awk

LibertyXDR backend that builds on top of the C pseudolibrary.

lxdrgen-go.awk

LibertyXDR backend for Go, supporting encoding/json interfaces. It also produces optimized JSON marshallers (however, note that the json.Marshaler interface is bound to be underperforming, due to the amount of otherwise avoidable memory allocations it necessitates).

lxdrgen-mjs.awk

LibertyXDR backend for Javascript, currently for decoding only. It cuts a corner by not using BigInts, on par with JSON.parse().

Contributing and Support

Use https://git.janouch.name/p/liberty to report any bugs, request features, or submit pull requests. git send-email is tolerated. If you want to discuss the project, feel free to join me at ircs://irc.janouch.name, channel #dev.

Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9

License

This software is released under the terms of the 0BSD license, the text of which is included within the package along with the list of authors.