slack-ruby-client 0.7.9 → 0.16.0

data/bin/commands/stars.rb

@@ -1,33 +1,36 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Stars methods.'
 command 'stars' do |g|
-  g.desc 'This method adds a star to an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user.'
-  g.long_desc %( This method adds a star to an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user. One of file, file_comment, channel, or the combination of channel and timestamp must be specified. )
+  g.desc 'Adds a star to an item.'
+  g.long_desc %( Adds a star to an item. )
   g.command 'add' do |c|
+    c.flag 'channel', desc: 'Channel to add star to, or channel where the message to add star to was posted (used with timestamp).'
     c.flag 'file', desc: 'File to add star to.'
     c.flag 'file_comment', desc: 'File comment to add star to.'
-    c.flag 'channel', desc: 'Channel to add star to, or channel where the message to add star to was posted (used with timestamp).'
     c.flag 'timestamp', desc: 'Timestamp of the message to add star to.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.stars_add(options))
     end
   end
 
-  g.desc 'This method lists the items starred by the authed user.'
-  g.long_desc %( This method lists the items starred by the authed user. )
+  g.desc 'Lists stars for a user.'
+  g.long_desc %( Lists stars for a user. )
   g.command 'list' do |c|
+    c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
+    c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.stars_list(options))
     end
   end
 
-  g.desc 'This method removes a star from an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user.'
-  g.long_desc %( This method removes a star from an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user. One of file, file_comment, channel, or the combination of channel and timestamp must be specified. )
+  g.desc 'Removes a star from an item.'
+  g.long_desc %( Removes a star from an item. )
   g.command 'remove' do |c|
+    c.flag 'channel', desc: 'Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).'
     c.flag 'file', desc: 'File to remove star from.'
     c.flag 'file_comment', desc: 'File comment to remove star from.'
-    c.flag 'channel', desc: 'Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).'
     c.flag 'timestamp', desc: 'Timestamp of the message to remove star from.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.stars_remove(options))

data/bin/commands/team.rb

@@ -1,40 +1,45 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Team methods.'
 command 'team' do |g|
-  g.desc 'This method is used to get the access logs for users on a team.'
-  g.long_desc %( This method is used to get the access logs for users on a team. )
+  g.desc 'Gets the access logs for the current team.'
+  g.long_desc %( Gets the access logs for the current team. )
   g.command 'accessLogs' do |c|
     c.flag 'before', desc: 'End of time range of logs to include in results (inclusive).'
+    c.flag 'team_id', desc: 'encoded team id to get logs from, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_accessLogs(options))
     end
   end
 
-  g.desc 'This method lists billable information for each user on the team. Currently this consists solely of whether the user is'
-  g.long_desc %( This method lists billable information for each user on the team. Currently this consists solely of whether the user is subject to billing per Slack's Fair Billing policy. )
+  g.desc 'Gets billable users information for the current team.'
+  g.long_desc %( Gets billable users information for the current team. )
   g.command 'billableInfo' do |c|
+    c.flag 'team_id', desc: 'encoded team id to get the billable information from, required if org token is used.'
     c.flag 'user', desc: 'A user to retrieve the billable information for. Defaults to all users.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_billableInfo(options))
     end
   end
 
-  g.desc 'This method provides information about your team.'
-  g.long_desc %( This method provides information about your team. )
+  g.desc 'Gets information about the current team.'
+  g.long_desc %( Gets information about the current team. )
   g.command 'info' do |c|
+    c.flag 'team', desc: 'Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_info(options))
     end
   end
 
-  g.desc 'This method lists the integration activity logs for a team, including when integrations are added, modified and removed. This method can only be called by Admins.'
-  g.long_desc %( This method lists the integration activity logs for a team, including when integrations are added, modified and removed. This method can only be called by Admins. )
+  g.desc 'Gets the integration logs for the current team.'
+  g.long_desc %( Gets the integration logs for the current team. )
   g.command 'integrationLogs' do |c|
-    c.flag 'service_id', desc: 'Filter logs to this service. Defaults to all logs.'
     c.flag 'app_id', desc: 'Filter logs to this Slack app. Defaults to all logs.'
-    c.flag 'user', desc: "Filter logs generated by this user's actions. Defaults to all logs."
     c.flag 'change_type', desc: 'Filter logs with this change type. Defaults to all logs.'
+    c.flag 'service_id', desc: 'Filter logs to this service. Defaults to all logs.'
+    c.flag 'team_id', desc: 'encoded team id to get logs from, required if org token is used.'
+    c.flag 'user', desc: "Filter logs generated by this user's actions. Defaults to all logs."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_integrationLogs(options))
     end

