^hXSrSSKJr SSKrSSKrSSKrSSKJr SSKJ r SSK J r SSK J r Jr SS KJr SS KJr SS KJrJrJr SS KJr SS KJrJr 0r\"5r/SQrSrSr S$Sjr!S%Sjr"S&Sjr#Sr$Sr%Sr&Sr'"SS\5r(Sr)S%SSS.S'Sjjjr*S(Sjr+Sr,SSSSSS\\4S)S jjr-S*S!jr.S+S"jr/S,S#jr0g)-zNotebook format validators.) annotationsN)deepcopy)Path)dedent)AnyOptional) import_item)generate_corpus_id)ValidationError_validator_for_nameget_current_validator) get_version)DuplicateCellIdMissingIDFieldWarning)r get_validatorisvalidNotebookValidationErrorbetter_validation_error normalizevalidate iter_validatec[U[5(a2UR5HupUS:XaSO [U5nX U'M U$[U[5(a![ U5Hup2[U5X'M U$)z relax any `additionalProperties`additionalPropertiesT) isinstancedictitems_relax_additional_propertieslist enumerate)objkeyvalueis L/home/james-whalen/.local/lib/python3.13/site-packages/nbformat/validator.pyrr%sz#t))+JC55;WX];^ H & J C  !#HA1%8CF' JcvUSSSRSS05 USSSRSS05 U$)N definitionscelloneOf$refz#/definitions/unrecognized_celloutputz!#/definitions/unrecognized_output)append)schemas r%_allow_undefinedr/3sM =&!'*116;\2]^ =(#G,33V=`4ab Mr&FcUcSSKJn Un[SU-5n[USS5nUcUnU(a [ U5O [ 5nUR X4nU[;a5[XPUS9n Xa:a[U 5n [U 5n U"U 5[U'U(a%[XPUS9n [U 5n U"U 5[U'[U$![a gf=f![a gf=f)z%Load the JSON schema into a ValidatorNr )current_nbformatz nbformat.v%snbformat_minorrversion version_minor) r1r getattrr rname validators_get_schema_jsonAttributeErrorrr/) r4r5relax_add_propsr8r1v current_minorcurrent_validator version_tuple schema_jsons r%rr9s&"NW,-AA/3M% 59+D1?T?V&++WDMJ& *1][K  (6{CK*;7K$5k$B =! *1][K 3;? $5k$B =! m $$-    s$! C  C CC C'&C'cX4UR;a:[[UR5RURX4- 5nOUX R :a9[[UR5RURS- 5nO Sn[ U5e[U5RSS9n[R"U5nSSS5 U$!,(df  W$=f)zJ Gets the json schema from a given imported library and nbformat version. NNz-Cannot find appropriate nbformat schema file.utf8)encodingN) nbformat_schemastrr__file__parentr2r;openjsonload)r=r4r5 schema_pathmsgfrAs r%r:r:es 1#4#44$qzz*11A4E4EwF^4__` )) )$qzz*11A4E4El4SST =S!! k     0Aiil  1  1 0 s 9C C)c b[U5n[R"5 [R"S[S9 [R"S[ S9 [ XX#SS9 SSS5 X:wa[eg!,(df  N=f![a X:wa[egf=f!X:wa[ef=f)zChecks whether the given notebook JSON conforms to the current notebook format schema. Returns True if the JSON is valid, and False otherwise. To see the individual errors that were encountered, please use the `validate` function instead. ignore)categoryF)repair_duplicate_cell_idsNT) rwarningscatch_warningsfilterwarningsDeprecationWarningrrAssertionErrorr )nbjsonrefr4r5origs r%rrvs F D !  $ $ &  # #H7I J  # #H7L M V'TY Z' >  ' &  >    >  s:B>A5 B5 B?B BB!BB!! B.cHU(dgSSRSU55-$)z (from jsonschema._utils.format_as_index, copied to avoid relying on private API) Construct a single string containing indexing operations for the indices. For example, [1, 2, "foo"] -> [1][2]["foo"] r6z[%s]z][c38# UHn[U5v M g7fN)repr).0indexs r% #_format_as_index..s?wed5kkws)join)indicess r%_format_as_indexrfs$  DII?w?? ??r&@cP[U[5(a[UR55S[VVs0sHupU[ U5_M nnn[UR S5[5(aS[US5-/US'[UR S5[5(aS[US5-/US'[U5[:aS[U5[- -US'U$[U[5(a[US[Vs/sHn[ U5PM nn[U5[:a$URS[U5[- -5 U$[U[5(a#US[n[U5[:aUS- nU$U$s snnfs snf) z~Truncate objects for use in validation tracebacks Cell and output lists are squashed, as are long strings, lists, and dicts. Ncellsz...%i cells...outputsz...%i outputs...z%i keys truncatedz...z...%i items truncated...) rrrr _ITEM_LIMIT _truncate_objgetlenr-rG _STR_LIMIT)r!kr=truncated_dictitemtruncated_list truncated_strs r%rmrmsy #t:>syy{:KL[:YZ:Y$!!]1--:YZ n((14 8 8'7#c'l:K'K&LN7 # n((3T : :);c#i.>Q)Q(RN9 % s8k !$73s8k;Q$RN5 !#t:=l{:KL:K$--:KL s8k !  ! !"<C;@V"W X#sKZ( s8j U "M J'[Ms FF#c2\rSrSrSrSSjrSrSr\rSr g) rz[Schema ValidationError with truncated representation to avoid massive verbose tracebacks. Nc~Xl[URSU5UlURRUlg)zInitialize the error class.rZN)originalr7rZmessage)selfryrZs r%__init__ NotebookValidationError.__init__s, 4==%5}},, r&c.[URU5$)z Get an attribute from the error.)r7ry)r{r"s r% __getattr__#NotebookValidationError.__getattr__st}}c**r&c rURn[UR5nSRURSSR UR UR=(d S[[UR5SS55SS[UR5-[R"USS 9/5$) zRCustom str for validation errors avoids dumping full schema and notebook to logs  r6zFailed validating {!r} in {}{}:notebookNzOn instance%s:N)width)ryrminstancerdrzformat validatorrZrfrrelative_schema_path relative_pathpprintpformat)r{errorrs r% __unicode__#NotebookValidationError.__unicode__s   0yy 188OOHH* $T%*D*D%Ecr%JK  #3E4G4G#HHxr2   r&)rzryrZr^) __name__ __module__ __qualname____firstlineno____doc__r|rr__str____static_attributes__r&r%rrs - + .Gr&rc[UR5(dU$URSnSnURS5(a[UR[ 5(aBSUR;aURSS-nOSUR;aURSnU(a[ URUUUS9 [X5$![aanURRUR5 URUl[XQU5nURcXFl UsSnA$SnAf[a Nf=f)zGet better ValidationError on oneOf failures oneOf errors aren't informative. if it's a cell type or output_type error, try validating directly based on the type for a better error message rNOf cell_type_cell output_typer3)rorMendswithrrrrr rextendrrZ Exceptionr)rr4r5r"rZ sub_errorbetters r%rrs u  ! !   B C C ||D ennd + +enn,nn[1G;%..0nn]3  NN#"/ $ #5 ..# ##**9+B+BC*/*=*= '0]S::%!$J   s%-C EAD4.E4 EEr<strip_invalid_metadatac b[U5n[U5upVUcUnUcUn[UUUSUUS9$)a4 Normalise a notebook prior to validation. This tries to implement a couple of normalisation steps to standardise notebooks and make validation easier. You should in general not rely on this function and make sure the notebooks that reach nbformat are already in a normal form. If not you likely have a bug, and may have security issues. Parameters ---------- nbdict : dict notebook document version : int version_minor : int relax_add_props : bool Whether to allow extra property in the Json schema validating the notebook. strip_invalid_metadata : bool Whether to strip metadata that does not exist in the Json schema when validating the notebook. Returns ------- changes : int number of changes in the notebooks notebook : dict deep-copy of the original object with relevant changes. Tr)rr _normalize)nbdictr4r5r<rnbdict_versionnbdict_version_minors r%rrsPNf F+6v+>(N ,  '5  r&cSnX4S:aUSH@nSU;dM [R"S[SS9 U(dM.[5US'US- nMB [ 5nUSHunSU;aM USn X;aOU(a7[5n XS'US- n[R"S U <S U <S 3[ SS9 OS U S 3n [ U 5eURU 5 Mw U(a U[XX$S9- nX`4$)ar Private normalisation routine. This function attempts to normalize the `nbdict` passed to it. As `_normalize()` is currently used both in `validate()` (for historical reasons), and in the `normalize()` public function, `_normalize()` does currently mutate `nbdict`. Ideally, once `validate()` stops calling `_normalize()`, `_normalize()` may stop mutating `nbdict`. r)rjida)Cell is missing an id field, this will become a hard error in future nbformat versions. You may want to use `normalize()` on your notebooks before validations (available since nbformat 5.1.4). Previous versions of nbformat are fixing this issue transparently, and will stop doing so in the future. stacklevelr zNon-unique cell id z detected. Corrected to .zNon-unique cell id 'z ' detected.r<) rTwarnrr setrr add_strip_invalida_metadata) rr4r5rSr<rchangesr)seen_idscell_idnew_idrNs r%rrEs!(G6)7OD4 & *  -,!3!5DJqLG$$57OD44jG",/1F!'JqLGMM-g[8PQWPZZ[\'#$ 1 EC)#.. LL !%$&+ ]   ?r&cR[R"[SUS35[SS9 g)N`a7` kwargs of validate has been deprecated for security reasons, and will be removed soon. Please explicitly use the `n_changes, new_notebook = nbformat.validator.normalize(old_notebook, ...)` if you wish to normalise your notebook. `normalize` is available since nbformat 5.5.0 rr)rTrrrW)fields r% _dep_warnrs/ MM%     r&c [U[5(dUbeU[LaSnO [S5 U[LaSnO [S5 UbOUbUnO Sn[ U5eUc[ U5upUcU nUcU nOUcSup#Uc<[U[ 5(de[U[ 5(de[UUUUUUS9 [UUUUUUS 9Hn U e g) a!Checks whether the given notebook dict-like object conforms to the relevant notebook format schema. Parameters ---------- nbdict : dict notebook document ref : optional, str reference to the subset of the schema we want to validate against. for example ``"markdown_cell"``, `"code_cell"` .... version : int version_minor : int relax_add_props : bool Whether to allow extra properties in the JSON schema validating the notebook. When True, all known fields are validated, but unknown fields are ignored. nbjson repair_duplicate_cell_ids : bool Deprecated since 5.5.0 - will be removed in the future. strip_invalid_metadata : bool Deprecated since 5.5.0 - will be removed in the future. Returns ------- None Raises ------ ValidationError if not valid. Notes ----- Prior to Nbformat 5.5.0 the `validate` and `isvalid` method would silently try to fix invalid notebook and mutate arguments. This behavior is deprecated and will be removed in a near future. Please explicitly call `normalize` if you need to normalize notebooks. NFrTrSz0validate() missing 1 required argument: 'nbdict')r rr)rZr4r5r<r) rrG _deprecatedr TypeErrorrintrr) rrZr4r5r<rYrSrrNrrrs r%rrs^ c3  3;. .,!&*+ K/$(!-.  @n {/:6/B, ?$G  0M !% {'3''''-----    %+#9   #'5  r&c[XUS9nU(dSUSUS3n[U5eUR"U/UQ76n[U5n[ U5(a/UR S:wa[UUUSS9nUR"U/UQ76$[ U5$)NrzNo schema for validating vr notebooks jsonschemar4r5r<r8)rr iter_errorsrror8iter) rr4r5r<argsrrNrerrorss r% _get_errorsrsgoVI *7)1]O:Nc""''66K + F 6{{y~~5!'+  $$V3d33 <r&c[XX#5nSn[[U55S:Ga[UUUSS9nU(dSUSUS3n[ U5eUR U5nUR U5nSU;a&USHn USRU S5 US - nM S U;Ga;[URS S55n [U 5GHn S US U R;dMUS U S n US U RS RS V s/sHn U S PM nn SU S3nX;dMiURU5nUS U RS RHsnURnURSU:Hn[U5S:H=(a USS:HnU(dMGU(dMPUS U SRUS S5 US - nMu GM U$s sn f)a This function tries to extract metadata errors from the validator and fix them if necessary. This mostly mean stripping unknown keys from metadata fields, or removing metadata fields altogether. Parameters ---------- nbdict : dict notebook document version : int version_minor : int relax_add_props : bool Whether to allow extra property in the Json schema validating the notebook. Returns ------- int number of modifications rrrzNo jsonschema for validating vrrmetadataNr rjr*rr+z#/definitions/r)rrorrr r error_treepoprnrangerr.racontextrrM)rr4r5r<rrrrNrr"number_of_cellscell_idxintended_cell_typerZschemas_by_indexcell_type_definition_name schema_indexrrel_patherror_for_intended_schemais_top_level_metadata_keys r%rrs20- IFG 4<1!'+  27)1]O:VC!#& &&&v.))&1  #!*-z"&&sD11 . j !&**Wa"89O!/2 j1(;BBB)/)B;)O&$.g#6x#@#G#G#P#W#WX_#`(#`CF #`%(3AAS@TTY0Z-0D'7'='=>W'X %/%8%B%I%I'%R%Z%ZE',':':H8=8I8I!8LP\8\5 #H  2 Px{j7P6 98=V=V &w 9* E I I(ST+W[ \ '1 &[30 N#(sG!c #n# UbOUbUnO Sn[U5eUc [U5up#U(a[UUUUSSU-05nO U(a [ XX45 [XX45nUHn [ XU5v M g![an U v Sn A gSn A ff=f![an U v Sn A gSn A ff=f7f)aXChecks whether the given notebook dict-like object conforms to the relevant notebook format schema. Returns a generator of all ValidationErrors if not valid. Notes ----- To fix: For security reasons, this function should *never* mutate its `nbdict` argument, and should *never* try to validate a mutated or modified version of its notebook. Nz5iter_validate() missing 1 required argument: 'nbdict'r+z#/definitions/%s)rrrr rr) rrZr4r5r<rYrrNrers r%rr^s*  En!,V!4   +c12 F " $Vm U   -QF %emDD% G   G  sX/B5A?B5 B'B5? B B B5BB5 B2$B-(B5-B22B5)NNFNrC)NNN) rrr4 Optional[int]r5rr<boolrrreturntuple[int, Any])rrr4rr5rrSrr<rrrrr)rrrZz Optional[str]r4rr5rr<rrYrrSrrrrNone) rrr4rr5rr<rrrrr) rrr4rr5rr<rrr)NNNNFNF)1r __future__rrKrrTcopyrpathlibrtextwraprtypingrr_importsr corpus.wordsr json_compatr r rreaderrrrr9objectr__all__rr/rr:rrfrlrprmrrrrrrrrrrr&r%rs9!#  !,TT<  h    )%X"!. @  8'o'T&/V"#'4 "#( 4 4 4!4  4 ! 44nB B BB $ B  B ! BBJ "!#'!&1#.c c cc! c  c  c $c!c cL .1DHQT*F FF.1FDHFFT    <Er&