o sbh] @sldZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z ddl m Z mZmZmZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd l m!Z!m"Z"ddl#m$Z$ddl%m&Z&m'Z'm(Z(eZ)dde*de+de*fddZ,de*fddZ-  dde*de*de*fddZ.dde*d e+d!e*de*fd"d#Z/d$e*de*fd%d&Z0dde*d(e+dee*fd)d*Z1dd+e d,e*de*fd-d.Z2d/e*dee fd0d1Z3d2e*de4fd3d4Z5d+e de*fd5d6Z6d7e*de*fd8d9Z7d7e*de*fd:d;Z8dd=e+de9fd>d?Z:d@ee*de9fdAdBZ;dd7e*dDe*de*fdEdFZddJedNe9defdOdPZ?dQedefdRdSZ@ddJedUe*de*defdVdWZAdXe*de9fdYdZZBd[e*de9fd\d]ZCd^e*de9fd_d`ZDdae*dee*e ffdbdcZEdde!de*fdedfZFdde!de*fdgdhZGdde!de9fdidjZHdde!dke*de*fdldmZIdd^e*dnee*de*fdodpZJddre+dse+defdtduZK ddve*dwe*dxe*dyedze*de9f d{d|ZLdde+de*fd~dZMdde*de*de*fddZN ddJe*de*de+de+de*f ddZOddde*de*fddZP M ddJe de9de*de+dede"f ddZQddJe de*de"fddZRdde*dede+de"fddZSdS)z~Core Utilities This module contains utility functions, helpers, and common operations used across the entire Adtlas project. N)urlparse)datetime timedelta)AnyDictListOptional)settings)timezone)slugify) send_mail) strip_tags)get_user_model)gettext) HttpRequest JsonResponse)render_to_string) Paginator EmptyPagePageNotAnIntegerprefixlengthreturncCs&t|d|}|r||S|S)zGenerate a unique identifier with optional prefix. Args: prefix: Optional prefix for the ID length: Length of the random part Returns: Unique identifier string Nsecrets token_urlsafe)rrZ random_partrEC:\Users\vibe-look\OneDrive\Desktop\Adtlas_V\src\apps\common\utils.pygenerate_unique_id%s r cCs ttS)zDGenerate a UUID4 string. Returns: UUID4 string N)struuiduuid4rrrr generate_uuid3s r$slugtext field_namecCsft|}|}d} |jjdi||i}|r |jr |j|jd}|s' |S|d|}|d7}q )a)Generate a unique slug for a model field. Args: text: Text to slugify model_class: Model class to check uniqueness against field_name: Field name to check uniqueness instance: Current instance (for updates) Returns: Unique slug string T)pk-Nr)r objectsfilterr)excludeexists)r& model_classr'instanceZ base_slugr%counterquerysetrrrslugify_unique<s  r3d... max_lengthsuffixcCs(t||kr|S|d|t||S)zTruncate text to specified length with suffix. Args: text: Text to truncate max_length: Maximum length suffix: Suffix to add if truncated Returns: Truncated text Nlen)r&r6r7rrr truncate_text_s r: html_contentcCs t|S)zClean HTML content by removing tags. Args: html_content: HTML content to clean Returns: Clean text without HTML tags N)r strip)r;rrr clean_htmlps r= min_lengthcs:t|}td|}ttfdd|D}t|S)zExtract keywords from text. Args: text: Text to extract keywords from min_length: Minimum keyword length Returns: List of keywords z\b\w+\bc3s |] }t|kr|VqdSNr8).0wordr?rr sz#extract_keywords..N)r=lowerrefindalllistsetsorted)r&r?Z clean_textwordskeywordsrrCrextract_keywords|s rMdt format_stringcCs |sdS|r ||S|dS)zFormat datetime with default or custom format. Args: dt: Datetime to format format_string: Custom format string Returns: Formatted datetime string r%Y-%m-%d %H:%M:%SN)strftime)rNrOrrrformat_datetimes    rR date_stringc Cs:gd}|D]}z t||WStyYqwdS)zParse datetime string with multiple format attempts. Args: date_string: Date string to parse Returns: Parsed datetime or None ) rPz%Y-%m-%d %H:%Mz%Y-%m-%dz%d/%m/%Y %H:%M:%Sz%d/%m/%Y %H:%Mz%d/%m/%Yz%m/%d/%Y %H:%M:%Sz%m/%d/%Y %H:%Mz%m/%d/%YN)rstrptime ValueError)rSformatsfmtrrrparse_datetimes   rXperiodc CsFt}|}|dkr||fS|dkr|tdd}||fS|dkr0|t|d}||fS|dkrJ|t|dd}|tdd}||fS|d krX|jdd }||fS|d krs|jdd }|tdd}|jdd }||fS|d kr|jddd }||fS|dkr|jd} |j| ddd}|j| ddd}||fS||fS)zGet date range for common periods. Args: period: Period name (today, yesterday, this_week, last_week, etc.) Returns: Tuple of (start_date, end_date) today yesterdayr()daysZ this_weekZ last_weekZ this_month)dayZ last_month this_year)monthr_ last_year)yearrar_ N)r nowdaterweekdayreplacerc) rYrfrZr[startendZfirst_this_monthZlast_month_endZlast_month_startrbrrrget_date_ranges>     rlcCs$|sdSt}||}|jdkr'|jd}|d|dkr"ddSddS|jdkrB|jd}|d|dkr=ddSddS|jd krZ|jd |jdkrUddSddS|jd kru|jd }|d |dkrpddSddS|jd kr|jd }|d|dkrddSddSdS)zGet human-readable time ago string. Args: dt: Datetime to compare Returns: Human-readable time ago string rimz yearr(sz agoz monthrz dayiz hour<z minutezJust nowN)r rfr\seconds)rNrfdiffyearsmonthshoursminutesrrrtime_agos&   "  " &  "  "rvfilenamecCstj|dddS)zGet file extension from filename. Args: filename: Name of the file Returns: File extension (without dot) r(N)ospathsplitextrE)rwrrrget_file_extensions r{cCst|\}}|p dS)z{Get MIME type for a file. Args: filename: Name of the file Returns: MIME type string zapplication/octet-streamN) mimetypes guess_type)rwZ mime_type_rrr get_mime_type%s r max_size_mbcCs|dd}|j|kS)zValidate file size. Args: file: File object max_size_mb: Maximum size in MB Returns: True if valid, False otherwise iN)size)filerZmax_size_bytesrrrvalidate_file_size2s r allowed_typescCst|j}||vS)zValidate file type. Args: file: File object allowed_types: List of allowed MIME types Returns: True if valid, False otherwise N)rname)rrZ file_typerrrvalidate_file_type@s ruploadsfoldercCs:t|}td|}td}|d|d|S)zGenerate upload path for files. Args: instance: Model instance filename: Original filename folder: Upload folder Returns: Upload path .z%Y/%m/%d/N)r{r$r rfrQ)r0rwrextZunique_filenameZ date_pathrrrgenerate_upload_pathNs r json_stringc Cs*zt|WStjtfy|YSw)zSafely load JSON string. Args: json_string: JSON string to parse default: Default value if parsing fails Returns: Parsed JSON data or default value N)jsonloadsJSONDecodeError TypeError)rdefaultrrrsafe_json_loadsis  rdatac Cs0ztj|tdWSttfy|pdYSw)zSafely dump data to JSON string. Args: data: Data to serialize default: Default value if serialization fails Returns: JSON string or default value )rz{}N)rdumpsr!rrU)rrrrrsafe_json_dumpsys   rT remove_emptycCsFi}|D]\}}|durq|r|s|dkr|durq|||<q|S)zClean dictionary by removing None values and optionally empty values. Args: data: Dictionary to clean remove_empty: Whether to remove empty values Returns: Cleaned dictionary NrF)items)rrcleanedkeyvaluerrr clean_dicts  rdictscGs&i}|D] }t|tr||q|S)zMerge multiple dictionaries. Args: *dicts: Dictionaries to merge Returns: Merged dictionary N) isinstancedictupdate)rresultdrrr merge_dictss    rr separatorcCsXi}|D]#\}}|r|||n|}t|tr%|t|||q|||<q|S)zFlatten nested dictionary. Args: data: Dictionary to flatten separator: Key separator prefix: Key prefix Returns: Flattened dictionary N)rrrr flatten_dict)rrrrrrZnew_keyrrrrs   remailcCsd}tt||S)zValidate email address format. Args: email: Email address to validate Returns: True if valid, False otherwise z0^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$N)boolrFmatch)rpatternrrrvalidate_emails rphonecCs*tdd|}dt|kodkSS)zValidate phone number format. Args: phone: Phone number to validate Returns: True if valid, False otherwise z\Drr]N)rFsubr9)rZ digits_onlyrrrvalidate_phones rurlcCs0z t|}t|j|jgWStyYdSw)z~Validate URL format. Args: url: URL to validate Returns: True if valid, False otherwise FN)rallschemenetloc Exception)rrrrr validate_urls   rpasswordcCs~dgddd}t|dkr|ddd|d <n|d d 7<td |s3|dd d|d <n|d d 7<td|sM|ddd|d <n|d d 7<td|sg|ddd|d <n|d d 7<td|s|ddd|d <n|d d 7<|d dkrd|d<|S|d dkrd|d<|S|d dkrd|d<|S|d dkrd|d<|Sd|d<|S)zValidate password strength. Args: password: Password to validate Returns: Dictionary with validation results Trweak)is_validerrorsscorestrengthrrz+Password must be at least 8 characters longFrrr(z[a-z]z3Password must contain at least one lowercase letterz[A-Z]z3Password must contain at least one uppercase letterz\dz)Password must contain at least one numberz&[!@#$%^&*()_+\-=\[\]{};\':"\\|,.<>\/?]z4Password must contain at least one special characterZ very_strongrZstrongr>mediumZ very_weakN)r9appendrFsearch)rrrrrvalidate_password_strengthsN               rrequestcCs2|jd}|r|dd}|S|jd}|S)zGet client IP address from request. Args: request: HTTP request object Returns: Client IP address HTTP_X_FORWARDED_FOR,r REMOTE_ADDRN)METAgetsplit)rZx_forwarded_foriprrr get_client_ip?s  rcCs|jddS)zGet user agent from request. Args: request: HTTP request object Returns: User agent string HTTP_USER_AGENTrNrrrrrrget_user_agentPs rcCs|jddkS)zCheck if request is AJAX. Args: request: HTTP request object Returns: True if AJAX request, False otherwise ZHTTP_X_REQUESTED_WITHZXMLHttpRequestNrrrrris_ajax_request\s rrycCs ||S)zBuild absolute URI from request and path. Args: request: HTTP request object path: Relative path Returns: Absolute URI N)build_absolute_uri)rryrrrrhs r allowed_hostscCs<|sdSt|}|js |S|pttdg}|j|vr|SdS)zValidate and return safe redirect URL. Args: url: URL to validate allowed_hosts: List of allowed hosts Returns: Safe URL or default URL r ALLOWED_HOSTSN)rrgetattrr )rrparsedrrrsafe_redirect_urlus  rpageper_pagec Cst||}z||}Wnty|d}Ynty(||j}Ynw|j|||||r;|nd|rD| nd|j |j|j | | d S)zPaginate queryset and return pagination data. Args: queryset: Django queryset page: Page number per_page: Items per page Returns: Dictionary with pagination data r(N) r+page_obj paginator has_previoushas_nextprevious_page_numbernext_page_number current_page total_pages total_count start_index end_index)rrrr num_pages object_listrrrrnumbercountrr)r2rrrrrrrpaginate_querysets*   rto_emailsubject template_namecontext from_emailc Csvz |pi}|p tj}t||}t|}t||||g|ddWdSty:}ztd|WYd}~dSd}~ww)a)Send notification email using template. Args: to_email: Recipient email subject: Email subject template_name: Template name context: Template context from_email: Sender email Returns: True if sent successfully, False otherwise F)rmessagerrecipient_list html_message fail_silentlyTzEmail sending failed: N)r DEFAULT_FROM_EMAILrr r rprint)rrrrrr;Z text_contenterrrsend_notification_emails&   r cCs t|S)z|Generate secure random token. Args: length: Token length Returns: Secure random token Nr)rrrrgenerate_tokens rsha256 algorithmcCs"t|}||d|S)zHash string using specified algorithm. Args: text: Text to hash algorithm: Hash algorithm Returns: Hashed string zutf-8N)hashlibnewrencode hexdigest)r&rZhash_objrrr hash_strings r*r mask_char visible_start visible_endcCsft|||kr|t|S|d|}|dkr|| dnd}|t|||}|||S)a5Mask sensitive data showing only start and end characters. Args: data: Data to mask mask_char: Character to use for masking visible_start: Number of visible characters at start visible_end: Number of visible characters at end Returns: Masked data Nrrr8)rrrrrjrkmiddlerrrmask_sensitive_datas   radtlas)rcGs"dd|D}d|g|}|S)zGenerate cache key from arguments. Args: *args: Arguments to include in key prefix: Key prefix Returns: Cache key cSsg|]}t|qSr)r!)rAargrrr +sz&generate_cache_key..:N)join)rargsZ key_partsrrrrgenerate_cache_key!s r successrstatusrcCs$|||d}|r ||d<t||dS)aCreate standardized JSON response. Args: data: Response data success: Success status message: Response message status: HTTP status code errors: Error details Returns: JsonResponse object )rrrr)rN)r)rrrrrZ response_datarrr json_response4s rSuccesscCst|d|ddS)zCreate success JSON response. Args: data: Response data message: Success message Returns: JsonResponse object Tr )rrrrNr)rrrrrsuccess_responseOs rErrorcCstd|||dS)zCreate error JSON response. Args: message: Error message errors: Error details status: HTTP status code Returns: JsonResponse object F)rrrrNr)rrrrrrerror_response\s  r)rr)r%N)r4r5)r>r@)r)r)T)rr)r)NN)r)r)rrr)NTrr N)Nr)rNr)T__doc__rxrFrr"rrr| urllib.parserrrtypingrrrr django.confr django.utilsr django.utils.textr django.core.mailr django.utils.htmlr django.contrib.authrdjango.utils.translationrr~ django.httprrdjango.template.loaderrdjango.core.paginatorrrrUserr!intr r$r3r:r=rMrRrXtuplerlrvr{rrrrrrrrrrrrrrrrrrrrrrrrr rrrrrrrs            # -%   C   ") ,