libwisp 0.2.0

a simple-to-use wisp rust library
Documentation

libwisp-rs

A Rust library that exposes high-level APIs to get HTTP sites via Wisp. (Wisp credits: MercuryWorkshop)

first real rust project, stuff may be messy, the code wasn't meant to be readable, just be easy-to-use for whatever dev wants to use this library

THERE IS NO HTTPS URL SUPPORT IN LIBWISP-RS AT THE MOMENT HTTPS IS PLANNED FOR LIBWISP-RS 1.0.0

wss wisp servers still work, you just have to keep it HTTP-only when running a WispHTTPRequest()

Installation

cargo add libwisp

Building & Usage

For Usage, see docs/ and examples/

For Building:

git clone https://github.com/LuminosityDevelopment/libwisp-rs
cd libwisp-rs
cargo build --release

To run examples:

git clone https://github.com/LuminosityDevelopment/libwisp-rs
cd libwisp-rs
cargo run --example http_request #can be changed

FAQ

Q: How do I use an HTTPS site with this? {target_url} is saying its HTTP over HTTPS

  • A: You can't, at least, not yet with libwisp-rs 0.1.0, as it lacks HTTPS support. This is a planned feature for libwisp-rs 1.0.0

Q: How do I do ___ ?

  • A: See the documentation and examples

Q: I have a bug! Where do I report it?

  • A: Using the GitHub issues tab

Q: I have a change I'd like to make

  • A: Use the GitHub pull request feature

Credits

  • kxtzownsu - writing libwisp-rs, fact checking documentation
  • chatgpt - doing documentation (LOL)
  • MercuryWorkshop - making the Wisp protocol
  • fanqyxl - hosting wss://wispserver.dev/wisp/ which is used in examples.