o aqe9@@sddlmZddlmZmZmZddlmZmZm Z ddl m Z m Z m Z mZmZmZmZmZmZddlmZmZGdddeZd S) )dumps)ListOptionalUnion) JsonObject JsonValidator extract_json) AbstractDialogSelectorDialogChannelSelectorDialogConversationSelectorDialogExternalSelectorDialogStaticSelectorDialogTextAreaDialogTextComponentDialogTextFieldDialogUserSelector)Option OptionGroupc@s4eZdZUiZeeed<eee e fed<eeed<e ed<eeed<dZ dZ dZdZd d Zd ed dfd dZdeeefd dfddZded dfddZded dfddZde d dfddZddddddddd eded!e d"eed#eed$eed%ed&ed'eed dfd(d)Zddddddddd eded!e d"eed#eed$eed%ed&ed'eed dfd*d+Zdddd,d eded-eeeeefd!e d$eed"eed dfd.d/Zddddd0d eded!e d$eed"eed1eed dfd2d3Zdddd,d eded!e d$eed"eed df d4d5Zdddd,d eded!e d$eed"eed df d6d7Zdddd,d eded!e d$eed"eed df d8d9Z e!d:d;d<Z"e!d=e d>d?d@Z#e!dAdBdCZ$e!dDedEdFdGZ%e!dHe d>dIdJZ&e!dKdLdMZ'e!dNed>dOdPZ(d efdQdRZ)dS)S DialogBuilder _callback_id _elements _submit_label_notify_on_cancel_state i cCs(d|_d|_g|_d|_d|_d|_dS)zw Create a DialogBuilder to more easily construct the JSON required to submit a dialog to Slack NF)_titlerrrrrselfr Z/var/www/html/humari/django-venv/lib/python3.10/site-packages/slack/web/classes/dialogs.py__init__!s  zDialogBuilder.__init__titlereturncC ||_|S)zo Specify a title for this dialog Args: title: must not exceed 24 characters r)rr#r r r!r#-szDialogBuilder.titlestatecCs"t|tr t||_|S||_|S)a Pass state into this dialog - dictionaries will be automatically formatted to JSON Args: state: Extra state information that you need to pass from this dialog back to your application on submission ) isinstancedictrr)rr'r r r!r'7s zDialogBuilder.state callback_idcCr%)z Specify a callback ID for this dialog, which your application will then receive upon dialog submission Args: callback_id: a string identifying this particular dialog r)rr*r r r!r*FszDialogBuilder.callback_idlabelcCr%)z The label to use on the 'Submit' button on the dialog. Defaults to 'Submit' if not specified. Args: label: must not exceed 24 characters, and must be a single word (no spaces) r)rr,r r r! submit_labelQ zDialogBuilder.submit_labelnotifycCr%)aF Whether this dialog should send a request to your application even if the user cancels their interaction. Defaults to False. Args: notify: Set to True to indicate that your application should receive a request even if the user cancels interaction with the dialog. )r)rr0r r r!notify_on_cancel]r/zDialogBuilder.notify_on_cancelFNr)optional placeholderhintvalue min_length max_lengthsubtypenamer3r4r5r6r7r8r9c C&|jt||||||||| d |S)a Text elements are single-line plain text fields. https://api.slack.com/dialogs#attributes_text_elements Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. 48 character maximum. optional: Provide true when the form element is not required. By default, form elements are required. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. hint: Helpful text provided to assist users in answering a question. Up to 150 characters. value: A default value for this field. Up to 150 characters. min_length: Minimum input length allowed for element. Up to 150 characters. Defaults to 0. max_length: Maximum input length allowed for element. Up to 150 characters. Defaults to 150. subtype: A subtype for this text input. Accepts email, number, tel, or url. In some form factors, optimized input is provided for this subtype. r:r,r3r4r5r6r7r8r9)rappendr rr:r,r3r4r5r6r7r8r9r r r! text_fieldis$ zDialogBuilder.text_fieldc Cr;)a A textarea is a multi-line plain text editing control. You've likely encountered these on the world wide web. Use this element if you want a relatively long answer from users. The element UI provides a remaining character count to the max_length you have set or the default, 3000. https://api.slack.com/dialogs#attributes_textarea_elements Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. 48 character maximum. optional: Provide true when the form element is not required. By default, form elements are required. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. hint: Helpful text provided to assist users in answering a question. Up to 150 characters. value: A default value for this field. Up to 3000 characters. min_length: Minimum input length allowed for element. 1-3000 characters. Defaults to 0. max_length: Maximum input length allowed for element. 0-3000 characters. Defaults to 3000. subtype: A subtype for this text input. Accepts email, number, tel, or url. In some form factors, optimized input is provided for this subtype. r<)rr=rr>r r r! text_areas( zDialogBuilder.text_area)r3r6r4optionsc C |jt||||||d|S)a Use the select element for multiple choice selections allowing users to pick a single item from a list. True to web roots, this selection is displayed as a dropdown menu. A select element may contain up to 100 selections, provided as a list of Option or OptionGroup objects https://api.slack.com/dialogs#attributes_select_elements Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. No more than 48 characters. options: A list of up to 100 Option or OptionGroup objects. Object types cannot be mixed. optional: Provide true when the form element is not required. By default, form elements are required. value: Provide a default selected value. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. )r:r,rAr3r6r4)rr=r)rr:r,rAr3r6r4r r r!static_selectors zDialogBuilder.static_selector)r3r6r4min_query_lengthrDc CrB)a Use the select element for multiple choice selections allowing users to pick a single item from a list. True to web roots, this selection is displayed as a dropdown menu. A list of options can be loaded from an external URL and used in your dialog menus. https://api.slack.com/dialogs#dynamic_select_elements_external Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. No more than 48 characters. min_query_length: Specify the number of characters that must be typed by a user into a dynamic select menu before dispatching to your application. optional: Provide true when the form element is not required. By default, form elements are required. value: Provide a default selected value. This should be a single Option or OptionGroup that exactly matches one that will be returned from your external endpoint. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. )r:r,r3r6r4rD)rr=r )rr:r,r3r6r4rDr r r!external_selectors" zDialogBuilder.external_selectorc C|jt|||||d|S)aq Now you can easily populate a select menu with a list of users. For example, when you are creating a bug tracking app, you want to include a field for an assignee. Slack pre-populates the user list in client-side, so your app doesn't need access to a related OAuth scope. https://api.slack.com/dialogs#dynamic_select_elements_users Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. No more than 48 characters. optional: Provide true when the form element is not required. By default, form elements are required. value: Provide a default selected value. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. r:r,r3r6r4)rr=rrr:r,r3r6r4r r r! user_selector,s zDialogBuilder.user_selectorc CrF)a You can also provide a select menu with a list of channels. Specify your data_source as channels to limit only to public channels https://api.slack.com/dialogs#dynamic_select_elements_channels_conversations Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. No more than 48 characters. optional: Provide true when the form element is not required. By default, form elements are required. value: Provide a default selected value. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. rG)rr=r rHr r r!channel_selectorQs zDialogBuilder.channel_selectorc CrF)a You can also provide a select menu with a list of conversations - including private channels, direct messages, MPIMs, and whatever else we consider a conversation-like thing. https://api.slack.com/dialogs#dynamic_select_elements_channels_conversations Args: name: Name of form element. Required. No more than 300 characters. label: Label displayed to user. Required. No more than 48 characters. optional: Provide true when the form element is not required. By default, form elements are required. value: Provide a default selected value. placeholder: A string displayed as needed to help guide users in completing the element. 150 character maximum. rG)rr=r rHr r r!conversation_selectorts z#DialogBuilder.conversation_selectorztitle attribute is requiredcC |jduSNr&rr r r! title_present zDialogBuilder.title_presentztitle attribute cannot exceed z characterscCs|jduo t|j|jkSrM)rlentitle_max_lengthrr r r! title_lengthszDialogBuilder.title_lengthz!callback_id attribute is requiredcCrLrMr+rr r r!callback_id_presentrOz!DialogBuilder.callback_id_presentz#dialogs must contain between 1 and z elementscCs dt|jko |jkSS)Nr)rPrelements_max_lengthrr r r!elements_lengths zDialogBuilder.elements_lengthzsubmit_label cannot exceed cCs|jdup t|j|jkSrM)rrPsubmit_label_max_lengthrr r r!submit_label_lengths z!DialogBuilder.submit_label_lengthz!submit_label can only be one wordcCs|jdup d|jvS)N r-rr r r!submit_label_validsz DialogBuilder.submit_label_validzstate cannot exceed cCs|j p t|j|jkSrM)rrPstate_max_lengthrr r r! state_lengthszDialogBuilder.state_lengthcCsN||j|jt|j|jd}|jdur|j|d<|jdur%|j|d<|S)N)r#r*elementsr1r.r') validate_jsonrrr rrrr)rjsonr r r!to_dicts    zDialogBuilder.to_dict)*__name__ __module__ __qualname__ attributesrstr__annotations__rrrr boolrQrVrTrZr"r#r)r'r*r.r1intr?r@rrrCrErIrJrKrrNrRrSrUrWrYr[r_r r r r!rsZ            8    = 0 3 * ( $       rN)r^rtypingrrrrrr dialog_elementsr r r r rrrrrobjectsrrrr r r r!s ,