(de fd%Z!d&ede fd'Z"d+d(Z#e$d)k(re#yy),zUTM URL Builder CLI. Usage examples: python3 utm_builder.py --source meta --medium cpc --campaign AB_A_snu \ --content carousel_a1 --base https://incar-top.tistory.com python3 utm_builder.py --batch items.json N)Optional TypedDict) ParseResultparse_qs urlencodeurlparse urlunparse)metagooglenaver_sa naver_gfakakaodanggeunsaraminjobkoreaALLOWED_SOURCES)cpcdisplaysocial job_boardALLOWED_MEDIUMS)AB_A_snu AB_B_incarorg_movealways_Aalways_Burgent_AALLOWED_CAMPAIGNSzincar-top.tistory.comzincar-top1.tistory.comALLOWED_LANDING_DOMAINSceZdZdZy)ValidationErrorz+Raised when UTM parameter validation fails.N)__name__ __module__ __qualname____doc__D/home/jay/workspace/.worktrees/task-2057-dev2/scripts/utm_builder.pyr!r!7s5r'r!cNeZdZUdZeed<eed<eed<eed<eed<eed<y) BatchItemz!Single item in a batch JSON file.sourcemediumcampaigncontenttermbaseN)r"r#r$r%str__annotations__r&r'r(r*r*;s#+ K KM L I Ir'r*F)totalc<eZdZUdZeed<eeed<eeed<y) BatchResultzResult for a single batch item.indexurlerrorN)r"r#r$r%intr2rr1r&r'r(r5r5Fs) J # C=r'r5r+r,r-r0r.r/returncg}|tvr*|jd|ddjt|tvr*|jd|ddjt|tvr*|jd|ddjtt |}|j r |js+|jd|ddjtnP|jjdd }|tvr*|jd |d djt|rtd j|y )zwValidate UTM parameters against allowed values. Raises: ValidationError: if any parameter is invalid. zInvalid utm_source 'z'. Allowed values: z, zInvalid utm_medium 'zInvalid utm_campaign 'zInvalid base URL 'z'. Allowed landing domains: :rzInvalid landing page domain 'z'. Allowed domains:  N) rappendjoinrrrschemenetlocrsplitr!) r+r,r-r0r.r/errorsparseddomains r(validate_paramsrFQsAF _$ ,VH4KDIIVeLfKghi _$ ,VH4KDIIVeLfKghi(( .xj8OPTPYPYZkPlOmno"4.F ==  *4&0PQUQZQZ[rQsPtuv$$S)!, 0 0 MM/x7OPTPYPYZqPrOst dii/00r'c"t|}|||d}|r||d<|r||d<t|jd}|jD cic] \} } | | d } } } i| |} t | } |j | }t |Scc} } w)zaBuild a UTM-tagged URL from parameters. Assumes parameters have already been validated. ) utm_source utm_medium utm_campaign utm_contentutm_termT)keep_blank_valuesr)query)rrrNitemsr_replacer )r0r+r,r-r.r/rD utm_params existing_qskv flat_existingmerged new_query new_parseds r( build_utm_urlrYwsd^F "J $+ =! !% :6<<4@K9D9J9J9L$MAQ!W$MM$M- , ,F&!Iy1J j !!%Ns B rOc g}t|D]\}}|jdd}|jdd}|jdd}|jd}|jd}|jdd} t|||| ||t| ||||| } |j || d d |S#t $r(} |j |d t | d Yd } ~ d } ~ wwxYw) zProcess a list of batch items, returning results for each. Validation errors produce BatchResult with url=None, error=. r+r,r-r.r/r0r+r,r-r0r.r/r0r+r,r-r.r/N)r6r7r8) enumerategetrFrYr>r!r1) rOresultsidxitemr+r,r-r.r/r0r7excs r( process_batchrds "$Gu%K T(B'(B'88J+((9%xxxx# K !   ! C NNStD E3K: N K NNSCI J J Ks?7B:: C+C&&C+textcb ddl}|j|y#t$rYyt$rYywxYw)zETry to copy text to clipboard via pyperclip. Returns True on success.rNTF) pyperclipcopy ImportError Exception)rergs r(_try_copy_to_clipboardrks6t  s ...c`tjdtj}|jdd|jdd|jdd |jd dd |jd dd |jdd|jddd|S)Nz6Build UTM-tagged URLs following team naming standards.) descriptionformatter_classz--sourcez$UTM source (required unless --batch))helpz--mediumz$UTM medium (required unless --batch)z --campaignz&UTM campaign (required unless --batch)z --contentzUTM content (optional))defaultroz--termz#UTM term (optional, for search ads)z--basez/Base landing page URL (required unless --batch)z--batch JSON_FILEz;Path to a JSON file containing a list of UTM parameter sets)metavarro)argparseArgumentParserRawDescriptionHelpFormatter add_argument)parsers r(_build_arg_parserrxs  $ $L <<F  )OP  )OP  +ST  T8PQ $5Z[ 'XY  J Mr'argscdDcgc]}t||r|}}|r#td|ddtjy t |j |j |j|j|j|jt|j|j |j |j|j|j }t|t|rtd tjycc}w#t$r(}td|tjYd }~yd }~wwxYw) z0Handle single URL generation. Returns exit code.)r+r,r-r0z Error: --rz# is required when not using --batchfiler\zValidation error: Nr]z(Copied to clipboard))getattrprintsysstderrrFr+r,r-r0r.r/r!rYrk)ryfmissingrcr7s r( _run_singlers B[Q'RVXYJZq[G[  |#F G  ;;;;]]LL    YY{{{{ YY  C #Jc" %CJJ7 E\"  #C5) ;s#DDA D EEE json_pathcd t|d5}tj|}dddttst dt j y|}t|}d }|D]M}|d }|d *t d |dzd |d t j d}7t d |dzd|dO|rdSdS#1swYxYw#t$r!t d|t j Yytj$r(}t d|t j Yd}~yd}~wwxYw)z>Handle batch URL generation from JSON file. Returns exit code.zutf-8)encodingNzError: batch file not found: r{r}z#Error: invalid JSON in batch file: z.Error: batch JSON must be an array of objects.Fr6r8[z ] ERROR: Tz] r7r) openjsonloadFileNotFoundErrorrrrJSONDecodeError isinstancelistrd) rrrawrcrOr` has_errorresultras r( _run_batchrs- )g . !))A,C  c4  >SZZP EE"GI2Wo '? & AcAgYiw'89 KI AcAgYb0 1 21 q 3    -i[9 K    3C59 Ks3 C CC C C 'D/5D/D**D/ct}|j}|jrt|j}n t |}t j |y)N)rx parse_argsbatchrrrexit)rwry exit_codes r(mainr.sC  F    D zztzz* % HHYr'__main__)NN)r:N)%r%rsrrtypingrr urllib.parserrrrr rrr1r2rrr ValueErrorr!r*r5rFrYrdboolrkrtrx Namespacer9rrrr"r&r'r(rs &OO c c 49&c6j6 ) " #1 #1 #1#1  #1 c] #1 3- #1 #1V" "" "" "" "" "" c] "" 3- "" ""J#i#T+->#R    822&$ h(($ S$ N!#!#!>  zFr'