slack-smart-bot 1.9.1 → 1.11.0

data/lib/slack/smart-bot/commands/general_bot_commands.rb

@@ -0,0 +1,504 @@
+# add here the general commands you will be using in any channel where The SmartBot is part of. Not necessary to use ! or ^, it will answer directly.
+def general_bot_commands(user, command, dest, files = [])
+    
+  begin
+    if config.simulate
+      display_name = user.profile.display_name
+    else
+      if user.profile.display_name.to_s.match?(/\A\s*\z/)
+        user.profile.display_name = user.profile.real_name
+      end
+      display_name = user.profile.display_name
+    end
+
+    case command
+
+
+      # help: ----------------------------------------------
+      # help: `bot help`
+      # help: `bot help COMMAND`
+      # help: `bot rules`
+      # help: `bot rules COMMAND`
+      # help: `bot help expanded`
+      # help: `bot rules expanded`
+      # help: `bot what can I do?`
+      # help:    it will display this help. For a more detailed help call `bot help expanded` or `bot rules expanded`.
+      # help:    if COMMAND supplied just help for that command
+      # help:    you can use the option 'expanded' or the alias 'extended'
+      # help:    `bot rules` will show only the specific rules for this channel.
+      # help:    <https://github.com/MarioRuiz/slack-smart-bot#bot-help|more info>
+      # help: command_id: :bot_help
+      # help:
+
+
+      # help: ----------------------------------------------
+      # help: `Hi Bot`
+      # help: `Hi Smart`
+      # help: `Hello Bot` `Hola Bot` `Hallo Bot` `What's up Bot` `Hey Bot` `Hæ Bot`
+      # help: `Hello THE_NAME_OF_THE_BOT`
+      # help:    Bot starts listening to you if you are on a Bot channel
+      # help:    After that if you want to avoid a single message to be treated by the smart bot, start the message by -
+      # help:    Also apart of Hello you can use _Hallo, Hi, Hola, What's up, Hey, Hæ_
+      # help:    <https://github.com/MarioRuiz/slack-smart-bot#how-to-access-the-smart-bot|more info>
+      # help: command_id: :hi_bot
+      # help:
+      when /\A\s*(Hello|Hallo|Hi|Hola|What's\sup|Hey|Hæ)\s+(#{@salutations.join("|")})\s*$/i
+          hi_bot(user, dest, user.name, display_name)
+
+      # help: ----------------------------------------------
+      # help: `Bye Bot`
+      # help: `Bye Smart`
+      # help: `Bye NAME_OF_THE_BOT`
+      # help:    Bot stops listening to you if you are on a Bot channel
+      # help:    Also apart of Bye you can use _Bæ, Good Bye, Adiós, Ciao, Bless, Bless Bless, Adeu_
+      # help:    <https://github.com/MarioRuiz/slack-smart-bot#how-to-access-the-smart-bot|more info>
+      # help: command_id: :bye_bot
+      # help:
+      when /\A\s*(Bye|Bæ|Good\s+Bye|Adiós|Ciao|Bless|Bless\sBless|Adeu)\s+(#{@salutations.join("|")})\s*$/i
+          bye_bot(dest, user.name, display_name)
+
+        # help: ----------------------------------------------
+        # help: `add announcement MESSAGE`
+        # help: `add red announcement MESSAGE`
+        # help: `add green announcement MESSAGE`
+        # help: `add yellow announcement MESSAGE`
+        # help: `add white announcement MESSAGE`
+        # help: `add EMOJI announcement MESSAGE`
+        # help:     It will store the message on the announcement list labeled with the color or emoji specified, white by default.
+        # help:        aliases for announcement: statement, declaration, message
+        # help:  Examples:
+        # help:     _add green announcement :heavy_check_mark: All customer services are up and running_
+        # help:     _add red declaration Customers db is down :x:_
+        # help:     _add yellow statement Don't access the linux server without VPN_
+        # help:     _add message `*Party* will start at *20:00* :tada:`_
+        # help:     _add :heavy_exclamation_mark: message Pay attention all DB are on maintenance until 20:00 GMT_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#announcements|more info>
+        # help: command_id: :add_announcement
+        # help: 
+      when /\A\s*(add|create)\s+(red\s+|green\s+|white\s+|yellow\s+)?(announcement|statement|declaration|message)\s+(.+)\s*\z/i,
+        /\A\s*(add|create)\s+(:\w+:)\s+(announcement|statement|declaration|message)\s+(.+)\s*\z/i
+        type = $2.to_s.downcase.strip
+        type = 'white' if type == ''
+        message = $4
+        add_announcement(user, type, message)
+        
+
+        # help: ----------------------------------------------
+        # help: `delete announcement ID`
+        # help:     It will delete the message on the announcement list.
+        # help:        aliases for announcement: statement, declaration, message
+        # help:  Examples:
+        # help:     _delete announcement 24_
+        # help:     _delete message 645_
+        # help:     _delete statement 77_
+        # help:     _delete declaration 334_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#announcements|more info>
+        # help: command_id: :delete_announcement
+        # help: 
+      when /\A\s*(delete|remove)\s+(announcement|statement|declaration|message)\s+(\d+)\s*\z/i
+        message_id = $3
+        delete_announcement(user, message_id)
+
+        # help: ----------------------------------------------
+        # help: `see announcements`
+        # help: `see red announcements`
+        # help: `see green announcements`
+        # help: `see yellow announcements`
+        # help: `see white announcements`
+        # help: `see EMOJI announcements`
+        # helpmaster: `see announcements #CHANNEL`
+        # helpmaster: `see all announcements`
+        # help:     It will display the announcements for the channel.
+        # help:        aliases for announcements: statements, declarations, messages
+        # helpmaster:        In case #CHANNEL it will display the announcements for that channel. Only master admins can use it from a DM with the Smartbot.
+        # helpmaster:        In case 'all' it will display all the announcements for all channels. Only master admins can use it from a DM with the Smartbot.
+        # help:  Examples:
+        # help:     _see announcements_
+        # help:     _see white messages_
+        # help:     _see red statements_
+        # help:     _see yellow declarations_
+        # help:     _see messages_
+        # help:     _see :heavy_exclamation_mark: messages_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#announcements|more info>
+        # help: command_id: :see_announcements
+        # help: 
+      when /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:\w+:\s+)?(announcements|statements|declarations|messages)()\s*\z/i,
+        /\A\s*see\s+(all\s+)?(announcements|statements|declarations|messages)()\s*\z/i,
+        /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:\w+:\s+)?(announcements|statements|declarations|messages)\s+#([\w\-]+)\s*\z/i,
+        /\A\s*see\s+(red\s+|green\s+|white\s+|yellow\s+|:\w+:\s+)?(announcements|statements|declarations|messages)\s+<#(\w+)\|.*>\s*\z/i
+
+        type = $1.to_s.downcase.strip
+        channel = $3.to_s
+
+        see_announcements(user, type, channel)
+
+
+        # help: ----------------------------------------------
+        # help: `share messages /REGEXP/ on #CHANNEL`
+        # help: `share messages "TEXT" on #CHANNEL`
+        # xhelp: `share messages :EMOJI: on #CHANNEL`
+        # help:     It will automatically share new messages published that meet the specified criteria.
+        # xhelp:     In case :EMOJI: it will share the messages with the indicated reaction.
+        # help:     SmartBot user and user adding the share need to be members on both channels.
+        # help:     The Regexp will automatically add the parameters /im
+        # help:     Only available on public channels.
+        # help:  Examples:
+        # help:     _share messages /(last\s+|previous\s+)sales\s+results\s+/ on #sales_
+        # help:     _share messages "share post" on #announcements_
+        # xhelp:     _share messages :tada: on #announcements_
+        # xhelp:     _share messages :moneybag: from #sales_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#share-messages|more info>
+        # help: command_id: :share_messages
+        # help: 
+      when /\A\s*share\s+messages\s+(\/.+\/|".+"|'.+')\s+on\s+<#\w+\|(.+)>\s*\z/i,
+        /\A\s*share\s+messages\s+(\/.+\/|".+"|'.+')\s+on\s+<#(\w+)\|>\s*\z/,
+        /\A\s*share\s+messages\s+(\/.+\/|".+"|'.+')\s+on\s+(.+)\s*\z/i
+        condition = $1
+        channel = $2
+        channel.gsub!('#','') # for the case the channel name is in plain text including #
+        channel = @channels_name[channel] if @channels_name.key?(channel)
+        channel_from = @channels_name[dest]
+        channel_to = channel
+        share_messages(user, channel_from, channel_to, condition)
+
+        # help: ----------------------------------------------
+        # help: `see shares`
+        # help:     It will display the active shares from this channel.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#share-messages|more info>
+        # help: command_id: :see_shares
+        # help: 
+      when /\A\s*see\s+shares\s*\z/i
+        see_shares()
+
+        # help: ----------------------------------------------
+        # help: `delete share ID`
+        # help:     It will delete the share id specified.
+        # help:  Examples:
+        # help:     _delete share 24_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#share-messages|more info>
+        # help: command_id: :delete_share
+        # help: 
+      when /\A\s*(delete|remove)\s+share\s+(\d+)\s*\z/i
+        share_id = $2
+        delete_share(user, share_id)
+
+        # help: ----------------------------------------------
+        # help: `see statuses`
+        # help: `see statuses #CHANNEL`
+        # help: `see status EMOJI`
+        # help: `see status EMOJI #CHANNEL`
+        # help: `see status EMOJI1 EMOJI99`
+        # help: `who is on vacation?`
+        # help: `who is on EMOJI`
+        # help: `who is on EMOJI #CHANNEL`
+        # help: `who is on EMOJI1 EMOJI99`
+        # help: `who is not on vacation?`
+        # help: `who is not on EMOJI`
+        # help: `who is available?`
+        # help:     It will display the current statuses of the members of the channel where you are calling the command or on the channel you supply.
+        # help:     In case of `who is available?` will show members of the channel that are on line and not on a meeting or vacation or sick.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#see-statuses|more info>
+        # help: command_id: :see_statuses
+        # help: 
+      when /\A\s*(see|get)\s+(statuses)()\s*\z/i,
+        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??()\s*\z/i,
+        /\A\s*(who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(vacation|holiday)\s*\??()\s*\z/i,
+        /\A\s*(who\s+is|who\s+are)\s+(available|active)\s*\??()\s*\z/i,
+        /\A\s*(see|get)\s+(statuses)\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(who\s+is|who\s+are)\s+(available|active)\s*\??\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(who\s+is|who\s+are)\s+(available|active)\s*\??\s+<#(\w+)\|.*>\s*\z/i,
+        /\A\s*(who\s+is\s+on|who\s+are\s+on|who\s+is\s+not\s+on|who\s+are\s+not\s+on)\s+(vacation|holiday)\s*\??\s+#([\w\-]+)\s*\z/i,
+        /\A\s*(see|get)\s+(statuses)\s+<#(\w+)\|.*>\s*\z/i,
+        /\A\s*(see\s+status|get\s+status|who\s+is\s+on|who\s+is\s+not\s+on|who\s+are\s+on|who\s+are\s+not\s+on)\s+(:[\w\-\:\s]+:)\s*\??\s+<#(\w+)\|.*>\s*\z/i,
+        /\A\s*(who\s+is\s+on|who\s+is\s+not\s+on|who\s+are\s+on|who\s+are\s+not\s+on)\s+(vacation|holiday)\s*\??\s+<#(\w+)\|.*>\s*\z/i
+
+        not_on = $1.match?(/who\s+(is|are)\s+not\s+on/i)
+        type = $2.downcase
+        channel = $3.to_s
+        if type == 'statuses'
+          types = []
+        elsif type =='vacation' or type == 'holiday'
+          types = [':palm_tree:']
+        elsif type == 'available' or type == 'active'
+          types = ['available']
+        else
+          type.gsub!(' ', '')
+          type.gsub!('::',': :')
+          types = type.split(' ')
+        end
+        see_statuses(user, channel, types, dest, not_on)
+
+
+        # help: ----------------------------------------------
+        # help: `see favorite commands`
+        # help: `see my favorite commands`
+        # help: `favorite commands`
+        # help: `my favorite commands`
+        # help:     It will display the favorite commands.
+        # help:     aliases for favorite: favourite, most used, fav
+        # helpmaster:    You need to set stats to true to generate the stats when running the bot instance and get this info.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#see-favorite-commands|more info>
+        # help: command_id: :see_favorite_commands
+        # help: 
+      when /\A\s*(see\s+)?(my\s+)?(fav|favorite|favourite|most\s+used)\s+commands\s*\z/i
+        only_mine = $2.to_s!=''
+        see_favorite_commands(user, only_mine)
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `add admin @user`
+        # helpadmin:     It will add @user as an admin of the channel.
+        # helpadmin:     Only creator of the channel, admins and master admins can use this command.
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # helpadmin: command_id: :add_admin
+        # helpadmin: 
+      when /\A\s*add\s+admin\s+<@(\w+)>\s*\z/i
+        admin_user = $1
+        add_admin(user, admin_user)
+
+        # help: ----------------------------------------------
+        # help: `see admins`
+        # help: `show admins`
+        # help: `who are admins?`
+        # help:     It will show who are the admins of the channel.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # help: command_id: :see_admins
+        # help: 
+      when /\A\s*(see|show)\s+admins\s*\z/i, /\A\s*who\s+are\s+(the\s+)?admins\??\s*\z/i
+        see_admins()
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `remove admin @user`
+        # helpadmin:     It will remove the admin privileges for @user on the channel.
+        # helpadmin:     Only creator of the channel, admins and master admins can use this command.
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # helpadmin: command_id: :remove_admin
+        # helpadmin: 
+      when /\A\s*(remove|delete)\s+admin\s+<@(\w+)>\s*\z/i
+        admin_user = $2
+        remove_admin(user, admin_user)
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `see command ids`
+        # helpadmin:     It will display all available command ids.
+        # helpadmin:     The command id can be used on `bot stats command COMMAND_ID`, `allow access COMMAND_ID` and `deny access COMMAND_ID`
+        # helpadmin:     Only creator of the channel, admins and master admins can use this command.
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#bot-management|more info>
+        # helpadmin: command_id: :see_command_ids
+        # helpadmin: 
+      when /\A\s*(see|display|get)\s+command(\s+|_)ids?\s*\z/i
+        see_command_ids()
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `allow access COMMAND_ID`
+        # helpadmin: `allow access COMMAND_ID @user1 @user99`
+        # helpadmin:     It will allow the specified command to be used on the channel.
+        # helpadmin:     If @user specified, only those users will have access to the command.
+        # helpadmin:     Only admins of the channel can use this command
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#control-who-has-access-to-a-command|more info>
+        # helpadmin: command_id: :allow_access
+        # helpadmin: 
+      when /\A\s*(allow|give)\s+access\s+(\w+)\s+(.+)\s*\z/i, /\A\s*(allow|give)\s+access\s+(\w+)()\s*\z/i
+        command_id = $2.downcase
+        opt = $3.to_s.split(' ')
+        allow_access(user, command_id, opt)
+
+        # helpadmin: ----------------------------------------------
+        # helpadmin: `deny access COMMAND_ID`
+        # helpadmin:     It won't allow the specified command to be used on the channel.
+        # helpadmin:     Only admins of the channel can use this command
+        # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#control-who-has-access-to-a-command|more info>
+        # helpadmin: command_id: :deny_access
+        # helpadmin: 
+      when /\A\s*deny\s+access(\s+rights)?\s+(\w+)\s*\z/i
+        command_id = $2.downcase
+        deny_access(user, command_id)
+
+
+        # help: ----------------------------------------------
+        # help: `see access COMMAND_ID`
+        # help:     It will show the access rights for the specified command.
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#control-who-has-access-to-a-command|more info>
+        # help: command_id: :see_access
+        # help: 
+      when /\A\s*(see|show)\s+access(\s+rights)?\s+(.+)\s*\z/i
+        command_id = $3.downcase
+        see_access(command_id)
+
+        # help: ----------------------------------------------
+        # help: `poster MESSAGE`
+        # help: `poster :EMOTICON_TEXT: MESSAGE`
+        # help: `poster :EMOTICON_TEXT: :EMOTICON_BACKGROUND: MESSAGE`
+        # help: `poster MINUTESm MESSAGE`
+        # help:     It will create a poster with the message supplied. By default will be autodeleted 1 minute later.
+        # help:     If you want the poster to be permanent then use the command `pposter`
+        # help:     If minutes supplied then it will be deleted after the minutes specified. Maximum value 60.
+        # help:     To see the messages on a mobile phone put the phone on landscape mode
+        # help:     Max 15 characters. If the message is longer than that won't be treat it.
+        # help:     Only letters from a to z, 0 to 9 and the chars: ? ! - + =
+        # help:     To be displayed correctly use words with no more than 6 characters
+        # help:     Examples:
+        # help:            _poster nice work!_
+        # help:            _poster :heart: nice work!_
+        # help:            _poster :mac-spinning-wheel: :look: love!_
+        # help:            _poster 25m :heart: woah!_
+        # help: command_id: :poster
+        # help: 
+      when /\A()poster\s+(\d+m\s+)?(:[^:]+:)\s+(:[^:]+:)(.+)\s*\z/i, /\A()poster\s+(\d+m\s+)?(:.+:)\s+()(.+)\s*\z/i, /\A()poster\s+(\d+m\s+)?()()(.+)\s*\z/i,
+        /\A(p)poster\s+()(:[^:]+:)\s+(:[^:]+:)(.+)\s*\z/i, /\A(p)poster\s+()(:.+:)\s+()(.+)\s*\z/i, /\A(p)poster\s+()()()(.+)\s*\z/i
+        permanent = $1.to_s != ''
+        minutes = $2.to_s
+        emoticon_text = $3
+        emoticon_bg = $4
+        text = $5
+        minutes = minutes.scan(/(\d+)/).join
+        
+        if minutes == ''
+          minutes = 1
+        elsif minutes.to_i > 60
+          minutes = 60
+        end
+        
+        save_stats :poster
+        if text.to_s.gsub(/\s+/, '').length > 15
+          respond "Too long. Max 15 chars", :on_thread
+        else
+          poster(permanent, emoticon_text, emoticon_bg, text, minutes)
+        end
+
+        # help: ----------------------------------------------
+        # help: `add team TEAM_NAME members #TEAM_CHANNEL CHANNEL_TYPE #CHANNEL1 #CHANNEL99 : INFO`
+        # help: `add team TEAM_NAME MEMBER_TYPE @USER1 @USER99 CHANNEL_TYPE #CHANNEL1 #CHANNEL99 : INFO`
+        # help: `add team TEAM_NAME MEMBER_TYPE1 @USER1 @USER99 MEMBER_TYPE99 @USER1 @USER99 CHANNEL_TYPE1 #CHANNEL1 #CHANNEL99 CHANNEL_TYPE99 #CHANNEL1 #CHANNEL99 : INFO`
+        # help:     It will add a team with the info supplied.
+        # help:     TEAM_NAME, TYPE: one word, a-z, A-Z, 0-9, - and _
+        # help:     In case it is supplied a channel with type 'members' the members of that channel would be considered members of the team. The SmartBot needs to be a member of the channel.
+        # help:  Examples:
+        # help:     _add team sales members #sales support #sales-support public #sales-ff : Contact us if you need anything related to Sales. You can also send us an email at sales@ffxaja.com_
+        # help:     _add team Sales manager @ann qa @peter @berglind dev @john @sam @marta members #sales support #sales-support public #sales-ff : Contact us if you need anything related to Sales. You can also send us an email at sales@ffxaja.com_
+        # help:     _add team devweb qa @jim dev @johnja @cooke @luisa members #devweb support #devweb-support : We take care of the website_
+        # help:     _add team sandex manager @sarah members #sandex : We take care of the sand_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :add_team
+        # help: 
+      when /\A\s*add\s+team\s+([\w\-]+)\s+([^:]+)\s*:\s+(.+)\s*\z/im, /\A\s*add\s+([\w\-]+)\s+team\s+([^:]+)\s*:\s+(.+)\s*\z/im
+        name = $1.downcase
+        options = $2
+        info = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/^[^:]+:\s*(.+)\s*$/im).join
+        add_team(user, name, options, info)
+
+        # help: ----------------------------------------------
+        # help: `see teams`
+        # help: `see team TEAM_NAME`
+        # help: `team TEAM_NAME`
+        # help: `TEAM_NAME team`
+        # help: `which team @USER`
+        # help: `which team #CHANNEL`
+        # help: `which team TEXT_TO_SEARCH_ON_INFO`
+        # help: `which team does @USER belongs to?`
+        # help:     It will display all teams or the team specified.
+        # help:     In case a specific team it will show also the availability of the members.
+        # help:  Examples:
+        # help:     _see teams_
+        # help:     _see team Sales_
+        # help:     _Dev team_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :see_teams
+        # help: 
+      when /\A\s*see\s+teams?\s*([\w\-]+)?\s*\z/i, /\A\s*team\s+([\w\-]+)\s*\z/i, /\A\s*([\w\-]+)\s+team\s*\z/i, /\A\s*see\s+all\s+teams\s*()\z/i
+        name = $1.to_s.downcase
+        see_teams(user, name)
+      when /\A\s*(which|search)\s+teams?\s+(is\s+)?(.+)\??\s*\z/i, /\A\s*which\s+team\s+does\s+()()(.+)\s+belongs\s+to\??\s*\z/i
+        search = $3.to_s.downcase
+        see_teams(user, '', search)
+
+        # help: ----------------------------------------------
+        # help: `update team TEAM_NAME NEW_TEAM_NAME`
+        # help: `update team TEAM_NAME : NEW_INFO`
+        # help: `update team TEAM_NAME add MEMBER_TYPE @USER`
+        # help: `update team TEAM_NAME add CHANNEL_TYPE #CHANNEL`
+        # help: `update team TEAM_NAME delete MEMBER_TYPE @USER`
+        # help: `update team TEAM_NAME delete CHANNEL_TYPE #CHANNEL`
+        # help: `update team TEAM_NAME delete @USER`
+        # help: `update team TEAM_NAME delete #CHANNEL`
+        # help:     It will update a team with the info supplied.
+        # help:     You have to be a member of the team, the creator or a Master admin to be able to update a team.
+        # help:  Examples:
+        # help:     _update team sales salesff_
+        # help:     _update team salesff : Support for customers_        
+        # help:     _update sales team delete @sarah @peter_
+        # help:     _update team sales delete public #sales_
+        # help:     _update team sales delete #sales_support_
+        # help:     _update sales team add public #salesff_
+        # help:     _update sales team add qa @john @ben @ana_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :update_team
+        # help: 
+      when /\A\s*update\s+team\s+([\w\-]+)\s+([\w\-]+)\s*\z/i, /\A\s*update\s+([\w\-]+)\s+team\s+([\w\-]+)\s*\z/i
+        name = $1.downcase
+        new_name = $2.downcase
+        update_team(user, name, new_name: new_name)
+      when /\A\s*update\s+team\s+([\w\-]+)\s*:\s+(.+)\s*\z/im, /\A\s*update\s+([\w\-]+)\s+team\s*:\s+(.+)\s*\z/im
+        name = $1.downcase
+        new_info = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/^[^:]+:\s*(.+)\s*$/im).join
+        update_team(user, name, new_info: new_info)
+      when /\A\s*update\s+team\s+([\w\-]+)\s+(delete|remove)\s+(.+)\s*\z/i, /\A\s*update\s+([\w\-]+)\s+team\s+(delete|remove)\s+(.+)\s*\z/i
+        name = $1.downcase
+        delete_opts = $3
+        update_team(user, name, delete_opts: delete_opts)
+      when /\A\s*update\s+team\s+([\w\-]+)\s+add\s+(.+)\s*\z/i, /\A\s*update\s+([\w\-]+)\s+team\s+add\s+(.+)\s*\z/i
+        name = $1.downcase
+        add_opts = $2
+        update_team(user, name, add_opts: add_opts)
+
+        # help: ----------------------------------------------
+        # help: `ping team TEAM_NAME MEMBER_TYPE MESSAGE`
+        # help: `contact team TEAM_NAME MEMBER_TYPE MESSAGE`
+        # help:     ping: It will send the MESSAGE naming all available members of the MEMBER_TYPE supplied.
+        # help:     contact: It will send the MESSAGE naming all members of the MEMBER_TYPE supplied.
+        # help:     In case MEMBER_TYPE is 'all' it will name 10 random members of the team
+        # help:  Examples:
+        # help:     _ping team sales development How is the status on the last feature_
+        # help:     _contact team sales qa Please finish testing of dev02 feature before noon_
+        # help:     _contact team qa all Check the test failures please_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :ping_team
+        # help: command_id: :contact_team
+        # help: 
+      when /\A\s*(contact|ping)\s+team\s+([\w\-]+)\s+([\w\-]+)\s+(.+)\s*\z/im, /\A\s*(contact|ping)\s+([\w\-]+)\s+team\s+([\w\-]+)\s+(.+)\s*\z/im
+        type = $1.downcase.to_sym
+        name = $2.downcase
+        member_type = $3.downcase
+        message = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/\A\s*[^\s]+\s*\w+\s+team\s+[\w\-]+\s+[\w\-]+\s+(.+)\s*\z/im).join
+        if message == ''
+          message = Thread.current[:command_orig].to_s.gsub("\u00A0", " ").scan(/\A\s*[^\s]+\s*\w+\s+[\w\-]+\s+team\s+[\w\-]+\s+(.+)\s*\z/im).join
+        end
+        ping_team(user, type, name, member_type, message)
+
+        # help: ----------------------------------------------
+        # help: `delete team TEAM_NAME`
+        # help:     It will delete the supplied team.
+        # help:     You have to be a member of the team, the creator or a Master admin to be able to delete a team.
+        # help:  Examples:
+        # help:     _delete team sales_
+        # help:    <https://github.com/MarioRuiz/slack-smart-bot#teams|more info>
+        # help: command_id: :delete_team
+        # help: 
+      when /\A\s*(delete|remove)\s+team\s+([\w\-]+)\s*\z/i, /\A\s*(delete|remove)\s+([\w\-]+)\s+team\s*\z/i
+        name = $2.downcase
+        delete_team(user, name)
+
+    else
+      return false
+    end
+    return true
+  rescue => exception
+    if defined?(@logger)
+      @logger.fatal exception
+      respond "Unexpected error!! Please contact an admin to solve it: <@#{config.admins.join(">, <@")}>"
+    else
+      puts exception
+    end
+    return false
+  end
+end

