rh4%SrSSKJr SSKJr SSKrSSKrSSKrSSK J r SSK J r SSK J r SSK Jr SS K Jr SS KJr \R$(a SS KJr SS K Jr SSS .rS\S'SrS!SjrS"SS.S#SjjjrSSSSSS.S$SjjrSrS%SSS.S&SjjjrS'SjrS(SjrSr S)Sjr!Sr"\#S :XaSSK r \ RH"5 gg)*a The manager module handles requests across multiple corpora. It should be the default interface to searching corpora. New in v3 -- previously most were static methods on corpus.corpora.Corpus, but that seemed inappropriate since these work across corpora. ) annotations)IterableN)common) converter)CorpusException) environment)metadata)corpora)bundles)stream)corelocalz(dict[str, bundles.MetadataBundle | None]_metadataBundlescUS:Xa[R"5$US:Xa[R"5$[R"US9$)a Instantiate a specific corpus based on `name`: >>> corpus.manager.fromName('core') >>> corpus.manager.fromName('local') >>> corpus.manager.fromName(None) Note that this corpus probably does not exist on disk, but it's ready to have paths added to it and to be stored on disk. >>> corpus.manager.fromName('testDummy') r rname)r CoreCorpus LocalCorpusrs P/home/james-whalen/.local/lib/python3.13/site-packages/music21/corpus/manager.pyfromNamer2sC. v~!!## ""$$""--c## USLaA[R"5v [5Hn[R"U5v M g[R"5Rv [5HnUcSv M Uv M g7f)a a generator that iterates over the corpora (either as objects or as names) for use in pan corpus searching. This test will only show the first two, because it needs to run the same on every system: >>> for i, corpusObject in enumerate(corpus.manager.iterateCorpora()): ... print(corpusObject) ... if i == 1: ... break We can also get names instead. (Note that the name of the main local corpus is `"local"` not `None`) >>> for i, corpusName in enumerate(corpus.manager.iterateCorpora(returnObjects=False)): ... print(corpusName) ... if i == 1: ... break core local * New in v3. TNr)r rlistLocalCorporaNamesrr) returnObjectscns riterateCorporarSso6  ""')B%%b) )*  "'''')Bz  *sBB fileExtensionscSn[U5nUnU(d [S5eURS5(dURS5(a'[RR U5SS-nSnSn[ 5HGnURUUUS 9nU(d!U(aURUUUS 9nU(dM<U(dMEUn O Uc,S n U(aU S - n U S US 3- n U S- n U S- n [U 5e[U5S:Xa[R"US5$UV s/sHn [R"U 5PM sn $s sn f)z this parse function is called from `corpus.parse()` and does nothing differently from it. Searches all corpora for a file that matches the name and returns it parsed. Fz+a work name must be provided as an argumentz.xmlz .musicxmlrz.mxlTNrzCould not find azn xml, musicxml, or mxlz work that met this criterion: ;z* if you are searching for a file on disk, z$use "converter" instead of "corpus".) strrendswithospathsplitextr getWorkListlenpathlibPath) workNamemovementNumberr addXMLWarningworkNameJoined mxlWorkName filePaths corpusObjectworkListwarningMessageps rgetWorkr6}scM]N K KLLv&&.*A*A+*N*Ngg&&~6q9FB  I&( ++H,:;I,KM#// 0>?M0OH 8 I )+  7 7N;H:QGGFF@@n-- 9~||IaL)))23A Q333s' E F)r-numberr forceSourceformatc[UUUS9n[U[5(aUSnOUn[R"UUUUS9n[ X5 U$)N)r,r-rr)r8r7r9)r6 isinstancelistrparse _addCorpusFilePathToStreamObject) r,r-r7rr8r9r1filePath streamObjects rr=r=s^%%I )T""Q<?? L %\< rc[[R"55n[U5[[R 5-n[U5nUR U5(aEXSnUR[R 5nSRU5nX`Rl OXRl [UR[5(aURRUl gg)z Adds an entry 'corpusFilePpath' to the Stream object. TODO: this should work for non-core-corpora TODO: this should be in the metadata object TODO: this should set a pathlib.Path object N/)r#rgetCorpusFilePathr)r%sep startswithsplitjoinr corpusFilePathr;idint) streamObjr?rHlenCFPfp2dirsEtcfp3s rr>r>s1134N  3rvv; .F8}H>**w))BFF#hhw,/),4)),,$$ ))88 %r) corpusNamesrc :[U[5(aU4n[5 [RR 5nUc[ [SS95nUH?n[U5nURR"UU4SU0UD6nURU5nMA U$)a Search all stored metadata bundles and return a list of file paths. This function uses stored metadata and thus, on first usage, will incur a performance penalty during metadata loading. >>> #_DOCS_SHOW corpus.search('china') >>> corpus.search('china', corpusNames=('core',)) #_DOCS_HIDE >>> #_DOCS_SHOW corpus.search('china', fileExtensions=('.mid',)) >>> corpus.search('china', fileExtensions=('.mid',), corpusNames=('core',)) #_DOCS_HIDE >>> #_DOCS_SHOW corpus.search('bach', field='composer') >>> corpus.search('bach', field='composer', corpusNames=('core',)) #_DOCS_HIDE Note the importance of good metadata -- there's almost 400 pieces by Bach in the corpus, but many do not have correct metadata entries. This can also be specified as: >>> #_DOCS_SHOW corpus.search(composer='bach') >>> corpus.search(composer='bach', corpusNames=('core',)) #_DOCS_HIDE Or, to get all the chorales (without using `corpus.chorales.Iterator`): >>> #_DOCS_SHOW corpus.search(sourcePath='bach', numberOfParts=4) >>> corpus.search(sourcePath='bach', numberOfParts=4, corpusNames=('core',)) #_DOCS_HIDE This function is implemented in `corpus.manager` as a method there but also directly available in the corpus module for ease of use. The ``corpusNames`` parameter can be used to specify which corpora to search, for example: >>> corpus.manager.search( ... 'bach', ... corpusNames=('core',), ... ) >>> corpus.manager.search( ... 'bach', ... corpusNames=('core',), ... fileExtensions=('xml',), ... ) If ``corpusNames`` is None, all corpora known to music21 will be searched. See usersGuide (chapter 11) for more information on searching F)rr) r;r#readAllMetadataBundlesFromDiskr r MetadataBundler<rrmetadataBundlesearchunion) queryfieldrPrkeywordsallSearchResults corpusNamec searchResultss rrUrUsH.#&&(*"$''668>>? ! Z ((//   *   ,11-@" rc[U5 URnU[;a%[Un[R(aUceU$[ SR X55e)a Return the metadata bundle for a single Corpus object >>> cc = corpus.corpora.CoreCorpus() >>> mdb1 = corpus.manager.getMetadataBundleByCorpus(cc) >>> mdb1 This is the same as calling `metadataBundle` on the corpus itself, but this is the routine that actually does the work. In other words, it's the call on the object that is redundant, not this routine. >>> mdb1 is cc.metadataBundle True Non-existent corpus: >>> lc = corpus.corpora.LocalCorpus('junk') >>> mdb1 = corpus.manager.getMetadataBundleByCorpus(lc) >>> mdb1 z5No metadata bundle found for corpus {0} with name {1})cacheMetadataBundleFromDiskrrt TYPE_CHECKINGrr9)r2r[mdbs rgetMetadataBundleByCorpusrcHs^. -""J%%z* ??? "? U\\ &' 'rcURnU[;d [UcI[RR U5nUR 5 UR 5 U[U'gg)zE Update a corpus' metadata bundle from its stored JSON file on disk. N)rrr r rSreadvalidate)r2r[rTs rr_r_ksa""J** +3!))88D!'5$ 4rc<[5Hn[U5 M g)z< Read each corpus's metadata bundle and store it in memory. N)rr_)r2s rrRrRws'( #L1)rc[R"5nU(dS/nO/nURUSR55 U$)zk List the names of all user-defined local corpora. The entry for None refers to the default local corpus. NlocalCorporaSettings)r UserSettingsextendkeys)skipNone userSettingsresults rrrsA ++-L  MM,56;;=> MrcR[RRR5$)a List all available search field names: >>> for field in corpus.manager.listSearchFields(): ... field ... 'abstract' 'accessRights' 'accompanyingMaterialWriter' ... 'composer' 'composerAlias' 'composerCorporate' 'conceptor' 'conductor' ... 'dateCreated' 'dateFirstPublished' 'dateIssued' 'dateModified' 'dateSubmitted' 'dateValid' ... 'tempoFirst' 'tempos' 'textLanguage' 'textOriginalLanguage' 'timeSignatureFirst' 'timeSignatures' 'title' ... )r r rSlistSearchFieldsrrrrqrqs B    * * ; ; ==r__main__)T)N)r,str | pathlib.Pathr- int | Noner Iterable[str]returnz!pathlib.Path | list[pathlib.Path])r,rsr-rtr7rtrrur8boolr9 str | Nonervz(stream.Score | stream.Part | stream.Opus)NN)rWrxrXrxrzIterable[str] | str)r2corpora.Corpusrvzbundles.MetadataBundle)r2ryrvNone)F)%__doc__ __future__rcollections.abcrr*r%typingr`music21rrmusic21.exceptions21rrr music21.corpusr ramusic21.metadatar r r__annotations__rrr6r=r>rUrcr_rRrrq__name__mainTestrrrrsk#$ 0"??(  <8.B'X $24%' 242424" 24 % 24t $$&   "    *:9<W(* W W W & Wt 'F 62 !>L z r