a Sic@sdZddlZddlZddlmZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZmZddlZddlmZdd lmZdd lmZdd lmZmZmZmZdd lmZGd ddZ e e!dddZ"Gddde Z#Gddde Z$Gddde Z%eGdddZ&eGdddZ'GdddZ(eGdddZ)eGd d!d!Z*eGd"d#d#Z+eGd$d%d%Z,e e-d&d'd(Z.e e-d&d)d*Z/e-e-d+d,d-Z0e-e-d.d/d0Z1eGd1d2d2Z2ee e-e e-d3d4d5Z3dS)6zcUtility classes and functions for configuring and setting up the content and the look of a QR code.N) namedtuple)asdict)date)Enum)OptionalAnyUnionSequenceListTupleescape)validate_arguments) dataclass)DEFAULT_MODULE_SIZE SIZE_DICTDEFAULT_ERROR_CORRECTIONDEFAULT_IMAGE_FORMAT)helpersc @seZdZdZeedddedddddd dddddddddddddddfeee dfeeee dfe e e e e e e ee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfee e e dfdd d d Z d dZddZddZddZeddZeddZeddZeddZeddZedd Zed!d"Zed#d$Zed%d&ZdS)' QRCodeOptionszC Represents the options used to create and draw a QR code. Nsvgutf-8TF#000#fff)sizeborderversion image_formaterror_correctionencoding boost_errormicroeci dark_color light_colorfinder_dark_colorfinder_light_colordata_dark_colordata_light_colorversion_dark_colorversion_light_colorformat_dark_colorformat_light_coloralignment_dark_coloralignment_light_colortiming_dark_colortiming_light_colorseparator_colordark_module_colorquiet_zone_colorreturncCs ||_t||_t|rz)QRCodeOptions.kw_save..rmmunitr] ) rRrSr _size_as_intupdate color_mappingitemsdecimalDecimal)rUrkwr]rWrWrXkw_saveszQRCodeOptions.kw_savecCs@dd|jD}|ddvr(|d=|ddvr<|d=|S)z~Internal method which returns the color mapping. Only non-default values are returned. :rtype: dict cSsi|]\}}|dur||qS)FrWr^rWrWrXrbrcz/QRCodeOptions.color_mapping..r$)rz#000000blackr%)rz#FFFz#ffffffz#FFFFFFwhite)rTrjget)rUcolorsrWrWrXris zQRCodeOptions.color_mappingcCsP|j}t|r(t|}|dkrLtt}n$t|trDt|t}ntt}|S)z@Returns the size as integer value. :rtype: int r6) rFrIrGrr isinstancestrrqrJ)rUr actual_sizerWrWrXrgs  zQRCodeOptions._size_as_intcCs|jSN)rFrZrWrWrXrszQRCodeOptions.sizecCs|jSrv)rHrZrWrWrXr szQRCodeOptions.bordercCs|jSrv)rKrZrWrWrXrszQRCodeOptions.versioncCs|jSrv)rRrZrWrWrXrszQRCodeOptions.image_formatcCs|jSrv)rNrZrWrWrXrszQRCodeOptions.error_correctioncCs|jSrv)rPrZrWrWrXr!szQRCodeOptions.boost_errorcCs|jSrv)rLrZrWrWrXr"szQRCodeOptions.microcCs|jSrv)rQrZrWrWrXr #szQRCodeOptions.encodingcCs|jSrv)rMrZrWrWrXr#'szQRCodeOptions.eci)__name__ __module__ __qualname____doc__rrrrrGrtrbooltuplerYr[rnrirgpropertyrrrrrr!r"r r#rWrWrWrXrs  2        r)valuer5cCst|tpt|to|Srv)rsrGrtisdigit)r~rWrWrXrI,srIc@seZdZdZdZdZdS) EventClassr6N)rwrxryPUBLICPRIVATEZ CONFIDENTIALrWrWrWrXr0src@seZdZdZdZdZdS) EventStatusr6rrN)rwrxryZ TENTATIVEZ CONFIRMED CANCELLEDrWrWrWrXr6src@seZdZdZdZdS)EventTransparencyr6rN)rwrxryOPAQUEZ TRANSPARENTrWrWrWrXr<src@seZdZUdZeed<eed<ejed<ejed<dZeejed<dZ eeed<dZ eeed <dZ ee ed <dZ eeed <dZeeeefed <dZeeed <dZeeeed<dZeeed<dZeeed<edddZdS)VEventa Data for representing VEVENT for iCalendar (.ics) event. Only a subset of https://icalendar.org/iCalendar-RFC-5545/3-6-1-event-component.html is supported. Fields meaning: * uid: Event identifier * summary: This property defines a short summary or subject for the calendar event. * start: Start of event * end: End of event * dtstamp: The property indicates the date/time that the instance of the iCalendar object was created. Defaults to current time in UTC. * description: This property provides a more complete description of the calendar component, than that provided by the "SUMMARY" property. * organizer: E-mail of organizer * status: Status of event * location: Location of event * geo: This property specifies information related to the global position of event. The property value specifies latitude and longitude, in that order. Whole degrees of latitude shall be represented by a two-digit decimal number ranging from -90 through 90. The longitude represents the location east or west of the prime meridian as a positive or negative real number, respectively (a decimal number ranging from -180 through 180). * event_class: Either PUBLIC, PRIVATE or CONFIDENTIAL (see `utils.EventClass`). * categories: This property defines the categories for calendar event. * transparency: Tell whether the event can have its Time Transparency set to "TRANSPARENT" in order to prevent blocking of the event in searches for busy time. * url: This property defines a Uniform Resource Locator (URL) associated with the iCalendar object. uidsummarystartendNdtstamp description organizerstatuslocationgeo event_class categories transparencyurlr5c sd!dd}dd}tddd tdfd d }d |jpBtjtjd d|j d||j d||j d||j  }|j r|d|j j7}|jr|d|ddt||j7}|jr|d|jj7}|jr|d|d||j7}|jr|d|j7}|jr2|d|jj7}|jrV|d|d||j7}|jr~|d|jdd|jd7}|jr|d|j7}|d 7}|S)"z Creates a string encoding the event information. Only a subset of https://icalendar.org/iCalendar-RFC-5545/3-6-1-event-component.html is supported. K c sd}|dD]zdWnlttfyg}d}D]:}t|d}||7}|krn|||}||q>|d|7}Yq0||fddtdtdD7}q|S) aMake a string folded as defined in RFC5545 Lines of text SHOULD NOT be longer than 75 octets, excluding the line break. Long content lines SHOULD be split into a multiple line representations using a line "folding" technique. That is, a long line can be split between any two characters by inserting a CRLF immediately followed by a single linear white-space character (i.e., SPACE or HTAB). rD asciirrc3s"|]}||dVqdS)r6NrW)r_ilimitlinerWrX rczHVEvent.make_qr_code_data..fold_icalendar_line..r6)splitencodeUnicodeEncodeErrorUnicodeDecodeErrorlenappendjoinrange)textrZfold_sepZnew_textZ ret_charsZ byte_countcharZ char_byte_lenrWrrXfold_icalendar_lineps"   0z5VEvent.make_qr_code_data..fold_icalendar_linecSs4|ddddddddd d dd S) z8Format value according to iCalendar TEXT escaping rules.z\Nr\z\\;z\;,z\,z z\nreplace)rrWrWrX escape_chars z-VEvent.make_qr_code_data..escape_charrcSs|jdup|j|duSrv)tzinfo utcoffset)trWrWrXis_naive_datetimesz3VEvent.make_qr_code_data..is_naive_datetimecs,|r|dS|tj}|dSdS)Nz %Y%m%dT%H%M%S%Y%m%dT%H%M%SZ)strftime astimezonepytzutc)rZt_utcrrWrXget_datetime_strs  z2VEvent.make_qr_code_data..get_datetime_strzGBEGIN:VCALENDAR PRODID:Django QR Code VERSION:2.0 BEGIN:VEVENT DTSTAMP:rz UID:z DTSTART:z DTEND:z SUMMARY:z CLASS:rz CATEGORIES:rz TRANSP:z DESCRIPTION:z ORGANIZER:MAILTO:z STATUS:z LOCATION:z GEO:rrr6z URL:z END:VEVENT END:VCALENDAR)rr)r{rtrdatetimeutcnowrrrrrrrrrnamerrmaprrrrrrr)rUrrr event_strrWrrXmake_qr_code_datahsF   $ zVEvent.make_qr_code_data)rwrxryrzrt__annotations__rrrrrrrrrr floatrrrr rrrrrWrWrWrXrAs   rc@seZdZUdZeed<eed<eeee j fed<dZ e eed<dZ e eed<dZe eed<dZe eed <ed d d ZdS) EpcDataa Data for representing an European Payments Council Quick Response Code (EPC QR Code) version 002. You must always use the error correction level "M" and utilizes max. version 13 to fulfill the constraints of the EPC QR Code standard. .. note:: Either the ``text`` or ``reference`` must be provided but not both .. note:: Neither the IBAN, BIC, nor remittance reference number or any other information is validated (aside from checks regarding the allowed string lengths). Fields meaning: * name: Name of the recipient. * iban: International Bank Account Number (IBAN) * amount: The amount to transfer. The currency is always Euro, no other currencies are supported. * text: Remittance Information (unstructured) * reference: Remittance Information (structured) * bic: Bank Identifier Code (BIC). Optional, only required for non-EEA countries. * purpose: SEPA purpose code. rZibanamountNr referencebicpurposercCstjfit|ddiS)a Validates the input and creates the data for an European Payments Council Quick Response Code (EPC QR Code) version 002. This is a wrapper for :py:func:`segno.helpers._make_epc_qr_data` with no choice for encoding. :rtype: str r r6)rZ_make_epc_qr_datarrZrWrWrXrs zEpcData.make_qr_code_data)rwrxryrzrtrrrGrrkrlrrrrrrrWrWrWrXrs rc@seZdZdZed eeeeeeeeeeeeeeeeeeeeeeeeeed ddZedddZ ed d d Z dS) ContactDetaila Represents the detail of a contact for MeCARD encoding. .. note:: This is a legacy class. Please use :py:class:`MeCard` instead for new projects. Fields meaning: * first_name * last_name * first_name_reading: the sound of the first name. * last_name_reading: the sound of the last name. * tel: the phone number, it can appear multiple times. * tel_av: the video-phone number, it can appear multiple times. * email: the email address, it can appear multiple times. * memo: notes. * birthday: the birth date (Python date). * address: the fields divided by commas (,) denote PO box, room number, house number, city, prefecture, zip code and country, in order. * url: homepage URL. * nickname: display name. * org: organization or company name (non-standard,but often recognized, ORG field). N first_name last_namefirst_name_readinglast_name_readingteltel_avemailmemobirthdayaddressrnicknameorgcCsR||_||_||_||_||_||_||_||_| |_| |_ | |_ | |_ | |_ dSrvr)rUrrrrrrrrrrrrrrWrWrXrY szContactDetail.__init__rcCs|d}dt|jt|jffdt|jt|jfffD]Z}|ddr^|ddr^d|d}n|ddpx|ddpxd}|r4||d|7}q4|jr|dt|j7}|jr|d t|j7}|jr|d t|j7}|jr|d t|j7}|j r |d |j d 7}|j r"|d|j 7}|j r<|dt|j 7}|j rV|dt|j 7}|jrp|dt|j7}|d7}|S)a Make a text for configuring a contact in a phone book. The MeCARD format is used, with an optional, non-standard (but often recognized) ORG field. See this archive of the format specifications: https://web.archive.org/web/20160304025131/https://www.nttdocomo.co.jp/english/service/developer/make/content/barcode/function/application/addressbook/index.html :return: the MeCARD contact description. zMECARD:zN:%s;z SOUND:%s;r6rz%s,%srDzTEL:%s;z TEL-AV:%s;z EMAIL:%s;zNOTE:%s;zBDAY:%s;z%Y%m%dzADR:%s;zURL:%s;z NICKNAME:%s;zORG:%s;r)_escape_mecard_special_charsrrrrrrrrrrrrrr)rU contact_textZname_components_pairrrWrWrXr*s: zContactDetail.make_qr_code_data) field_namecCstt||Srv)rgetattr)rUrrWrWrX escaped_valueWszContactDetail.escaped_value) NNNNNNNNNNNNN) rwrxryrzrrrtrrYrrrWrWrWrXrs@-rc@s^eZdZUdZeed<dZeeed<dZe ee edfed<dZ e ee edfed<dZ e ee edfed<dZ eeed<dZeeed <dZe eejdfed <dZe ee edfed <dZeeed <dZeeed <dZeeed<dZeeed<dZeeed<dZe eedfed<dZeeed<dZeeed<edddZdS)MeCardaRepresents the detail of a contact for MeCARD encoding. Fields meaning: * name: Name. If it contains a comma, the first part is treated as lastname and the second part is treated as forename. * reading: Designates a text string to be set as the kana name in the phonebook * email: E-mail address. Multiple values are allowed. * phone: Phone number. Multiple values are allowed. * videophone: Phone number for video calls. Multiple values are allowed. * memo: A notice for the contact. * nickname: Nickname. * birthday: Birthday. If a string is provided, it should encode the date as YYYYMMDD value. * url: Homepage. Multiple values are allowed. * pobox: P.O. box (address information). * roomno: Room number (address information). * houseno: House number (address information). * city: City (address information). * prefecture: Prefecture (address information). * zipcode: Zip code (address information). * country: Country (address information). * org: organization or company name (ORG field, non-standard,but often recognized by readers). rNreadingrphone videophonerrrrpoboxroomnohousenocity prefecturezipcodecountryrrcCs`t|}|jdur*|jdkr*t|j|d<|d}tjfi|}|r\|dt|d7}|S)zb Creates a string encoding the contact information as MeCARD. :rtype: str NrDrrzORG:r)rrrtpoprZmake_mecard_datar)rUrmrrrWrWrXrs zMeCard.make_qr_code_data)rwrxryrzrtrrrrrr rrrrrrrrrrrrrrrGrrrrWrWrWrXr[s& rc@s:eZdZUdZeed<dZeeed<dZe ee edfed<dZ e ee edfed<dZ e ee edfed<dZ e ee edfed<dZeeed <dZeeed <dZe eejdfed <dZe ee edfed <dZeeed <dZeeed<dZeeed<dZeeed<dZe eedfed<dZeeed<dZeeed<dZeeed<dZeeed<dZeeed<dZ e eejdfed<dZ!e ee edfed<dZ"e ee edfed<dZ#e ee edfed<dZ$e ee edfed<dZ%e ee edfed<ddZ&edd d!Z'dS)"VCardalRepresents the detail of a contact for vCard encoding. Creates a QR code which encodes a `vCard `_ version 3.0. Only a subset of available `vCard 3.0 properties ` is supported. Fields meaning: name: The name. If it contains a semicolon, , the first part is treated as lastname and the second part is treated as forename. displayname: Common name. email: E-mail address. Multiple values are allowed. phone: Phone number. Multiple values are allowed. fax: Fax number. Multiple values are allowed. videophone: Phone number for video calls. Multiple values are allowed. memo: A notice for the contact. nickname: Nickname. birthday: Birthday. If a string is provided, it should encode the date as ``YYYY-MM-DD`` value. url: Homepage. Multiple values are allowed. pobox: P.O. box (address information). street: Street address. city: City (address information). region: Region (address information). zipcode: Zip code (address information). country: Country (address information). org: Company / organization name. lat: Latitude. lng: Longitude. source: URL where to obtain the vCard. rev: Revision of the vCard / last modification date. title: Job Title. Multiple values are allowed. photo_uri: Photo URI. Multiple values are allowed. cellphone: Cell phone number. Multiple values are allowed. homephone: Home phone number. Multiple values are allowed. workphone: Work phone number. Multiple values are allowed. rN displaynamerrfaxrrrrrrstreetrregionrrrlatlngsourcerevtitle photo_uri cellphone homephone workphonecCs.|jdur*|jdddddd|_dS)Nz ;  z; r)rrrrZrWrWrX __post_init__s zVCard.__post_init__rcCs&t|}t|j|d<tjfi|S)z Creates a string encoding the contact information as vCard 3.0. Only a subset of available `vCard 3.0 properties ` is supported. :rtype: str r)rrtrrZmake_vcard_data)rUrmrWrWrXrs zVCard.make_qr_code_data)(rwrxryrzrtrrrrrr rrrrrrrrrrrrrrrGrrrrrrrrrrrrrrrWrWrWrXrs: 'rc@speZdZdZeddedZejdfej dfej dffZ dejdd fe e e ed d d d Ze dddZd S) WifiConfiga Represents a WIFI configuration. Fields meaning: * ssid: the name of the SSID * authentication: the authentication type for the SSID; can be AUTHENTICATION.wep or AUTHENTICATION.wpa, or AUTHENTICATION.nopass for no password. Or, omit for no password. * password: the password, ignored if "authentication" is 'nopass' (in which case it may be omitted). * hidden: tells whether the SSID is hidden or not; can be True or False. AUTHENTICATIONznopass WEP WPArnopassWEPWPArDFN)ssidauthenticationpasswordhiddenr5cCs||_||_||_||_dSrv)rrrr)rUrrrrrWrWrXrYszWifiConfig.__init__rcCszd}|jr|dt|j7}|jr:|dtj|jd7}|jrR|dt|j7}|jrn|dt|j7}|d7}|S)z Make a text for configuring a Wi-Fi connexion. The syntax is inspired by the MeCARD format used for contacts. :return: the WIFI configuration text that can be translated to a QR code. :rtype: str zWIFI:zS:%s;zT:%s;r6zP:%s;zH:%s;r) rrrrAUTHENTICATION_CHOICESrrrtrJ)rU wifi_configrWrWrXrszWifiConfig.make_qr_code_data)rwrxryrzr_makerrrrrrrtrGr{rYrrWrWrWrXrs  "rc@sleZdZUdZeed<eed<dZeee efed<e dddZ d d Z e dd d Z e dd dZdS) Coordinatesz Represents a set of coordinates with an optional altitude. Fields meaning: * latitude: The latitude. * latitude: The longitude. * latitude: The optional altitude. latitude longitudeNaltitudercCs6|jr"d|jd|jd|jSd|jd|jS)Nz latitude: z , longitude: z , altitude: )r rrrZrWrWrX__str__%szCoordinates.__str__cCs|ddS)Nz.8f0)rstrip)rUfrWrWrX float_to_str*szCoordinates.float_to_strcCs@d||jd||j}|jr<|d||jS|S)Nzgeo:rrrrr rUrrWrWrXmake_geolocation_text-s z!Coordinates.make_geolocation_textcCs@d||jd||j}|jr<|d||jS|S)Nz https://maps.google.com/local?q=rrrrWrWrXmake_google_maps_text3s z!Coordinates.make_google_maps_text)rwrxryrzrrr rrrGrtr rrrrWrWrWrXrs  r) phone_numberr5cCsd|S)Nztel:%srWrrWrWrX make_tel_text:srcCsd|S)Nzsms:%srWrrWrWrX make_sms_text>sr)video_idr5cCsdt|S)Nz!https://www.youtube.com/watch/?v=r )rrWrWrXmake_youtube_textBsr) package_idr5cCsdt|S)Nz.https://play.google.com/store/apps/details?id=r )rrWrWrXmake_google_play_textFsrc@seZdZUdZeeeefed<dZeeeedfed<dZ eeeedfed<dZ e eed<dZ e eed<edd d Z dS) EmailaZRepresents the data of an e-mail. Fields meaning: * to: The email address (recipient). Multiple values are allowed. * cc: The carbon copy recipient. Multiple values are allowed. * bcc: The blind carbon copy recipient. Multiple values are allowed. * subject: The subject. * body: The message body. toNccbccsubjectbodyrcCstjfit|S)z Creates either a simple "mailto:" URL or complete e-mail message with (blind) carbon copies and a subject and a body. :rtype: str )rZmake_make_email_datarrZrWrWrXr\szEmail.make_qr_code_data)rwrxryrzrrtr rrrrrr rrWrWrWrXrJs  r)string_to_escaper5cCs.|s|Sgd}|D]}||d|}q|S)N)r"rr:z\%sr)r!Z special_charsscrWrWrXrfs r)4rzrrk collectionsr dataclassesrrenumrtypingrrrr r r rdjango.utils.htmlr pydanticrpydantic.dataclassesrZpydantic_dataclassqr_code.qrcode.constantsrrrrsegnorrr{rIrrrrrrrrrrrtrrrrrrrWrWrWrXsT         /g:U)#