# Spikard FFI
<div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
<a href="https://crates.io/crates/spikard">
<img src="https://img.shields.io/crates/v/spikard?label=Rust&color=007ec6" alt="Rust">
</a>
<a href="https://pypi.org/project/spikard/">
<img src="https://img.shields.io/pypi/v/spikard?label=Python&color=007ec6" alt="Python">
</a>
<a href="https://www.npmjs.com/package/@spikard/node">
<img src="https://img.shields.io/npm/v/@spikard/node?label=Node.js&color=007ec6" alt="Node.js">
</a>
<a href="https://www.npmjs.com/package/@spikard/wasm">
<img src="https://img.shields.io/npm/v/@spikard/wasm?label=WASM&color=007ec6" alt="WASM">
</a>
<a href="https://rubygems.org/gems/spikard">
<img src="https://img.shields.io/gem/v/spikard?label=Ruby&color=007ec6" alt="Ruby">
</a>
<a href="https://packagist.org/packages/spikard/spikard">
<img src="https://img.shields.io/packagist/v/spikard/spikard?label=PHP&color=007ec6" alt="PHP">
</a>
<a href="https://hex.pm/packages/spikard">
<img src="https://img.shields.io/hexpm/v/spikard?label=Elixir&color=007ec6" alt="Elixir">
</a>
<a href="https://central.sonatype.com/artifact/dev.spikard/spikard">
<img src="https://img.shields.io/maven-central/v/dev.spikard/spikard?label=Java&color=007ec6" alt="Java">
</a>
<a href="https://github.com/Goldziher/spikard/releases">
<img src="https://img.shields.io/github/v/tag/Goldziher/spikard?label=Go&color=007ec6" alt="Go">
</a>
<a href="https://www.nuget.org/packages/Spikard/">
<img src="https://img.shields.io/nuget/v/Spikard?label=C%23&color=007ec6" alt="C#">
</a>
<a href="https://github.com/Goldziher/spikard/blob/main/LICENSE">
<img src="https://img.shields.io/badge/License-MIT-007ec6" alt="License">
</a>
<a href="https://github.com/Goldziher/spikard">
<img src="https://img.shields.io/badge/docs-GitHub-007ec6" alt="Documentation">
</a>
</div>
C/C++ FFI bindings for the spikard HTTP framework. Stable ABI shared library for native integration, cross-language bridging (Go, Zig, Kotlin JNI), and embedding the Rust HTTP core into any C-compatible host.
## Installation
```bash
cargo add spikard-ffi
```
### System Requirements
- C99 or C++11 compiler; `spikard-ffi` static/shared library from [GitHub Releases](https://github.com/Goldziher/spikard/releases)
## Quick Start
See the [spikard repository](https://github.com/Goldziher/spikard) for usage examples and guides.
## Features
- **HTTP routing** — type-safe route definitions with path, query, and body parameter validation
- **OpenAPI / AsyncAPI / GraphQL / JSON-RPC** — code generation and spec parsing built in
- **Tower middleware** — compression, rate limiting, timeouts, auth (JWT/API key), static files
- **Lifecycle hooks** — `onRequest`, `preValidation`, `preHandler`, `onResponse`, `onError`
- **Fixture-driven testing** — shared JSON fixtures drive tests across all language bindings
- **Polyglot** — single Rust core, thin bindings for Python, Node.js, Ruby, PHP, Elixir, Go, Java, C#, Kotlin, Dart, Gleam, WASM, Swift, Zig, and C FFI
## Documentation
- **[Repository](https://github.com/Goldziher/spikard)** — source code, examples, and contributing guide
- **[Examples](https://github.com/Goldziher/spikard/tree/main/examples)** — working examples per language
- **[Issues](https://github.com/Goldziher/spikard/issues)** — bug reports and feature requests
## Contributing
Contributions are welcome. See [CONTRIBUTING.md](https://github.com/Goldziher/spikard/blob/main/CONTRIBUTING.md).
## License
MIT License — see [LICENSE](https://github.com/Goldziher/spikard/blob/main/LICENSE) for details.