^h!) , S r SSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK J
r
SSK J r SSK
JrJr SSKJr SSKJr SS KJrJr SS
KJr S S KJr S
rSr \R: " S5 c \R< " SS5 " S S\5 r " S S\5 r g)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 \ rS rSrSr\" SS9r\" \" 5 \ S\ 3/SS9r
\ SS j5 r S SS jjr
SS
jrSS jrSS jrSSS
jjrSS jrSS jrSS S jjrSrg) LicensesManager! zxA 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 [ ( a# SSKJn [ U R U5 ( d eU R R
U R R /nU VVs/ s H
o3 H oDPM M nnn[ U5 $ s snnf )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 \/home/james-whalen/.local/lib/python3.13/site-packages/jupyterlab_server/licenses_handler.pyfederated_extensions$LicensesManager.federated_extensions1 sz = ) dkk<88 88
KK * * KK 0 0
;D `)JU_ iU_i) `'(:;; as Bc # [ R " U R R U R UUUS95 I Sh vN $ N7f)zbAsynchronous 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_async LicensesManager.report_asyncD sK (( MM + /#
!
s >A AAc U R US9nUS:X a U R U5 S4$ US:X a U R U5 S4$ US:X a U R XCS9S4$ S U S
3n[ U5 e) 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* r7 msgs r# r/ LicensesManager.reportS s ,,,? F "##G,.@@ @ E !??7+Z7 7 J &$$W$B
+=/;o c 2 [ R " SU0SSS9$ )z create a JSON report
TODO: SPDX
r7 T)indent sort_keys)r3 dumps)r r7 s r# r8 LicensesManager.report_jsonc s zz9g.qDIIr> c
d [ R " 5 n/ SQn[ R " US/UQS9nUR 5 UR 5 HG u pVUS H9 nUR
SU0U Vs0 s H oUR US5 _M snE5 M; MI UR 5 $ s snf )zcreate a CSV report)name versionInfo licenseId
extractedTextbundle)
fieldnamespackages ) ioStringIOr4
DictWriter writeheaderitemswriterowgetgetvalue) r r7 outfilerK writer bundle_namerJ packagefields r# r9 LicensesManager.report_csvi s ++-J
X4K
4KL #*==? K!*- +FPQjU'++eR"88jQ . $3 !! Rs 1 B-c ~ / nUR 5 VVVs/ s H> u pEUR S/ 5 H" n[ UR S[ 5 5 PM$ M@ nnnnU( a [ U5 OSnUR 5 GH u pEUSU 3S/-
nUR S/ 5 n U ( d USS/-
nM2 U H nUR S[ 5 R 5 n
UR S[ 5 R 5 n UR S[ 5 R 5 n UR S S5 n
US
S R
S U
S 3R U5 S
U S
3R S5 U /5 - /-
nU( d M U
( d U/ SQ-
nM USSSU
SS/-
nM GM! SR
U5 $ s snnnf )zcreate a markdown reportrL rF r
z# rM z> No licenses foundrG rH rI z## z**` )rM z> No license text availablerM zz
)rR rT lenUNKNOWN_PACKAGE_NAMEmaxstripjoinljust)r r7 r* linesrX rJ rY
library_names longest_namerL rF version_info
license_idextracted_texts r# r: LicensesManager.report_markdowny s (/}}
'6# !::j"5
F$89 :5
;'6
.;s=) #*==? K ;-("- -E zz*b1H/44# {{6+?@FFH &{{=:N O U U W $[[6J K Q Q S
!(_b!A $&tfB 1 7 7 E$%l^1 7 = =b A * 9) !HH "b(NHb!QQ/ $ $3B yy Q
s AF8c N S/ 0n/ nU R H{ nX- nU R R SU5 UR 5 ( d XF/-
nM? [ R
" UR
SS95 n US R US 5 M} US ( d U R R SX$5 U$ ! [ a) nU R R SUUU5 SnAM SnAff = f! [ a* nU R R SUUU5 SnAGM SnAff = f) z2Return the content of a packages's license bundlesrL 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_fileslogdebugexistsr3 loads read_text Exceptionwarningextend) r pathrJ bundle_json
checked_paths license_file
licenses_path file_jsonerrs r# license_bundle LicensesManager.license_bundle s$ ' ,
; ;L /M HHNN5} E '')) 0
JJ}'>'>'>'P Q
J'..y/DE' <: :& HH H& `/
H!
<!
s0 #B:7C0:
C- C((C-0
D$: D D$c r [ ( a# SSKJn [ U R U5 ( d e[ U R R 5 nUS- nUR 5 ( d( UR S- nUR 5 ( a UnOg[ R " UR SS95 S nX%4$ )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)NNro rp rF ) r r r r r r
static_dirru r3 rv rw )r r r{ package_jsonparent_package_jsonrF s r# app_static_info LicensesManager.app_static_info s = ) dkk<88 88DKK**+n, ""$$"&++"> "))++ 2 !zz,00'0BCFKzr> c U R R 5 VVs0 s H@ u p#[ R " X5 ( d M" X R [ US 5 U5 _MB nnnU R
5 u pVUb3 Uc e[ R " X5 ( a U R XV5 XF' U( d U R R S5 U$ s snnf )z&Read all of the licenses
TODO: schema
ext_pathz No license bundles found at all) r$ rR rematchr r r rs ry )r r) rF extr7 app_pathapp_names r# r7 LicensesManager.bundles s " 6 6 < < >
> xx.
CD%%d3z?&;TB B >
" 1 1 3 ' ''xx22$($7$7$K! HH > ?
s !C"C N)returndict[str, Any])r5 .*F)r( strr) r r* boolr ztuple[str, str])r7 r r r )T)r7 r r* r r r )r{ r rJ z
str | Noner r )r z tuple[Path | None, str | None])r )r) r r r )__name__
__module__ __qualname____firstlineno____doc__r r- r
r DEFAULT_THIRD_PARTY_LICENSE_FILErr propertyr$ r0 r/ r8 r9 r: r r r7 __static_attributes__r r> r# r r ! s "a0H!% ,67 8
M
" < <& _d
@C
W[
J " + Z%N* r> r c x ^ \ rS rSrSrSU 4S jjr\R SS j5 r S U 4S jjr Sr
U =r $ )
LicensesHandler z6A handler for serving licenses used by the applicationc . > [ TU ] 5 Xl g)zInitialize the handler.N)super
initializemanager)r r __class__s r# r LicensesHandler.initialize s
r> c # [ [ R " U R SS5 5 5 nU R SS5 nU R SS5 n[ [ R " U R SS5 5 5 nU R R UUUS 9I S
h vN u pg[ ( a- S S KJn [ U R R U5 ( d eU( ac S
R U R R R R 5 [ R " U5 5 n U R! U 5 U R# U5 U R% US9I S
h vN g
N N7f)z Return all the frontend licensesr* trueformatr3 r7 r download0r' Nr
r z
{}-licenses{})
_mime_type)r r3 rv get_argumentr r0 r r r r r r r lower mimetypesguess_extensionset_attachment_headerwritefinish)
r _argsr* r( r) r r/ mimer filenames
r# rT LicensesHandler.get s2 D$5$5k6$JKL ))(F;
++It<
4#4#4Z#EFG !\\ 6 6' + 7
= ) dll 1 1<@@ @@ &-- ##,,224i6O6OPT6UH
& &x 0
6kkTk***#
" +s% B!E9#E5$C E9/E70E97E9c ># U R 5 U R SU5 [ [ U ] " U0 UD6I Sh vN $ N7f)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 LicensesHandler.finish s?
"
3:t3TDVDDDDs :AAA)r )r r r None)r r r r )r r r r r r r r ) r r r r r r r
authenticatedrT r r
__classcell__)r s @r# r r sU @
+ +4E E&)E58E E Er> r )!r
__future__r r+ r4 rN r3 r r concurrent.futuresr pathlibr typingr r jupyter_server.base.handlersr tornador traitletsr
r traitlets.configr configr r rb r add_typer r r r> r# r s 9 #
1 % 3 # 0 , $? _-5
.T) Tn)Ej )Er>