Home

STRAP — STRAP Trims, Rejoins And Parses

A small, efficient C library providing missing utilities for safe and comfortable string manipulation and time helpers. Designed to be lightweight, portable, and easy to integrate into C projects.

🚀 Quick Start

# Clone and build
git clone https://github.com/murapadev/strap.git
cd strap
make

# Install (optional)
sudo make install

Basic Usage

#include <stdio.h>
#include "strap.h"

int main(void) {
    // Safe line reading
    char *line = afgets(stdin);
    if (line) {
        char *trimmed = strtrim(line);
        printf("Trimmed: '%s'\n", trimmed);
        free(line);
        free(trimmed);
    }

    // String joining
    const char *parts[] = {"Hello", "world", "from", "STRAP"};
    char *joined = strjoin(parts, 4, " ");
    printf("%s\n", joined);
    free(joined);

    return 0;
}

📚 Documentation

• Quick Start Guide - Get up and running in minutes
• API Reference - Detailed function documentation
• Examples - Code examples and use cases
• Cookbook - Practical recipes for logs, CSV wrangling, and templating
• Contributing - How to contribute to STRAP

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

🗺️ Roadmap

v0.3 (Current) ✅

• Extended locale-aware string helpers
• Optional arena allocator for transient strings
• Timezone-aware time utilities
• Unified error reporting system

v0.4 (Upcoming)

• Additional performance optimizations
  • SIMD-accelerated hot paths for strtrim/strjoin
  • Streaming-friendly buffering for afgets and file utilities (strap_line_buffer_read)
• Extended string manipulation utilities
  • High-level split helpers with delimiter limits and predicates (strsplit_limit, strsplit_predicate)
  • Case-insensitive comparison helpers (strap_strcasecmp, strcaseeq)
• Cross-platform improvements
  • Official Windows/MSVC build scripts and CI coverage
  • Locale/timezone shims for BSD and musl targets
• Enhanced documentation
  • Cookbook-style guides that solve real-world text processing tasks
  • API reference refresh with usage notes and complexity details

📄 License

MIT Licensed - see LICENSE for details.

---

STRAP - Making C string and time operations safer and more convenient.