data/lib/slack/smart-bot/commands/on_bot/add_shortcut.rb

@@ -18,16 +18,14 @@ class SlackSmartBot
   # help:        _sc spanish account_
   # help:        _shortcut Spanish Account_
   # help:        _Spanish Account_
+  # help:    <https://github.com/MarioRuiz/slack-smart-bot#shortcuts|more info>
+  # help: command_id: :add_shortcut
   # help:
   def add_shortcut(dest, user, typem, for_all, shortcut_name, command, command_to_run, global)
     save_stats(__method__)
     unless typem == :on_extended
       from = user.name
-      if config[:allow_access].key?(__method__) and !config[:allow_access][__method__].include?(user.name) and !config[:allow_access][__method__].include?(user.id) and 
-        (!user.key?(:enterprise_user) or ( user.key?(:enterprise_user) and !config[:allow_access][__method__].include?(user[:enterprise_user].id)))
-        respond "You don't have access to use this command, please contact an Admin to be able to use it: <@#{config.admins.join(">, <@")}>"
-      else
-
+      if has_access?(__method__, user)
         if global 
           if !config.on_master_bot or typem != :on_master
             respond "It is only possible to add global shortcuts from Master channel"
@@ -66,7 +64,7 @@ class SlackSmartBot
               end
             }
           end