data/bin/commands/team_profile.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'TeamProfile methods.'
 command 'team_profile' do |g|
-  g.desc 'This method is used to get the profile field definitions for this team.'
-  g.long_desc %( This method is used to get the profile field definitions for this team. )
+  g.desc "Retrieve a team's profile."
+  g.long_desc %( Retrieve a team's profile. )
   g.command 'get' do |c|
     c.flag 'visibility', desc: 'Filter by visibility.'
     c.action do |_global_options, options, _args|

data/bin/commands/usergroups.rb

@@ -1,60 +1,66 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc "Get info on your team's User Groups."
 command 'usergroups' do |g|
-  g.desc 'This method is used to create a User Group.'
-  g.long_desc %( This method is used to create a User Group. )
+  g.desc 'Create a User Group'
+  g.long_desc %( Create a User Group )
   g.command 'create' do |c|
     c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'
-    c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
-    c.flag 'description', desc: 'A short description of the User Group.'
     c.flag 'channels', desc: 'A comma separated string of encoded channel IDs for which the User Group uses as a default.'
+    c.flag 'description', desc: 'A short description of the User Group.'
+    c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
     c.flag 'include_count', desc: 'Include the number of users in each User Group.'
+    c.flag 'team_id', desc: 'Encoded team id where the user group has to be created, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_create(options))
     end
   end
 
-  g.desc 'This method disables an existing User Group.'
-  g.long_desc %( This method disables an existing User Group. )
+  g.desc 'Disable an existing User Group'
+  g.long_desc %( Disable an existing User Group )
   g.command 'disable' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to disable.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'team_id', desc: 'Encoded team id where the user group is, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_disable(options))
     end
   end
 
-  g.desc 'This method enables a User Group which was previously disabled.'
-  g.long_desc %( This method enables a User Group which was previously disabled. )
+  g.desc 'Enable a User Group'
+  g.long_desc %( Enable a User Group )
   g.command 'enable' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to enable.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'team_id', desc: 'Encoded team id where the user group is, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_enable(options))
     end
   end
 
-  g.desc 'This method returns a list of all User Groups in the team. This can optionally include disabled User Groups.'
-  g.long_desc %( This method returns a list of all User Groups in the team. This can optionally include disabled User Groups. )
+  g.desc 'List all User Groups for a team'
+  g.long_desc %( List all User Groups for a team )
   g.command 'list' do |c|
-    c.flag 'include_disabled', desc: 'Include disabled User Groups.'
     c.flag 'include_count', desc: 'Include the number of users in each User Group.'
+    c.flag 'include_disabled', desc: 'Include disabled User Groups.'
     c.flag 'include_users', desc: 'Include the list of users for each User Group.'
+    c.flag 'team_id', desc: 'encoded team id to list user groups in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_list(options))
     end
   end
 
-  g.desc 'This method updates the properties of an existing User Group.'
-  g.long_desc %( This method updates the properties of an existing User Group. )
+  g.desc 'Update an existing User Group'
+  g.long_desc %( Update an existing User Group )
   g.command 'update' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
-    c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'
-    c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
-    c.flag 'description', desc: 'A short description of the User Group.'
     c.flag 'channels', desc: 'A comma separated string of encoded channel IDs for which the User Group uses as a default.'
+    c.flag 'description', desc: 'A short description of the User Group.'
+    c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'
+    c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_update(options))
     end

data/bin/commands/usergroups_users.rb

@@ -1,23 +1,26 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'UsergroupsUsers methods.'
 command 'usergroups_users' do |g|
-  g.desc 'This method returns a list of all users within a User Group.'
-  g.long_desc %( This method returns a list of all users within a User Group. )
+  g.desc 'List all users in a User Group'
+  g.long_desc %( List all users in a User Group )
   g.command 'list' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
     c.flag 'include_disabled', desc: 'Allow results that involve disabled User Groups.'
+    c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_users_list(options))
     end
   end
 
-  g.desc 'This method updates the list of users that belong to a User Group. This method replaces all users in a User Group with the list of users provided in the users parameter.'
-  g.long_desc %( This method updates the list of users that belong to a User Group. This method replaces all users in a User Group with the list of users provided in the users parameter. )
+  g.desc 'Update the list of users for a User Group'
+  g.long_desc %( Update the list of users for a User Group )
   g.command 'update' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
     c.flag 'users', desc: 'A comma separated string of encoded user IDs that represent the entire list of users for the User Group.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_users_update(options))
     end

data/bin/commands/users.rb

@@ -1,17 +1,32 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Get info on members of your Slack team.'
 command 'users' do |g|
