An unofficial clerk.dev SDK for rust
Note: This SDK is updated frequently to keep up with any changes to the actual Clerk API. If you see anything that needs updated or is not inline with the offical Clerk api, open an issue!
A unofficial clerk.dev SDK. For more detailed documentation, please reference the clerk docs: https://clerk.com/docs/reference/backend-api
Example
Checkout examples in the
/examplesdirectory
Using a traditional http request to a valid clerk endpoint:
use tokio;
use clerk_rs::{clerk::Clerk, ClerkConfiguration, endpoints::ClerkGetEndpoint};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let config = ClerkConfiguration::new(None, None, Some("sk_test_key".to_string()), None);
let client = Clerk::new(config);
let res = client.get(ClerkGetEndpoint::GetUserList).await?;
Ok(())
}
Using a clerk-rs method:
use tokio;
use clerk_rs::{clerk::Clerk, ClerkConfiguration, apis::emails_api::Email};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let config = ClerkConfiguration::new(None, None, Some("sk_test_key".to_string()), None);
let client = Clerk::new(config);
Email::create(&client, Some(your_clerk_email));
Ok(())
}
Protecting a actix-web endpoint with Clerk.dev:
use actix_web::{web, App, HttpServer, Responder};
use clerk_rs::{ClerkConfiguration, validators::actix::ClerkMiddleware};
async fn index() -> impl Responder {
"Hello world!"
}
#[actix_web::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(|| {
let config = ClerkConfiguration::new(None, None, Some("sk_test_key".to_string()), None);
App::new().service(
web::scope("/app")
.wrap(ClerkMiddleware::new(config))
.route("/index", web::get().to(index)),
)
})
.bind(("127.0.0.1", 8080))?
.run()
.await
}
Roadmap
- Support other http clients along with the default reqwest client (like hyper)
- Tokio and async-std async runtimes for hyper clients
- Optional reqwest blocking client
- Support authorization via __session cookie on same-origin
- Add validator support for axum, rocket, warp
Note: This SDK is completely maintained by the Rust community and is by no means affiliated with Clerk.dev.
4 Jan 12, 2023
17 Jan 31, 2023
71 Apr 15, 2023
5 May 25, 2023
30 Oct 10, 2023
24 Sep 3, 2024
270 Jan 5, 2023
58 Dec 18, 2022
9 Jan 3, 2022
3 Sep 22, 2023
3 Mar 29, 2024
8 Jul 26, 2022
2 Dec 14, 2022
1 Mar 7, 2022
9 Oct 11, 2022
15 Sep 21, 2022
30 Oct 20, 2022
6 Sep 11, 2022
17 Nov 12, 2022