-          if !config.admins.include?(from) and @shortcuts[:all].include?(shortcut_name) and !@shortcuts[from].include?(shortcut_name)
+          if !is_admin?(from) and @shortcuts[:all].include?(shortcut_name) and !@shortcuts[from].include?(shortcut_name)
             respond "Only the creator of the shortcut can modify it", dest
           elsif found_other
             respond "You cannot create a shortcut for all with the same name than other user is using", dest

data/lib/slack/smart-bot/commands/on_bot/admin/add_routine.rb

@@ -3,7 +3,9 @@ class SlackSmartBot
   # helpadmin: `add routine NAME every NUMBER PERIOD COMMAND`
   # helpadmin: `add routine NAME every NUMBER PERIOD #CHANNEL COMMAND`
   # helpadmin: `add routine NAME every NUMBER PERIOD`
+  # helpadmin: `add bgroutine NAME every NUMBER PERIOD`
   # helpadmin: `add silent routine NAME every NUMBER PERIOD`
+  # helpadmin: `add silent bgroutine NAME every NUMBER PERIOD`
   # helpadmin: `create routine NAME every NUMBER PERIOD`
   # helpadmin: `add routine NAME at TIME COMMAND`
   # helpadmin: `add routine NAME at TIME #CHANNEL COMMAND`
