https://github.com/H1rono/traq-bot-http-rs

traQ BOTのHTTPリクエストパーサー
https://github.com/H1rono/traq-bot-http-rs

rust traq traq-bot

Last synced: 2 months ago
JSON representation

traQ BOTのHTTPリクエストパーサー

• Host: GitHub
• URL: https://github.com/H1rono/traq-bot-http-rs
• Owner: H1rono
• License: mit
• Created: 2023-02-15T10:55:28.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-01T13:42:28.000Z (2 months ago)
• Last Synced: 2024-11-01T14:31:43.506Z (2 months ago)
• Topics: rust, traq, traq-bot
• Language: Rust
• Homepage: https://crates.io/crates/traq-bot-http
• Size: 489 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# traq-bot-http-rs

[![Rust](https://github.com/H1rono/traq-bot-http-rs/actions/workflows/rust.yml/badge.svg)](https://github.com/H1rono/traq-bot-http-rs/actions/workflows/rust.yml)

[![codecov](https://codecov.io/gh/H1rono/traq-bot-http-rs/branch/main/graph/badge.svg?token=UEA9118L9I)](https://codecov.io/gh/H1rono/traq-bot-http-rs)

[![Release](https://github.com/H1rono/traq-bot-http-rs/actions/workflows/release.yml/badge.svg)](https://github.com/H1rono/traq-bot-http-rs/actions/workflows/release.yml)

[![docs.rs](https://img.shields.io/docsrs/traq-bot-http?logo=docsdotrs)](https://docs.rs/traq-bot-http/latest/traq_bot_http/)

[![GitHub](https://img.shields.io/github/license/H1rono/traq-bot-http-rs?logo=github)](https://github.com/H1rono/traq-bot-http-rs/blob/main/LICENSE)

[![Crates.io](https://img.shields.io/crates/l/traq-bot-http?logo=docsdotrs)](https://crates.io/crates/traq-bot-http)

[![GitHub release (with filter)](https://img.shields.io/github/v/release/h1rono/traq-bot-http-rs?logo=github)](https://github.com/H1rono/traq-bot-http-rs/releases/latest)

[![Crates.io](https://img.shields.io/crates/v/traq-bot-http?logo=rust)](https://crates.io/crates/traq-bot-http)

traQ BOTのPOSTリクエストをパースするライブラリです。

## example

`Cargo.toml`

```toml

# ...

[dependencies]

http = "1.0"

axum = "0.7"

tokio = { version = "1", features = ["full"] }

traq-bot-http = { version = "0.10", features = ["http"] }

```

`main.rs`

```rust

use std::{env, net::SocketAddr};

use axum::extract::{Request, State};

use axum::{routing::post, Router};

use http::StatusCode;

use tokio::net::TcpListener;

use traq_bot_http::{Event, RequestParser};

#[tokio::main]

async fn main() {

    let verification_token = env::var("VERIFICATION_TOKEN").unwrap();

    let parser = RequestParser::new(&verification_token);

    let app = Router::new().route("/", post(handler)).with_state(parser);

    let addr = SocketAddr::from(([127, 0, 0, 1], 8080));

    let server = TcpListener::bind(addr).await.unwrap();

    axum::serve(server, app).await.unwrap();

}

async fn handler(State(parser): State, request: Request) -> StatusCode {

    match parser.parse_request(request).await {

        Ok(Event::MessageCreated(payload)) => {

            print!(

                "{}さんがメッセージを投稿しました。\n内容: {}\n",

                payload.message.user.display_name, payload.message.text

            );

            StatusCode::NO_CONTENT

        }

        Ok(_) => StatusCode::NO_CONTENT,

        Err(err) => {

            eprintln!("ERROR: {err}");

            StatusCode::INTERNAL_SERVER_ERROR

        }

    }

}

```

## Features

feature | 機能 | バージョン

:-- | :-- | :--

`uuid` | ペイロードのUUID値が[`uuid::Uuid`](https://docs.rs/uuid/latest/uuid/struct.Uuid.html)型に | [v0.4.0](https://github.com/H1rono/traq-bot-http-rs/releases/tag/v0.4.0)から

`time` | ペイロードのタイムスタンプ値([RFC3339 format](https://tools.ietf.org/html/rfc3339#section-5.6))が[`time::OffsetDateTime`](https://docs.rs/time/latest/time/struct.OffsetDateTime.html)型に | [v0.5.0](https://github.com/H1rono/traq-bot-http-rs/releases/tag/v0.5.0)から

`chrono` | ペイロードのタイムスタンプ値が[`chrono::DateTime`](https://docs.rs/chrono/latest/chrono/struct.DateTime.html)型に | [v0.6.0](https://github.com/H1rono/traq-bot-http-rs/releases/tag/v0.6.0)から

`http` | [`http::Request`](https://docs.rs/http/latest/http/request/struct.Request.html)型のサポート | [v0.10.0](https://github.com/H1rono/traq-bot-http-rs/releases/tag/v0.10.0)

※`time`よりも`chrono`の方が優先されます

## Contributing

Issue, Pull Requestは大歓迎です。