aboutsummaryrefslogtreecommitdiffstats
path: root/README.rst
blob: 9c7eb435560fc168097033c050a180f998f6b616 (plain)
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
======
 yasl
======
----------------------------------
 Yet Another String Library for C
----------------------------------

yasl is a simple dynamic string library for the C programming language,
targeting C99 and C11, and forked from the SDS library that was split out from
Redis.

Testing
=======

The yasl test suite is compiled with C99 and written using twbctf_.

To compile and run the test suite, run the following command::

    make test

.. _twbctf: https://github.com/HalosGhost/twbctf

Usage
=====

To use yasl copy the contents of the :literal:`src` directory into your sources
and include the :literal:`yasl.h` header into the files which need to use yasl.

The new API documentation aren’t finished yet, but a copy of the old SDS README
is available in :literal:`docs/README.md.sds`, and reading the yasl header and
test suite will provide a foundation for how to use it.

License
=======

Every file in this repository, except for as otherwise specified in the file
itself or in this README if not possible, is licensed under a 2-clause BSD
license.