@@ -14,26 +16,31 @@ class SlackSmartBot
   # helpadmin: `create routine NAME at TIME`
   # helpadmin:    It will execute the command/rule supplied. Only for Admin and Master Admins.
   # helpadmin:    If no COMMAND supplied, then it will be necessary to attach a file with the code to be run and add this command as message to the file. ONLY for MASTER ADMINS.
+  # helpadmin:    In case *bgroutine* then the results of the run won't be published. To see the results call: `see result routine NAME`
   # helpadmin:    In case *silent* provided then when executed will be only displayed if the routine returns a message
   # helpadmin:    NAME: one word to identify the routine
   # helpadmin:    NUMBER: Integer
   # helpadmin:    PERIOD: days, d, hours, h, minutes, mins, min, m, seconds, secs, sec, s
   # helpadmin:    TIME: time at format HH:MM:SS
-  # helpadmin:    DAYWEEK: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. And their plurals.
+  # helpadmin:    DAYWEEK: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. And their plurals. Also possible to be used 'weekdays' and 'weekends'
   # helpadmin:    #CHANNEL: the destination channel where the results will be published. If not supplied then the bot channel by default or a DM if the command is run from a DM.
   # helpadmin:    COMMAND: any valid smart bot command or rule
+  # helpadmin:    It is possible to add a script directly. Only master admins can do it.
   # helpadmin:    Examples:
