ae v0.0.3000

[Vladimir Panteleev]

*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/pzbyxaxssokctpgprikz@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!