-  g.desc 'This method allows the user to delete their profile image. It will clear whatever image is currently set.'
-  g.long_desc %( This method allows the user to delete their profile image. It will clear whatever image is currently set. )
+  g.desc 'List conversations the calling user may access.'
+  g.long_desc %( List conversations the calling user may access. )
+  g.command 'conversations' do |c|
+    c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
+    c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
+    c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer no larger than 1000."
+    c.flag 'team_id', desc: 'encoded team id to list conversations in, required if org token is used.'
+    c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
+    c.flag 'user', desc: "Browse conversations by a specific user ID's membership. Non-public channels are restricted to those where the calling user shares membership."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_conversations(options))
+    end
+  end
+
+  g.desc 'Delete the user profile photo'
+  g.long_desc %( Delete the user profile photo )
   g.command 'deletePhoto' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_deletePhoto(options))
     end
   end
 
-  g.desc "This method lets you find out information about a user's presence."
-  g.long_desc %( This method lets you find out information about a user's presence. Consult the presence documentation for more details. )
+  g.desc 'Gets user presence information.'
+  g.long_desc %( Gets user presence information. )
   g.command 'getPresence' do |c|
     c.flag 'user', desc: 'User to get presence info on. Defaults to the authed user.'
     c.action do |_global_options, options, _args|
@@ -19,76 +34,89 @@ command 'users' do |g|
     end
   end
 
-  g.desc "After your Slack app is awarded an identity token through Sign in with Slack, use this method to retrieve a user's identity."
-  g.long_desc %( After your Slack app is awarded an identity token through Sign in with Slack, use this method to retrieve a user's identity. )
+  g.desc 'This method returns the ID of a team user.'
+  g.long_desc %( This method returns the ID of a team user. )
+  g.command 'id' do |c|
+    c.flag 'user', desc: 'User to get ID for, prefixed with @.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_id(options))
+    end
+  end
+
+  g.desc "Get a user's identity."
+  g.long_desc %( Get a user's identity. )
   g.command 'identity' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_identity(options))
     end
   end
 
-  g.desc 'This method returns information about a team member.'
-  g.long_desc %( This method returns information about a team member. )
+  g.desc 'Gets information about a user.'
+  g.long_desc %( Gets information about a user. )
   g.command 'info' do |c|
     c.flag 'user', desc: 'User to get info on.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this user. Defaults to false.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_info(options))
     end
   end
 
-  g.desc 'This method returns a list of all users in the team. This includes deleted/deactivated users.'
-  g.long_desc %( This method returns a list of all users in the team. This includes deleted/deactivated users. )
+  g.desc 'Lists all users in a Slack team.'
+  g.long_desc %( Lists all users in a Slack team. )
   g.command 'list' do |c|
-    c.flag 'presence', desc: 'Whether to include presence data in the output.'
+    c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for users. Defaults to false.'
+    c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached. Providing no limit value will result in Slack attempting to deliver you the entire result set. If the collection is too large you may experience limit_required or HTTP 500 errors."
+    c.flag 'team_id', desc: 'encoded team id to list users in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_list(options))
     end
   end
 
-  g.desc 'This method lets the slack messaging server know that the authenticated user'
-  g.long_desc %( This method lets the slack messaging server know that the authenticated user is currently active. Consult the presence documentation for more details. )
+  g.desc 'Find a user with an email address.'
+  g.long_desc %( Find a user with an email address. )
+  g.command 'lookupByEmail' do |c|
+    c.flag 'email', desc: 'An email address belonging to a user in the workspace.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_lookupByEmail(options))
+    end
+  end
+
+  g.desc 'This method searches for users.'
+  g.long_desc %( This method searches for users. )
+  g.command 'search' do |c|
+    c.flag 'user', desc: 'User to search for.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_search(options))
+    end
+  end
+
+  g.desc 'Marked a user as active. Deprecated and non-functional.'
+  g.long_desc %( Marked a user as active. Deprecated and non-functional. )
   g.command 'setActive' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_setActive(options))
     end
   end
 
-  g.desc 'This method allows the user to set their profile image. The caller can pass image data via image.'
-  g.long_desc %( This method allows the user to set their profile image. The caller can pass image data via image. )
+  g.desc 'Set the user profile photo'
+  g.long_desc %( Set the user profile photo )
   g.command 'setPhoto' do |c|
-    c.flag 'image', desc: 'File contents via multipart/form-data.'
+    c.flag 'crop_w', desc: 'Width/height of crop box (always square).'
     c.flag 'crop_x', desc: 'X coordinate of top-left corner of crop box.'
     c.flag 'crop_y', desc: 'Y coordinate of top-left corner of crop box.'
-    c.flag 'crop_w', desc: 'Width/height of crop box (always square).'
+    c.flag 'image', desc: 'File contents via multipart/form-data.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_setPhoto(options))
     end
   end
 
-  g.desc "This method lets you set the calling user's manual presence."
-  g.long_desc %( This method lets you set the calling user's manual presence. Consult the presence documentation for more details. )
+  g.desc 'Manually sets user presence.'
+  g.long_desc %( Manually sets user presence. )
   g.command 'setPresence' do |c|
     c.flag 'presence', desc: 'Either auto or away.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_setPresence(options))
     end
   end
-
-  g.desc 'This method returns the ID of a team user.'
-  g.long_desc %( This method returns the ID of a team user. )
-  g.command 'id' do |c|
-    c.flag 'user', desc: 'User to get ID for, prefixed with @.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.users_id(options))
-    end
-  end
-
-  g.desc 'This method searches for users.'
-  g.long_desc %( This method searches for users. )
-  g.command 'search' do |c|
-    c.flag 'user', desc: 'User to search for.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.users_search(options))
-    end
-  end
 end

data/bin/commands/users_admin.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'UsersAdmin methods.'
+command 'users_admin' do |g|
+  g.desc 'Send an invitation to a new user by email (undocumented)'
+  g.long_desc %( Send an invitation to a new user by email )
+  g.command 'invite' do |c|
+    c.flag 'email', desc: 'Email address of the new user'
+    c.flag 'channels', desc: 'Comma-separated list of IDs (not names!) for channels, which the new user will auto-join. Both channel IDs for public channels and group IDs for private chanels work.'
+    c.flag 'first_name', desc: 'Prefilled input for the "First name" field on the "new user registration" page.'
+    c.flag 'last_name', desc: 'Prefilled input for the "Last name" field on the "new user registration" page.'
+    c.flag 'resend', desc: 'Resend the invitation email if the user has already been invited and the email was sent some time ago.'
+    c.flag 'restricted', desc: 'Invite a guest that can use multiple channels'
+    c.flag 'ultra_restricted', desc: 'Invite a guest that can use one channel only'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_admin_invite(options))
+    end
+  end
+
+  g.desc 'Disable a user (undocumented)'
+  g.long_desc %( Disable a user )
+  g.command 'setInactive' do |c|
+    c.flag 'user', desc: 'User to disable'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_admin_setInactive(options))
+    end
+  end
+end

