Xh!) * d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl m
Z
ddl m Z ddl
mZmZ ddlmZ ddlmZ dd lmZmZ dd
lmZ d d lmZ d
ZdZ ej: d ej< dd G d de Z G d de Z y)z3Manager and Tornado handlers for license reporting. ) annotationsN)ThreadPoolExecutor)Path)
TYPE_CHECKINGAny)
APIHandler)web)ListUnicode)LoggingConfigurable )get_federated_extensionszthird-party-licenses.jsonUNKNOWN
text/markdownz.mdc e Zd ZdZ ed Z e e ede gd Z e
dd Z d ddZ dd Z
dd
Zdd Zddd Zdd
ZddZdddZy)LicensesManagerzA manager for listing the licenses for all frontend end code distributed
by an application and any federated extensions
r
) max_workerszstatic/z=the license report data in built app and federated extensions)
default_valuehelpc t r ddlm} t | j | sJ | j j
| j j g}|D cg c] }|D ] }|
}}}t | S c c}}w )zLazily load the currrently-available federated extensions.
This is expensive, but probably the only way to be sure to get
up-to-date license information for extensions installed interactively.
r
LabServerApp)r appr
isinstanceparentlabextensions_pathextra_labextensions_pathr )selfr per_paths
extensions extensionr s V/var/www/html/myenv/lib/python3.12/site-packages/jupyterlab_server/licenses_handler.pyfederated_extensionsz$LicensesManager.federated_extensions1 sw ) dkk<8 88
KK * * KK 0 0
;D `JU_ ` i `i ` `'(:;; as A4c K t j | j j | j ||| d{ S 7 w)zrAsynchronous wrapper around the potentially slow job of locating
and encoding all of the licenses
report_formatbundles_pattern full_textN)asyncio wrap_futureexecutorsubmitreport)r r& r' r( s r" report_asyncz LicensesManager.report_asyncD sL (( MM + /#
!
s A A AA c | j | }|dk( r| j | dfS |dk( r| j | dfS |dk( r| j || dfS d | d
}t | ) z*create a human- or machine-readable report)r' jsonzapplication/jsoncsvztext/csvmarkdown)r( r zUnsupported report format .)bundles report_json
report_csvreport_markdown
ValueError)r r& r' r( r4 msgs r" r- zLicensesManager.reportS s ,,,? F "##G,.@@ @ E !??7+Z7 7 J &$$W $B
+=/;o c 6 t j d|idd S )z0create a JSON report
TODO: SPDX
r4 T)indent sort_keys)r0 dumps)r r4 s r" r5 zLicensesManager.report_jsonc s zz9g.qDIIr: c
\ t j }g d}t j |dg| }|j |j D ]C \ }}|d D ]6 }|j
d|i|D ci c] }||j |d c} 8 E |j S c c}w )zcreate a CSV report)name versionInfo licenseId
extractedTextbundle)
fieldnamespackages ) ioStringIOr1
DictWriter writeheaderitemswriterowgetgetvalue) r r4 outfilerF writer bundle_namerE packagefields r" r6 zLicensesManager.report_csvi s ++-J
X4K
4KL #*==? K!*-
+FPQU5'++eR"88Q
!! Rs 3B)c @ g }|j D cg c]; \ }}|j dg D ]! }t |j dt # = }}}}|r t | nd}|j D ]
\ }}|d| dgz
}|j dg } | s|ddgz
}-| D ] }|j dt j }
|j dt j } |j dt j } |j d d }
|d
d j
d |
d j | d
| d
j d | g z gz
}|s|
s|g dz
}|ddd|
ddgz
}
dj
| S c c}}}w )zcreate a markdown reportrG rA r
z# rH z> No licenses foundrB rC rD z## z**` )rH z> No license text availablerH zz
)rM rO lenUNKNOWN_PACKAGE_NAMEmaxstripjoinljust)r r4 r( linesrS rE rT
library_names longest_namerG rA version_info
license_idextracted_texts r" r7 z LicensesManager.report_markdowny s (/}}
# V!::j"5
F$89 :
:
.;s=) #*==? R K ;-("- -E zz*b1H/44#
R {{6+?@FFH &{{=:N O U U W $[[6J K Q Q S
!(_b!A $&tfB 1 7 7 E$%l^1 7 = =b A * ) !HH "b(NHb!QQ/
R RB yy Q
s A Fc 4 dg i}g }| j D ]x }||z }| j j d| |j s||gz
}; t j
|j
d } |d j |d z |d s | j j d|| |S # t $ r(}| j j d||| Y d}~d}~ww xY w# t $ r(}| j j d||| Y d}~d}~ww xY w) z2Return the content of a packages's license bundlesrG zLoading licenses from %sutf-8encodingz1Failed to open third-party licenses for %s: %s
%sNz%Failed to find packages for %s: %s
%sz)Third-party licenses not found for %s: %s)
third_party_licenses_fileslogdebugexistsr0 loads read_text Exceptionwarningextend) r pathrE bundle_json
checked_paths license_file
licenses_path file_jsonerrs r" license_bundlez LicensesManager.license_bundle s- ' ,
; ; L < /M HHNN5} E '') - 0
JJ}'>'>'>'P Q
J'..y/DE' : :& HH H&R_ `/
H!
<!
s0 %B25C&2 C#; C C#& D/ DDc P t r ddlm} t | j | sJ t | j j }|dz }|j s#|j dz }|j r|}nyt j |j d d }||fS )zget the static directory for this app
This will usually be in `static_dir`, but may also appear in the
parent of `static_dir`.
r
r z package.json)NNrh ri rA ) r r r r r r
static_dirrn r0 ro rp )r r rt package_jsonparent_package_jsonrA s r" app_static_infoz LicensesManager.app_static_info s ) dkk<8 88DKK**+n, ""$"&++"> "))+ 2 !zz,00'0BCFKTzr: c | j j D ci c]: \ }}t j || r || j t |d | < }}}| j
\ }}|/|J t j || r| j || ||< |s| j j d |S c c}}w )z6Read all of the licenses
TODO: schema
ext_pathz No license bundles found at all) r# rM rematchr{ r r rl rr )r r' rA extr4 app_pathapp_names r" r4 zLicensesManager.bundles s " 6 6 < < >
cxx.
$%%d3z?&;TB B
" 1 1 3( ' ''xx2$($7$7($K! HH > ?
s ?CN)returndict[str, Any])r2 .*F)r& strr' r r( boolr ztuple[str, str])r4 r r r )T)r4 r r( r r r )rt r rE z
str | Noner r )r z tuple[Path | None, str | None])r )r' r r r )__name__
__module__ __qualname____doc__r r+ r
r DEFAULT_THIRD_PARTY_LICENSE_FILErk propertyr# r. r- r5 r6 r7 r{ r r4 r: r" r r ! s "a0H!% ,67 8
M
" < <& _d
@C
W[
J " + Z%N*r: r c f e Zd ZdZd fd Zej dd Z d fd Z xZ S )LicensesHandlerz6A handler for serving licenses used by the applicationc 0 t | || _ y)zInitialize the handler.N)super
initializemanager)r r __class__s r" r zLicensesHandler.initialize s
r: c K t t j | j dd }| j dd }| j dd }t t j | j dd }| j j ||| d
{ \ }}t r(d d lm} t | j j | sJ |rbd
j | j j j j t j | } | j! | | j# | | j% | d
{ y
7 7 w)z Return all the frontend licensesr( trueformatr0 r4 r download0r% Nr
r z
{}-licenses{})
_mime_type)r r0 ro get_argumentr r. r r r r r r r lower mimetypesguess_extensionset_attachment_headerwritefinish)
r _argsr( r& r' r r- mimer filenames
r" rO zLicensesHandler.get s1 D$5$5k6$JKL ))(F;
++It<
4#4#4Z#EFG !\\ 6 6' + 7
) dll 1 1<@ @@ &-- ##,,224i6O6OPT6UH
& &x 0
6kkTk***#
" +s% B"E.$E*%B?E.$E,%E.,E.c K | j | j d| t t | |i | d{ S 7 w)z>Overload the regular finish, which (sensibly) always sets JSONz Content-TypeN)update_api_activity
set_headerr r r )r r argskwargsr s r" r zLicensesHandler.finish s@
"
3:t3TDVDDDDs 9AAA)r r r None)r r r r )r r r r r r r r )
r r r r r r
authenticatedrO r
__classcell__)r s @r" r r sU @
+ +4E E&)E58E E Er: r )!r
__future__r r) r1 rI r0 r r concurrent.futuresr pathlibr typingr r jupyter_server.base.handlersr tornador traitletsr
r traitlets.configr configr r r\ r add_typer r r r: r" r s 9 #
1 % 3 # 0 , $? 9 _-5I.T) Tn)Ej )Er: