slack-cli 0.1.1

slack cli Project homepage: https://github.com/isaacadams/slack-api-client 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# Slack CLI


This is a CLI tool for sending messages to Slack channels. It supports sending text messages, blocks, and attachments using the Slack API.

## Installation


Make sure the `SLACK_TOKEN` environment variable is set with your Slack bot token.
   
```bash
export SLACK_TOKEN=xoxb-your-slack-bot-token
```

### via cargo install


```sh
cargo install slack-cli
slack --help
```

### via source


1. Clone the repository.
2. Install dependencies and compile the code using `cargo build --release`.
3. cargo run -p slack-cli

## Usage


### General Command


```bash
slack <COMMAND> [OPTIONS]
```

### Commands


#### `slack send <message>`

Send a message to a Slack channel.

##### Arguments


- `--channel` (`-c`) - The Slack channel to send the message to. Accepts either the channel name (e.g., `#general`) or the channel ID.
- `--kind` (`-k`) - The type of message to send. Options are:
  - `text` - A simple text message.
  - `block` - A message with block elements (provide a JSON object).
  - `attachment` - A message with attachments (provide a JSON object).
- `<message>` - The content of the message. For `block` or `attachment`, provide a valid JSON object.

##### Example Usage


Send a text message:

```bash
slack send --channel general --kind text "Hello, Slack!"
slack send --channel=#general --kind text "Hello, Slack!"
slack send --channel "#general" --kind text "Hello, Slack!"
```

Send a block message:

```bash
slack send --channel general --kind block '[{"type": "section", "text": {"type": "mrkdwn", "text": "*Hello, Slack!*"}}]'
```

Send an attachment message:

```bash
slack send --channel general --kind attachment '[{"color":"#f2c744","blocks":[{"type":"section","text":{"type":"mrkdwn","text":"*Hello, Slack!*"}}]}]'
```

## Environment Variables


- `SLACK_TOKEN`: Required. The token for authenticating with the Slack API. Set this in your environment or use a `.env` file for local development.

## Error Handling


Ensure that all required options are provided and that the `SLACK_TOKEN` environment variable is set. The CLI will display meaningful error messages if these requirements are not met.