Package: sigan
🙏 Sigan - Very simple CLI slack alarm manager 🙏A convenient app that allows you to set alarms through a simple CLI. Create alarms in Slack with simple commands!🛎 Current Version0.1.22Upgrade withpip install sigan --upgrade🚀 Installation & SettingsFirst, you need to download the Slack app by clicking the link below.
(You can choose the workspace where you want to install it in the upper right corner of the link.)Although it has not been officially approved by Slack yet, it will be approved in the future. Rest assured, it is not a hacking program!Once you have downloaded the "Sigan Slack App" through the link, you will receive a message as shown below. Check if the team ID has arrived in the message and copy it!Next, make sure that Python is version3.9or higher. Then enter the following commands in the terminal:pipinstallsiganAfter the installation is complete, proceed with registration using the following command:siganregisterYou will be prompted to enter the team ID that you copied earlier``
If you entered the correct team ID, you will receive a message confirming that the registration is complete.Now, you are all set! However, please check a few restrictions.⚠️ RestrictionsThis project is created by an inexperienced child and contains strange code and suboptimal implementations. We will strive to make it a new and better project.You can set message reservations up to 120 days in the future.You cannot schedule more than 30 messages within 5 minutes in the same channel.Slack API referenceIf a scheduled message is going to be sent within 5 minutes, it cannot be deleted, resulting in an error.This may be a bug, as the official documentation states within 1 minute, but the API returns "OK" while it fails in the background.Slack API referenceReferenceSigan bot operates in a single Slack workspace only.If you want to use it in a different Slack workspace, you need to install it in the new workspace through the "App to Slack" link at the top and run sigan register again.You also need to remove the existing Sigan bot from the previous Slack workspace.👨‍💻 Commands0. InformationIf you want to know the general information about commands, you can use the following command:sigan--helpFor more detailed information about specific commands, you can use the following command:sigan<commandname>--helpYou can check the version of the Sigan CLI with the following command:sigan--version1. add commandsiganadd<content>[-d|--deadline<deadlinedate>][-t|--time<notificationdate>[-i|--interval<dayoftheweek>][-b|--before<Setconfirmalarmdatexdaysbeforedeadline>]][-c|--channel<Selectslackchannel>]1.1 add command rule < content ><content>isrequired.If there are spaces in the content, please use""to enter it. If there are no spaces, you can omit"".1.2 add command rule < deadline >-d | --deadline <deadline date>isoptional.When setting a deadline, a confirmation alarm will be sent one day before the deadline, separate from the notification time.If you want to set a different number of days before the deadline instead of one day, you can use the-b | --beforecommand to specify how many days before the deadline.If you don't set a deadline, a confirmation alarm will not be sent.1.3 add command rule < notification time >-t | --time <notification date>is somewhatoptional.If you enter a date without specifying a time, the default time of 09:00 will be set.If you only enter a time, you must use the-i | --intervalcommand to set the repeat interval.ex)sigan add "notification setting" -t 12:10 -i thu1.4 add command rule < interval >-i | --interval <day of the week>is somewhatoptional.
-If you want to send alarms on more than two days of the week, you can use""to select multiple days.ex)sigan add "interval setting" -t 15:00 -i "mon fri"If you have both date and time specified for the alarm, you cannot use the interval command.1.5 add command rule < before >-b | --before <Set confirm alarm date x days before deadline>isoptional.ex)sigan add "before test" -d 10/20 -t 14:00 -i mon -b 31.6 add command rule < channel >-c | --channel <Select slack channel>isoptional.To select a channel, you must first invite the Sigan bot to that channel.Enter the name of the channel where the Sigan bot was invited and the alarm will be sent to that channel.If you do not select a channel, the alarm will be sent to Sigan bot's DM.2. show commandYou can use theshowcommand to check alarm events.siganshow3. delete commandYou can delete existing alarms using thedeletecommand.sigandelete<alarm_id>[-y|--yes]You can use-y | --yesto suppress the confirmation prompt when deleting alarms. If you don't use it, a confirmation prompt will be shown when deleting alarms.4. chcnt commandYou can change the content of existing alarms using thechcntcommand.siganchcnt<alarm_id><content>ex)sigan chcnt 1 "test content change"5. chdl commandYou can change the deadline of existing alarms using thechdlcommand.siganchdl<alarm_id><deadline>ex)sigan chdl 1 12/25,sigan chdl 1 "2023/12/25"You cannot set a deadline that is earlier than the notification time of the existing alarm.6. chdate commandYou can change the notification time of existing alarms using thechdatecommand.siganchdate<alarm_id><date>To change only the timeex)sigan chdate 1 -d 15:00To change only the dateex)sigan chdate 1 10/24,sigan chdate 1 "2023/10/24"To change both the date and timeex)sigan chdate 1 "2023/12/10 15:00"7. chinv commandYou can change the interval of existing alarms using thechinvcommand.siganchinv<alarm_id><interval>ex)sigan chinv 1 wed⏭ What's next?Interworking with Google CalendarAdd slack slash command🚮 UninstallingIf, for some reason, you want to uninstall the app, you can do so with the following command:pipuninstallsigan