data/bin/commands/users_prefs.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'UsersPrefs methods.'
+command 'users_prefs' do |g|
+  g.desc "Returns the user's preferences (undocumented)"
+  g.long_desc %( Returns the user's preferences )
+  g.command 'get' do |c|
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.users_prefs_get(options))
+    end
+  end
+end

data/bin/commands/users_profile.rb

@@ -1,23 +1,24 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'UsersProfile methods.'
 command 'users_profile' do |g|
-  g.desc 'This method is used to get the profile information for a user.'
-  g.long_desc %( This method is used to get the profile information for a user. )
+  g.desc "Retrieve a user's profile information, including their custom status."
+  g.long_desc %( Retrieve a user's profile information, including their custom status. )
   g.command 'get' do |c|
+    c.flag 'include_labels', desc: 'Include labels for each ID in custom profile fields. Using this parameter will heavily rate-limit your requests and is not recommended.'
     c.flag 'user', desc: 'User to retrieve profile info for.'
-    c.flag 'include_labels', desc: 'Include labels for each ID in custom profile fields.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_profile_get(options))
     end
   end
 
-  g.desc 'This method is used to set the profile information for a user.'
-  g.long_desc %( This method is used to set the profile information for a user. )
+  g.desc "Set a user's profile information, including custom status."
+  g.long_desc %( Set a user's profile information, including custom status. )
   g.command 'set' do |c|
-    c.flag 'user', desc: 'ID of user to change. This argument may only be specified by team admins on paid teams.'
-    c.flag 'profile', desc: 'Collection of key:value pairs presented as a URL-encoded JSON hash.'
     c.flag 'name', desc: 'Name of a single key to set. Usable only if profile is not passed.'
+    c.flag 'profile', desc: 'Collection of key:value pairs presented as a URL-encoded JSON hash. At most 50 fields may be set. Each field name is limited to 255 characters.'
+    c.flag 'user', desc: 'ID of user to change. This argument may only be specified by team admins on paid teams.'
     c.flag 'value', desc: 'Value to set a single key to. Usable only if profile is not passed.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_profile_set(options))