-  # helpadmin:      _add routine example every 30s ruby puts 'a'_
-  # helpadmin:      _add routine example every 3 days ruby puts 'a'_
-  # helpadmin:      _add routine example at 17:05 ruby puts 'a'_
+  # helpadmin:      _add routine example every 30s !ruby puts 'a'_
+  # helpadmin:      _add bgroutine example every 3 days !ruby puts 'a'_
+  # helpadmin:      _add routine example at 17:05 !ruby puts 'a'_
   # helpadmin:      _create silent routine Example every 12 hours !Run customer tests_
-  # helpadmin:      _add routine example on Mondays at 05:00 !run customer tests_
+  # helpadmin:      _add bgroutine example on Mondays at 05:00 !run customer tests_
   # helpadmin:      _add routine example on Tuesdays at 09:00 #SREChannel !run db cleanup_
+  # helpadmin:      _add routine example on weekdays at 22:00 suggest command_
+  # helpadmin:    <https://github.com/MarioRuiz/slack-smart-bot#routines|more info>
+  # helpadmin: command_id: :add_routine
   # helpadmin:
-  def add_routine(dest, from, user, name, type, number_time, period, command_to_run, files, silent, channel)
+  def add_routine(dest, from, user, name, type, number_time, period, command_to_run, files, silent, channel, routine_type)
     save_stats(__method__)
     if files.nil? or files.size == 0 or (files.size > 0 and config.masters.include?(from))
