4 releases
0.2.1 | Oct 21, 2024 |
---|---|
0.2.0 | Oct 21, 2024 |
0.1.1 | Jun 10, 2024 |
0.1.0 | Jun 10, 2024 |
#295 in Text processing
411 downloads per month
115KB
2.5K
SLoC
slack-blocks-render
Slack blocks render is a Rust library to render Slack blocks as Markdown.
Usage
First, add the slack_blocks_render
crate as a dependency:
cargo add slack_blocks_render
Slack blocks render uses the slack_morphism
data model as input so you should also add it as a dependency:
cargo add slack_morphism
Simple usage (without Slack references resolution)
use slack_morphism::prelude::*;
use slack_blocks_render::{render_blocks_as_markdown, SlackReferences};
let blocks: Vec<SlackBlock> = vec![
SlackBlock::RichText(serde_json::json!({
"type": "rich_text",
"elements": [
{
"type": "rich_text_section",
"elements": [
{
"type": "text",
"text": "Hello World"
}
]
},
]
})),
];
let markdown_text = render_blocks_as_markdown(blocks, SlackReferences::default());
Usage with Slack references resolution
Slack references resolution is useful when you want to resolve user ID, channel ID, or user group ID in the Slack blocks. Here is an example on how to use it:
use slack_morphism::prelude::*;
use slack_blocks_render::{
find_slack_references_in_blocks, render_blocks_as_markdown, SlackReferences
};
let blocks: Vec<SlackBlock> = vec![
SlackBlock::RichText(serde_json::json!({
"type": "rich_text",
"elements": [
{
"type": "rich_text_section",
"elements": [
{
"type": "text",
"text": "Hello "
}
]
},
{
"type": "rich_text_section",
"elements": [
{
"type": "user",
"text": "U123456"
}
]
},
]
})),
];
// First, extract Slack references from the blocks
let slack_references = find_slack_references_in_blocks(&blocks);
// Then, resolve the references before rendering the blocks, this is on your own
// For example, you can use Slack API to resolve them
// ...
// let slack_user_ids = slack_references.users.keys().cloned().collect::<Vec<_>>();
// for slack_user_id in slack_user_ids {
// let user_info = slack_api_client.users_info(slack_user_id).await?;
// slack_references.users.insert(slack_user_id, user_info.name);
// }
// Finally, render the blocks as Markdown
let markdown_text = render_blocks_as_markdown(blocks, slack_references);
License
This project is distributed under the terms of the Apache License (Version 2.0).
See LICENSE
Dependencies
~11–20MB
~292K SLoC