slack machine

Mesin kendur

Slack Machine adalah kerangka kerja bot kendur yang sederhana, namun kuat dan dapat diperpanjang. Lebih dari sekadar bot, Slack Machine adalah kerangka kerja yang membantu Anda mengembangkan ruang kerja kendur Anda menjadi pembangkit tenaga listrik ChatOps. Slack Machine dibangun dengan sistem plugin intuitif yang memungkinkan Anda membangun bot dengan cepat, tetapi juga memungkinkan organisasi kode yang mudah. Plugin dapat terlihat sesederhana ini:

 from machine . plugins . base import MachineBasePlugin
from machine . plugins . message import Message
from machine . plugins . decorators import respond_to


class DeploymentPlugin ( MachineBasePlugin ):
    """Deployments"""

    @ respond_to ( r"deploy (?P<application>w+) to (?P<environment>w+)" )
    async def deploy ( self , msg : Message , application , environment ):
        """deploy <application> <environment>: deploy application to target environment"""
        await msg . say ( f"Deploying { application } to { environment } " )

Melanggar perubahan

Dukungan menjatuhkan untuk Python 3.8 (v0.38.0)

Pada v0.38.0, dukungan untuk Python 3.8 telah dijatuhkan. Python 3.8 telah mencapai akhir kehidupan pada 2024-10-07.

Fitur

• Mulailah dengan konfigurasi mininal
• Dibangun di atas API Slack Events untuk merespons dengan lancar acara di setengah real-time. Menggunakan mode soket sehingga bot Anda tidak perlu terpapar ke internet!
• Dukungan untuk Interaksi Kaya Menggunakan Slack Web API
• API tingkat tinggi untuk kenyamanan maksimal saat membangun plugin
• API tingkat rendah untuk fleksibilitas maksimum
• Dibangun di atas asyncio untuk memastikan kinerja yang baik dengan menangani komunikasi dengan slack secara bersamaan

Fitur API Plugin:

• Dengarkan dan tanggapi ekspresi reguler apa pun
• Menanggapi perintah slash
• Menangkap bagian -bagian pesan untuk digunakan sebagai variabel dalam fungsi Anda
• Tanggapi pesan di saluran, grup, dan percakapan pesan langsung
• Menanggapi dengan reaksi
• Merespons di utas
• Menanggapi dengan pesan sesaat
• Kirim DM ke pengguna mana pun
• Dukungan untuk blok
• Dukungan untuk lampiran pesan [Legacy?]
• Dukungan untuk elemen interaktif
• Dukungan untuk modal
• Dengarkan dan Tanggapi Acara Slack yang Didukung oleh Acara API
• Menyimpan dan mengambil segala jenis data dalam penyimpanan persisten (saat ini Redis, DynamoDB, SQLite dan penyimpanan dalam memori didukung)
• Jadwalkan Tindakan dan Pesan
• Memancarkan dan mendengarkan acara
• Membantu teks untuk plugin

Segera hadir

• Dukungan untuk jalan pintas
• ... dan banyak lagi

Instalasi

Anda dapat menambahkan mesin slack ke proyek UV Anda dengan menjalankan:

uv add slack-machine

Atau tambahkan ke proyek puisi Anda:

poetry add slack-machine

Terakhir, Anda dapat menginstalnya menggunakan PIP (tidak disarankan):

$ pip install slack-machine

Sangat disarankan agar Anda menginstal slack-machine di dalam lingkungan virtual!

Penggunaan

1. Buat direktori untuk bot mesin slack Anda: mkdir my-slack-bot && cd my-slack-bot

2. Tambahkan file local_settings.py ke direktori bot Anda: touch local_settings.py

3. Buat aplikasi baru di Slack: https://api.slack.com/apps

4. Pilih untuk membuat aplikasi dari manifes aplikasi

5. Salin/Tempel Manifes berikut: manifest.yaml

6. Tambahkan aplikasi Slack dan token bot ke local_settings.py Anda seperti ini:

    SLACK_APP_TOKEN = "xapp-my-app-token"
   SLACK_BOT_TOKEN = "xoxb-my-bot-token"
   

7. Mulailah bot dengan slack-machine

8. ...

9. Laba!

Dokumentasi

Anda dapat menemukan dokumentasi untuk mesin slack di sini: https://dondebonair.github.io/slack-machine/

Bacalah untuk mempelajari cara mengkonfigurasi mesin slack dengan benar, menulis plugin, dan banyak lagi!

Ada juga contoh plugin yang memamerkan banyak fitur Slack Machine: Slack Machine Kitchensink Plugin