;j d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlZd dl m
Z
m Z m Z m
Z
mZmZ ej d Ze G d d Zdee fdZd edefd
Zdefd Zd efd Zdd ededefdZd edefdZ dS ) N) dataclass)DEFAULT_CONFIG_STORAGE_PATHDEFAULT_FLAGS_STORAGE_PATHDEFAULT_META_STORAGE_PATH DEFAULT_OPT_OUT_STORAGE_PATH DEFAULT_REMOTE_OFF_STORAGE_PATHDEFAULT_FLAG_GLOBz^[a-z0-9][a-z0-9-]{0,63}$c J e Zd ZU eed< eed< eed< ed Zd ZdS )FlagInfoname descriptionpathc t t | j o#t j | j S N) _held_offr osr isfileselfs /builddir/build/BUILDROOT/alt-python27-cllib-3.4.44-1.el8.cloudlinux.x86_64/opt/cloudlinux/venv/lib/python3.11/site-packages/clflags/gather.pyenabledzFlagInfo.enabled$ s,
TY'''EBGNN49,E,EE c * t | j S r )hashr r s r __hash__zFlagInfo.__hash__+ s DI r N)__name__
__module__ __qualname__str__annotations__propertyr r r r r r s_
III
III
F F XF r r returnc g } t j t t }t j | D ]I} t
|d 5 }t j | }ddd n # 1 swxY w Y |t d |
d }|st d t j | }t j t | }| t | d d ||
d |
# t" $ r. t% j d | t% j d | Y Gw xY w| S )
z}
Gathers information about flags from DEFAULT_META_STORAGE_PATH
and returns them in a python-friendly structure.
utf-8encodingNz Empty or invalid YAML contentr
z!Missing 'description' in metadata.r )r r
r zError processing %sz!Skipping flag %s due to an error.)r r joinr r globopenyaml safe_load
ValueErrorgetKeyErrorbasenamer appendr rsplit Exceptionlogging exceptionerror)
meta_files storage_glob meta_filefmetadatar
flag_namedefault_flag_paths r list_flags_infor@ / s
"$J7<< 9;LMMLY|,, i'222
-a >!,,
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- !@AAA",,}55K
D BCCC((33I " -G S S h %%c**2. ' \\&*;<<
3Y ? ? ? M=y I I I H
s7 EA7+ E7A; ;E>A; ?CE4F F r c \ | dz t fdt t fD S )zWhether the remote settings (remote-off.d) or an admin (opt-out.d) keep
the feature `name` off on this server, whatever its switch says..flagc 3 K | ]A}t j t j | V Bd S r )r r r r* ).0off_dirmarkers r z _held_off..X s] _ _ w~~bgll7F ; ;<< _ _ _ _ _ _r )anyr r )r rF s @r r r T sV G^F _ _ _ _ >@\ ]_ _ _ _ _ _r c t | t r t | rdS t j d| dS )NTz$clflags: %r is not a valid flag nameF)
isinstancer FLAG_NAME_REmatchr6 r8 )r s r _valid_namerM \ sF $ !3!3D!9!9 t M8$??? 5r c f t j t | dz } t |d 5 }t j | }ddd n # 1 swxY w Y n2# t $ r Y dS t $ r t j
d| Y dS w xY wt |t st j
d| dS | d }|r,t |t st j
d| d}|p't j t | dz S ) aD Where this flag's marker file lives, or None when the flag is not
declared on this server.
Reads only that flag's own metadata rather than the whole directory:
is_enabled() is called on hot paths - a cPanel hook, an in-cage entry
point - and a glob plus a YAML parse per flag is not what answering
"is this on?" should cost.
Unlike list_flags_info() this does not insist on a description. That field
documents the flag for people; letting a missing one decide whether a
feature runs would mean a typo in a comment silently changes behaviour.
rB r% r& Nzclflags: cannot read %sz*clflags: %s is empty or not a YAML mappingr z%clflags: 'path' in %s is not a string)r r r* r r, r- r. FileNotFoundErrorr5 r6 r7 rJ dictr8 r0 r r )r r; r< r= r s r _declared_pathrQ c su 6wGGI
)g
.
.
. )!~a((H ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) tt 3Y???tt h % %
BINNNt << D JtS))
=yIII K27<< :D7NKKKs: A( A A( A A( #A $A( (
B5 BBTdefaultc t | s|S t | rdS t | }||S t j | S )a Whether the feature `name` is switched on for this server.
Off, whatever its marker file says, while the remote settings switch the
feature off here (remote-off.d) or an admin has opted this server out of it
(opt-out.d). Both hold before the flag is even declared, so a package that
ships the feature on installs it off.
Otherwise `default` is what the caller ships with, and is returned only when
the flag is **not declared here** - an older package, or an install that
never laid down its metadata. A declared flag always has a definite answer:
its marker file is either there or it is not.
Never raises and never touches the network. Whatever manages the flags is
responsible for the marker files; this only reads them.
F)rM r rQ r r r )r rR r s r
is_enabledrT sW t u $ D |
7>>$ r c t | si S t j t | dz } t |d 5 }t
j | }ddd n # 1 swxY w Y n4# t $ r i cY S t $ r t j d| i cY S w xY wt |t st j d| i S |S )ac Parameters recorded for the feature `name`, or {} when it has none.
Separate from is_enabled() on purpose: only a feature that actually takes
parameters pays for reading and parsing them. Returns {} rather than
raising on anything unreadable, so a damaged file degrades the feature to
its own defaults instead of breaking the caller.
z.jsonr% r& Nz clflags: cannot read config %sz'clflags: %s does not hold a JSON object)rM r r r* r r, jsonloadrO r5 r6 r7 rJ rP r8 )r r r< configs r
get_configrY s/ t
7<<3TG^ D DD
$
)
)
) "QYq\\F " " " " " " " " " " " " " " " :DAAA fd # #
?FFF Ms; A9 A-! A9 -A11A9 4A15A9 9 B* B*)B*)T) r+ rV r6 os.pathr re dataclassesr r- clflags.configr r r r r r compilerK r listr@ r boolr rM rQ rT rP rY r" r r ra s ! ! ! ! ! ! rz677
"h " " " "J_C _D _ _ _ _ L L L L LD S 4 4 8S T r