-      if config.admins.include?(from)
+      if is_admin?
         if @routines.key?(@channel_id) && @routines[@channel_id].key?(name)
           respond "I'm sorry but there is already a routine with that name.\nCall `see routines` to see added routines", dest
         else
@@ -61,8 +68,9 @@ class SlackSmartBot
               every = "#{number_time} seconds"
               every_in_seconds = number_time.to_i
             else # time
-              if type != 'at'
+              if type != 'at' and type!='weekday' and type!='weekend'
                 dayweek = type.downcase
+
                 days = ['sunday','monday','tuesday','wednesday','thursday','friday','saturday']
                 incr = days.index(dayweek) - Time.now.wday
                 if incr < 0 
@@ -72,6 +80,14 @@ class SlackSmartBot
                 end
                 days = incr/(24*60*60)
                 every_in_seconds = 7 * 24 * 60 * 60 # one week
+              elsif type=='weekend'
+                dayweek = type.downcase
+                days = 0
+                every_in_seconds = 24 * 60 * 60 # one day
+              elsif type=='weekday'
+                dayweek = type.downcase
+                days = 0
+                every_in_seconds = 24 * 60 * 60 # one day
               else
                 days = 0
                 every_in_seconds = 24 * 60 * 60 # one day
@@ -95,20 +111,35 @@ class SlackSmartBot
               if files[0].filetype == "ruby" and files[0].name.scan(/[^\.]+(\.\w+$)/).join == ''
                 file_path += ".rb"
               end
