*ae* (***a**lmost **e**verything*) is an auxiliary
general-purpose D library. It is used by forum.dlang.org, Digger,
the D documentation auto-tester, and most of my D projects in
general.
Among many things, it implements an asynchronous event loop,
several network protocols, and various utility code to complement
the D standard library (Phobos).
https://github.com/CyberShadow/ae
The library's Git repository reached a nice round number of
commits the other day, which might as well be an occasion to make
this announcement, in case someone finds something useful for
their D adventures here. Please see [the README
document](https://github.com/CyberShadow/ae#overview) for an
overview of what can be found in the library.
### What's new in *ae*?
Notable additions within the last 1000 commits:
- All public declarations have been documented (with help from [a
DMDFE-based linter](https://github.com/CyberShadow/dlint)). You
can browse the documentation on
[ae.dpldocs.info](https://ae.dpldocs.info/ae.html).
-
[`ae.net.http`](https://github.com/CyberShadow/ae/tree/master/net/http) can now be used to accept HTTP requests and send replies not just over plain HTTP(S)-over-TCP, but also using CGI, FastCGI or SCGI over a variety of transports.
-
[`ae.net.http.app`](https://github.com/CyberShadow/ae/blob/master/net/http/app/server.d) provides a central point which allows your users to configure and integrate your web app with practically any environment. [Example of a configuration file doing so](https://github.com/CyberShadow/cirun/blob/86d54e4724bcdf4395c01cb488c1d059ae482d01/src/cirun.conf.sample#L36-L114).
-
[`ae.net.ssl.openssl`](https://github.com/CyberShadow/ae/blob/master/net/ssl/openssl.d) now passes most badssl.com tests.
-
[`ae.sys.file.listDir`](https://ae.dpldocs.info/~next/ae.sys.file.listDir.html) is a fast and flexible directory iterator. It sacrifices providing results as a range to instead gain allowing to decide on-the-spot when to recurse. The speed gains come from avoiding `stat` calls by taking advantage of the `dirent.d_type` field, and allowing applications to avoid GC allocations when querying directory entry names.
-
[`ae.utils.mapset`](https://github.com/CyberShadow/ae/blob/master/utils/mapset.d) is a data structure which allows holding and performing operations on very large sets of maps. Applications include fully exploring program states for all possible inputs, e.g. for fuzzing.
-
[`ae.utils.promise`](https://github.com/CyberShadow/ae/blob/master/utils/promise.d) is an implementation of JavaScript-like promises, and attempts to follow the Promises/A+ specification as closely as possible. [Discussed here](https://forum.dlang.org/post/pzbyxaxssokctpgpr...@forum.dlang.org).
-
[`ae.utils.meta.tuplerange`](https://github.com/CyberShadow/ae/blob/master/utils/meta/tuplerange.d) contains constructs for iterating and chaining together operations on range-like constructs which operate on heterogeneous types. The standard D range interface does not provide this, so an internal iteration API is used instead. You may recall me mentioning `ae.utils.meta.chain` during a DConf talk - `meta.tuplerange` is `meta.chain`'s successor.
-
[`ae.utils.math.longmul`](https://github.com/CyberShadow/ae/blob/master/utils/math/longmul.d) wraps x86 long (up to 128-bit) multiplication and division in D. [Also seen is DustMite](https://dlang.org/blog/2020/04/13/dustmite-the-general-purpose-data-reduction-tool/).
-
[`ae.utils.graphics.libpng`](https://github.com/CyberShadow/ae/blob/master/utils/graphics/libpng.d) bridges libpng and `ae.utils.graphics.image`, allowing decoding arbitrary PNGs into the user-defined `Image` type. Because the `Image` color type is set at compile-time, the module configures `libpng` to decode the PNG into the `Image`'s color type. The exhaustingly thorough test suite even identified [some bugs in libpng itself](https://github.com/glennrp/libpng/pull/270).
-
[`ae.utils.sound`](https://github.com/CyberShadow/ae/tree/master/utils/sound) is a package to generate, load, and save simple audio samples. Waveforms can be generated as D ranges (using e.g. `std.algorithm`) and then mixed / played / saved. The included space shooter demo game [pewpew](https://github.com/CyberShadow/ae/blob/master/demo/pewpew/) uses this package to generate and play procedural sound effects.
Thanks for reading!
