rh)SrSSKJr /SQrSSKJr SSKrSSKr\R(aSSK J r /SQr /SQr /S QrSS jrS r\SS j5rS rSrSr\S:XaSSKr\R."5 gg)zQ Utilities for working with file formats. almost everything here is deprecated. ) annotations) findSubConverterForFormat findFormatfindInputExtensionfindFormatFilefindFormatExtFilefindFormatExtURLVALID_SHOW_FORMATSVALID_WRITE_FORMATSVALID_AUTO_DOWNLOAD)cacheN) SubConverter)musicxmllilypondtexttextlinemidipngpdfsvglily.pdflily.pnglily.svgbraillevexflow vexflow.html vexflow.jsipython ipython.png ipython.midi musicxml.png musicxml.pdf)rrrrrrrrrrrrrrrrrr r!r"rntxt)askdenyallowcUR5R5nSSKJn UR 5R 5nUHnUR nX;dMUs $ g)ab return a converter.subConverter.SubConverter subclass for a given format -- this is a music21 format name, not a file extension. Or returns None >>> common.findSubConverterForFormat('musicxml') >>> common.findSubConverterForFormat('text') >>> common.findSubConverterForFormat('romantext') Some subConverters have format aliases >>> common.findSubConverterForFormat('t') r converterN)lowerstripmusic21r) ConvertersubConvertersListregisterFormats)fmtr)sclscformatss P/home/james-whalen/.local/lib/python3.13/site-packages/music21/common/formats.pyrr<sV* ))+   C!     1 1 3C$$ >I c"SSKJn UR5nURU5nUcgUR 5nXCnUR (aSUR S-nX64$UR (aSUR S-nX64$SnX64$)a Given a format defined either by a format name, abbreviation, or an extension, return the regularized format name as well as the output extensions. DEPRECATED May 2014 -- moving to converter All but the first element of the tuple are deprecated for use, since the extension can vary by subConverter (e.g., lily.png) >>> common.findFormat('.mxl') ('musicxml', '.musicxml') >>> common.findFormat('musicxml') ('musicxml', '.musicxml') >>> common.findFormat('lily') ('lilypond', '.ly') >>> common.findFormat('lily.png') ('lilypond', '.ly') >>> common.findFormat('humdrum') ('humdrum', '.krn') >>> common.findFormat('txt') ('text', '.txt') >>> common.findFormat('textline') ('textline', '.txt') >>> common.findFormat('midi') ('midi', '.mid') >>> common.findFormat('abc') ('abc', '.abc') >>> common.findFormat('scl') ('scala', '.scl') >>> common.findFormat('braille') ('braille', '.txt') >>> common.findFormat('vexflow') ('vexflow', '.html') >>> common.findFormat('capx') ('capella', '.capx') Works the same whether you have a leading dot or not: >>> common.findFormat('md') ('musedata', '.md') >>> common.findFormat('.md') ('musedata', '.md') If you give something we can't deal with, returns a Tuple of None, None: >>> common.findFormat('wpd') (None, None) These don't work but should eventually: # >>> common.findFormat('png') # ('musicxml.png', '.png') # >>> common.findFormat('ipython') # ('ipython', '.png') # >>> common.findFormat('ipython.png') # ('ipython', '.png') # >>> common.findFormat('musicxml.png') # ('musicxml.png', '.png') rr(NNN.)r,r)r-regularizeFormatgetSubConverterFormatsregisterOutputExtensionsregisterInputExtensions)r0r)c fileFormatscfr2 firstOutputs r4rr\sH"A##C(J " " $C B ""B77::  "" # #B66q99   ""  ""r5c`SSKJn UR5R5nUR S5(aUSSn[ U5nUc/nUR 5R5HgnXR;aMURH/nUR S5(dSU-nURU5 M1 U(dM\[U5s $ [U5$/nURH/nUR S5(dSU-nURU5 M1 [U5$)a Will be fully deprecated when there's an exact equivalent in converter. Given an input format or music21 format, find and return all possible input extensions. >>> a = common.findInputExtension('musicxml') >>> a ('.xml', '.mxl', '.musicxml') >>> a = common.findInputExtension('humdrum') >>> a ('.krn',) >>> common.findInputExtension('musedata') ('.md', '.musedata', '.zip') Leading dots don't matter: >>> common.findInputExtension('.mxl') ('.xml', '.mxl', '.musicxml') Blah is not a format >>> common.findInputExtension('blah') () rr(r8N) r,r)r*r+ startswithrr-r.r<appendtuple)r0r)r2postexts r4rrs 6" ))+   C ~~c!"g "3 'B z%%'99;B44411~~c**)C C 2tT{"<T{--C>>#&&Ci KK .T{r5c[U[R5(d[R"U5n[UR5upU$)a Given a file path (relative or absolute) return the format DEPRECATED May 2014 -- moving to converter >>> common.findFormatFile('test.xml') 'musicxml' >>> common.findFormatFile('long/file/path/test-2009.03.02.xml') 'musicxml' >>> common.findFormatFile('long/file/path.intermediate.png/test-2009.03.xml') 'musicxml' On a windows networked filesystem >>> common.findFormatFile(r'\\long\file\path\test.krn') 'humdrum'  isinstancepathlibPathrsuffix)fpr0 unused_exts r4rrs8$ b',, ' ' \\"  +OC Jr5c[U[R5(d[R"U5n[UR5upUcgXR4$)a Given a file path (relative or absolute) find format and extension used (not the output extension) DEPRECATED May 2014 -- moving to converter >>> common.findFormatExtFile('test.mxl') ('musicxml', '.mxl') >>> common.findFormatExtFile('long/file/path/test-2009.03.02.xml') ('musicxml', '.xml') >>> common.findFormatExtFile('long/file/path.intermediate.png/test-2009.03.xml') ('musicxml', '.xml') >>> common.findFormatExtFile('test') (None, None) Windows drive >>> common.findFormatExtFile('d:/long/file/path/test.xml') ('musicxml', '.xml') On a windows networked filesystem >>> common.findFormatExtFile(r'\\long\file\path\test.krn') ('humdrum', '.krn') r7rI)rNr> unused_extOuts r4rrsJ2 b',, ' ' \\"  *299 5JII&&r5c2SSKJn SnSU;aSnOsSU;aSnOjSU;dS U;aS nO[UR5R5H9nURnUH$nUR S U-5(dMS U-n M7 M; Ub[ U5upgXb4$g ) a Given a URL, attempt to find the extension. This may scrub arguments in a URL, or simply look at the last characters. DEPRECATED May 2014 -- moving to converter >>> urlA = 'http://somesite.com/?l=cc/schubert/piano/d0576&file=d0576-06.krn&f=xml' >>> urlB = 'http://somesite.com/cgi-bin/ksdata?l=cc/schubert/d0576&file=d0576-06.krn&f=kern' >>> urlC = 'http://somesite.com/cgi-bin/ksdata?l=cc/bach/cello&file=bwv1007-01.krn&f=xml' >>> urlF = 'https://junk' >>> urlM = 'http://somesite.com/files/mid001.mid' >>> common.findFormatExtURL(urlA) ('musicxml', '.xml') >>> common.findFormatExtURL(urlB) ('humdrum', '.krn') >>> common.findFormatExtURL(urlC) ('musicxml', '.xml') >>> common.findFormatExtURL(urlF) (None, None) >>> common.findFormatExtURL(urlM) ('midi', '.mid') rr(Nz=xmlz.xmlz=kernz.krnz format=stage2z format=stage1z.mdr8r7)r,r)r-r.r<endswithr)urlr)rGr2 inputTypes extSampler> unused_junks r4r r ,s2" C } C C ?c#9%%'99;B33J' <<i00 /C(< ",S/ r5__main__)r0strreturnztype[SubConverter] | None)r0rYrZztuple[str, ...])__doc__ __future__r__all__ functoolsr rKtypingt TYPE_CHECKINGmusic21.converter.subConvertersrr r r rrrrrr __name__r,mainTestr5r4rfs # ??< 6  / @S#n44r4 'J0f z r5