-              http = NiceHttp.new(host: "https://files.slack.com", headers: { "Authorization" => "Bearer #{config[:token]}" }, log_headers: :partial)
-              http.get(files[0].url_private_download, save_data: file_path)
+              if files[0].key?(:content)
+                File.open(file_path, 'w') do |f| 
+                  f.write files[0].content
+                end
+              else
+                http = NiceHttp.new(host: "https://files.slack.com", headers: { "Authorization" => "Bearer #{config[:token]}" }, log_headers: :partial)
+                http.get(files[0].url_private_download, save_data: file_path)
+              end
               system("chmod +x #{file_path}")
             end
-            channel = dest if channel.to_s == ''
+            get_channels_name_and_id() unless @channels_name.keys.include?(channel) or @channels_id.keys.include?(channel)
+            channel_id = nil
+            if @channels_name.key?(channel) #it is an id
+              channel_id = channel
+              channel = @channels_name[channel_id]
+            elsif @channels_id.key?(channel) #it is a channel name
+              channel_id = @channels_id[channel]
+            end
+    
+            channel_id = dest if channel_id.to_s == ''
             @routines[@channel_id] = {} unless @routines.key?(@channel_id)
             @routines[@channel_id][name] = { channel_name: config.channel, creator: from, creator_id: user.id, status: :on,
                                              every: every, every_in_seconds: every_in_seconds, at: at, dayweek: dayweek, file_path: file_path, 
                                              command: command_to_run.to_s.strip, silent: silent,
-                                             next_run: next_run.to_s, dest: channel, last_run: "", last_elapsed: "", 
-                                             running: false }
+                                             next_run: next_run.to_s, dest: channel_id, last_run: "", last_elapsed: "", 
+                                             running: false, routine_type: routine_type}
             update_routines
             respond "Added routine *`#{name}`* to the channel", dest
-            create_routine_thread(name)
+            create_routine_thread(name, @routines[@channel_id][name])
           end
         end
       else