B ›³ëbÈ<ã@sØdZddlZddlZddlZddlZGdd„dejjƒZGdd„deƒZ Gdd„dejjƒZ Gd d „d e ƒZGdd„dejjƒZGd d„deƒZ Gdd„dejjƒZGdd„deƒZej e¡ej e ¡ej e ¡ej e¡ej e¡ej e ¡ej e¡ej e¡Gdd„dƒZe dej¡ae dej¡ad4dd„ZddlmZGdd„deƒZdejjfdd„ZGdd„dƒZd d!„Zd"d#„Zd$d%„Z d&d'„Z!d(d)„Z"d*d+„Z#d,d-„Z$d.d/„Z%d0d1„Z&d2d3„Z'dS)5zOCommon routines for gettext tools Used by several tools of `gettext` toolset. éNc@seZdZdS)ÚXgettextToolWarningN)Ú__name__Ú __module__Ú__qualname__©rrú7lib/python3.7/site-packages/SCons/Tool/GettextCommon.pyr#src@seZdZdS)ÚXgettextNotFoundN)rrrrrrrr'src@seZdZdS)ÚMsginitToolWarningN)rrrrrrrr +sr c@seZdZdS)ÚMsginitNotFoundN)rrrrrrrr /sr c@seZdZdS)ÚMsgmergeToolWarningN)rrrrrrrr3src@seZdZdS)ÚMsgmergeNotFoundN)rrrrrrrr7src@seZdZdS)ÚMsgfmtToolWarningN)rrrrrrrr ;sr c@seZdZdS)ÚMsgfmtNotFoundN)rrrrrrrr?src@s8eZdZdZd dd„Zddd„Zdd d „Zddd„ZdS)Ú_POTargetFactoryzé A factory of `PO` target files. Factory defaults differ from these of `SCons.Node.FS.FS`. We set `precious` (this is required by builders and actions gettext) and `noclean` flags by default for all produced nodes. TNcCs"||_||_||_||_||_dS)ab Object constructor. **Arguments** - *env* (`SCons.Environment.Environment`) - *nodefault* (`boolean`) - if `True`, produced nodes will be ignored from default target `'.'` - *alias* (`string`) - if provided, produced nodes will be automatically added to this alias, and alias will be set as `AlwaysBuild` - *precious* (`boolean`) - if `True`, the produced nodes will be set as `Precious`. - *noclen* (`boolean`) - if `True`, the produced nodes will be excluded from `Clean`. N)ÚenvÚaliasÚpreciousÚnocleanÚ nodefault)ÚselfrrrrrrrrÚ__init__Us z_POTargetFactory.__init__écCsZ||||ƒ}| |j¡| |j¡|jr8|j d|¡|jrV|j |j |j|¡¡|S)z1 Create node, and set it up to factory settings. Ú.) Zset_nocleanrZset_preciousrrrÚIgnorerZAlwaysBuildZAlias)rÚnameÚfactoryÚ directoryÚcreateÚnoderrrÚ_create_nodeksz_POTargetFactory._create_nodecCs| ||jjj||¡S)z Create `SCons.Node.FS.Entry` )rrÚfsÚEntry)rrrrrrrr!vsz_POTargetFactory.EntrycCs| ||jjj||¡S)z Create `SCons.Node.FS.File` )rrr ÚFile)rrrrrrrr"zsz_POTargetFactory.File)TNTT)Nr)Nr)Nr)rrrÚ__doc__rrr!r"rrrrrMs rz(#[^\n\r]+)$z([a-zA-Z0-9_]+)cCsŒtj |¡s2tj |¡s2t|tjjjƒs2|r2dg}|dkr>gS| |¡}g}x:|D]2}t d| ¡¡}dd„t |¡Dƒ}| |¡qRW|S)z= Parse `LINGUAS` file and return list of extracted languages ZLINGUASNÚcSsg|]}|r|‘qSrr)Ú.0Úlrrrú “sz,_read_linguas_from_files..)ÚSConsÚUtilÚis_ListZ is_StringÚ isinstanceÚNodeÚFSÚBaseZ arg2nodesÚ_re_commentÚsubZget_text_contentsÚ_re_langÚfindallÚextend)rÚ linguas_filesZfnodesÚlinguasZfnodeÚcontentsZlsrrrÚ_read_linguas_from_filesƒs r7)ÚBuilderBasecs(eZdZdZ‡fdd„Zdd„Z‡ZS)Ú_POFileBuildera‹ `PO` file builder. This is multi-target single-source builder. In typical situation the source is single `POT` file, e.g. `messages.pot`, and there are multiple `PO` targets to be updated from this `POT`. We must run `SCons.Builder.BuilderBase._execute()` separatelly for each target to track dependencies separatelly for each target file. **NOTE**: if we call `SCons.Builder.BuilderBase._execute(.., target, ...)` with target being list of all targets, all targets would be rebuilt each time one of the targets from this list is missing. This would happen, for example, when new language `ll` enters `LINGUAS_FILE` (at this moment there is no `ll.po` file yet). To avoid this, we override `SCons.Builder.BuilerBase._execute()` and call it separatelly for each target. Here we also append to the target list the languages read from `LINGUAS_FILE`. cs†d|krd|d<d|kr d|d<d|kr0d|d<d|kr@d|d<d}d |krZ|d }|d =d |krtt||dj|d <tƒjf|ŽdS)NÚsuffixz $POSUFFIXZ src_suffixz $POTSUFFIXZsrc_builderZ_POTUpdateBuilderZ single_sourceTZtarget_aliasZtarget_factory)r)rr"Úsuperr)rrÚkwr)Ú __class__rrrÂsz_POFileBuilder.__init__cOsæddl}d}d|krf|drf|d}d|d<t||ƒ}|j |¡rN| |¡n|dk rb|g|}n|}|s‚tj||||f|ž|ŽS|j |¡s”|g}g} x0|D](} tj||| g|f|ž|Ž}| |¡qžW|dk rÚ||d<|j | ¡S)a, Execute builder's actions. Here we append to `target` the languages read from `$LINGUAS_FILE` and apply `SCons.Builder.BuilderBase._execute()` separatelly to each target. The arguments and return value are same as for `SCons.Builder.BuilderBase._execute()`. rNZLINGUAS_FILE) Z SCons.Noder7r)r*r3r8Ú_executer,ZNodeList)rrÚtargetÚsourceÚargsr<r(r4r5ÚresultÚtgtÚrrrrr>Ós, z_POFileBuilder._execute)rrrr#rr>Ú __classcell__rr)r=rr9›sr9cOs8|dkrg}|jd|f|ž|Ž}|j||f|ž|Ž}|S)z+ Function for `Translate()` pseudo-builder N)Z POTUpdateZPOUpdate)rr?r@rAr<ZpotZporrrÚ _translateøs rFc@s eZdZdZdd„Zdd„ZdS)ÚRPathsa) Callable object, which returns pathnames relative to SCons current working directory. It seems like `SCons.Node.FS.Base.get_path()` returns absolute paths for nodes that are outside of current working directory (`env.fs.getcwd()`). Here, we often have `SConscript`, `POT` and `PO` files within `po/` directory and source files (e.g. `*.c`) outside of it. When generating `POT` template file, references to source files are written to `POT` template, so a translator may later quickly jump to appropriate source file and line from its `PO` editor (e.g. `poedit`). Relative paths in `PO` file are usually interpreted by `PO` editor as paths relative to the place, where `PO` file lives. The absolute paths would make resultant `POT` file nonportable, as the references would be correct only on the machine, where `POT` file was recently re-created. For such reason, we need a function, which always returns relative paths. This is the purpose of `RPaths` callable object. The `__call__` method returns paths relative to current working directory, but we assume, that *xgettext(1)* is run from the directory, where target file is going to be created. Note, that this may not work for files distributed over several hosts or across different drives on windows. We assume here, that single local filesystem holds both source files and target `POT` templates. Intended use of `RPaths` - in `xgettext.py`:: def generate(env): from GettextCommon import RPaths ... sources = '$( ${_concat( "", SOURCES, "", __env__, XgettextRPaths, TARGET, SOURCES)} $)' env.Append( ... XGETTEXTCOM = 'XGETTEXT ... ' + sources, ... XgettextRPaths = RPaths(env) ) cCs ||_dS)z¶ Initialize `RPaths` callable object. **Arguments**: - *env* - a `SCons.Environment.Environment` object, defines *current working dir*. N)r)rrrrrr/szRPaths.__init__c Osfddl}d}|jj ¡ ¡}xD|D]<}d}t||jjjƒrLt j | ¡|¡}|dk r"||f7}q"W|S)a” Return nodes' paths (strings) relative to current working directory. **Arguments**: - *nodes* ([`SCons.Node.FS.Base`]) - list of nodes. - *args* - currently unused. - *kw* - currently unused. **Returns**: - Tuple of strings, which represent paths relative to current working directory (for given environment). rNr)Z SCons.Node.FSrr ÚgetcwdZget_abspathr+r,r-r.ÚosÚpathÚrelpath) rZnodesrAr<r(ZrpathsÚcwdrZrpathrrrÚ__call__;s zRPaths.__call__N)rrrr#rrMrrrrrGs% rGc CsŒdd„}d|kr|d}nd}xh|D]`}| ¡s$|rDtj dd¡}n*dtt|ƒƒdd d}tj ||¡}||g||ƒ}|r$|Sq$Wd S)z' Action function for `POInit` builder. cSsdS)Nrr)r?r@rrrrÚXóz _init_po_files..Z POAUTOINITFz$MSGINITCOMz$MSGINITCOMSTRzFile z does not exist. z5If you are a translator, you can create it through: r)Úexistsr(ZActionÚreprÚstr) r?r@rZnopZautoinitrCÚactionÚmsgZstatusrrrÚ_init_po_filesVs rUcCs4d|kr|dS| d¡}|r"|Stj td¡‚dS)z Detects *xgettext(1)* binary ZXGETTEXTÚxgettextzCould not detect xgettextN)ÚDetectr(ÚErrorsÚ StopErrorr)rrVrrrÚ_detect_xgettextns rZcCst|ƒS)N)rZ)rrrrÚ_xgettext_existsysr[cCs4d|kr|dS| d¡}|r"|Stj td¡‚dS)z Detects *msginit(1)* program. ZMSGINITÚmsginitzCould not detect msginitN)rWr(rXrYr )rr\rrrÚ_detect_msginit}s r]cCst|ƒS)N)r])rrrrÚ_msginit_existsˆsr^cCs4d|kr|dS| d¡}|r"|Stj td¡‚dS)z Detects *msgmerge(1)* program. ZMSGMERGEÚmsgmergezCould not detect msgmergeN)rWr(rXrYr)rr_rrrÚ_detect_msgmergeŒs r`cCst|ƒS)N)r`)rrrrÚ_msgmerge_exists—sracCs4d|kr|dS| d¡}|r"|Stj td¡‚dS)z Detects *msgmfmt(1)* program. ZMSGFMTÚmsgfmtzCould not detect msgfmtN)rWr(rXrYr)rrbrrrÚ_detect_msgfmt›s rccCst|ƒS)N)rc)rrrrÚ_msgfmt_exists¦srdcCsddddgS)z@ List tools that shall be generated by top-level `gettext` tool rVr\r_rbr)ÚplatformrrrrÚ tool_listªsrf)N)(r#rIÚreZ SCons.Utilr(ZSCons.WarningsZWarningsZSConsWarningrrr r rrr rZenableWarningClassrÚcompileÚMr/r1r7Z SCons.Builderr8r9ZEnvironmentZ_nullrFrGrUrZr[r]r^r`rarcrdrfrrrrÚsL2 ]V