|Alex D. b06ce004c8||2 years ago|
|include/uirc||2 years ago|
|src||2 years ago|
|.clang-format||3 years ago|
|.clang-tidy||2 years ago|
|CMakeLists.txt||2 years ago|
|COPYING||3 years ago|
|README.md||2 years ago|
MicroIRC, a simple, lightweight IRC protocol helper
- CMake (tested on 3.17)
- C99 compiler (ideally clang or gcc, should work with anything that supports these though)
- corelibs libraries (https://git.redxen.eu/caskd/corelibs)
- llist (linked list library)
- stringext (string.h extensions/wrappers)
First, create the required build files (usually the Makefile)
cmake -B build/ -DCMAKE_BUILD_TYPE=Release .
|BUILD_IRCV3||Build IRCv3 support||boolean||WIP ~20%||false|
|BUILD_VALIDATORS||Build validators that check if the messages follow the standards||boolean||WIP 0%||false|
|BUILD_DOCS||Build documentation using doxygen||boolean||WIP ~35%||false|
|BUILD_TESTS||Build tests that check if the build results behave as they should||boolean||WIP ~60%||false|
|CODE_ANALYZER||Use static analysis tools||boolean||WIP TK||false|
|CODE_COVERAGE||Generate code coverage output||boolean||WIP CI||false|
Following that, just use your build system and compile it
Example for make:
make -C build
You now should have the library built at
- IRC message parsing and assembly that doesn't lose details
- Simple message allocation and translation between string format and in-memory structure
Planned / Not finished
- RFC2812 compliant parser (still need to verify a few things)
- Variable-size lists wrappers (capabilities, tags, messages in a buffer etc.)
- Message validators (checks messages for formatting problems)
- CTCP -> ANSI formatting translation
- Mode masks
I have started this project initally to learn more about the protocol and learn C. This project has taught me on how to organize code, what tasks are required to maintain a codebase clean and other smaller things. Over the time this learning process has resulted into multiple rewrites or/and redesigns. These include:
- Splitting the daemon from the core (library)
- Parsing tags into structs
- Storing structs in memory instead of pointers to buffers
- Separating structs
- Parsing read-only by copying buffers
Each of these required redesigning some/all of the code and some also have their downsides.
Over the time it has turned into a more generalized library that is supposed to not be tied to a specific codebase. I am motivated to write this as i've seen that many codebases have turned into overly-fragmented code or monolithic code. This library isn't supposed to replace any other libraries but instead it should fill this small space that i've noticed was missing.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.