3j)dZddlmZgdZddlmZddlZddlZejrddl m Z gdZ gdZ gd Zdd Zd Zedd Zd ZdZdZedk(rddlZej.yy)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)askdenyallowc|jj}ddlm}|j j }|D]}|j }||vs|cSy)a 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 C/DATA/.local/lib/python3.12/site-packages/music21/common/formats.pyrr;sX* ))+   C!     1 1 3C$$ '>I cddlm}|j}|j|}|y|j }||}|j rd|j dz}||fS|j rd|j dz}||fSd}||fS)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) rr(NNN.)r,r)r-regularizeFormatgetSubConverterFormatsregisterOutputExtensionsregisterInputExtensions)r0r)c fileFormatscfr2 firstOutputs r4rr[s~"A##C(J " " $C ZB ""B77:: { "" # #B66q99  { "" { ""r5c&ddlm}|jj}|j dr|dd}t |}|g}|j jD]X}||jvr|jD])}|j dsd|z}|j|+|sMt|cSt|Sg}|jD])}|j dsd|z}|j|+t|S)ab 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 r4rrs6" ))+   C ~~c!"g "3 'B z%%'99;B"44411~~c*)C C 2T{"<T{--C>>#&Ci KK .T{r5ct|tjstj|}t|j\}}|S)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 r4rrs7" b',, ' \\"  +OC Jr5ct|tjstj|}t|j\}}|y||jfS)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 r4rrsK2 b',, ' \\"  *299 5J BII&&r5cddlm}d}d|vrd}ncd|vrd}n\d|vsd |vrd }nQ|jjD]0}|j}|D]}|j d |zsd |z}02|t |\}}||fSy ) aN 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 %s0" C } C C ?c#9%%'99;B33J' <<i0 /C(< ",S/ K3r5__main__)r0strreturnztype[SubConverter] | None)r0rYrZztuple[str, ...])__doc__ __future__r__all__ functoolsr rKtypingt TYPE_CHECKINGmusic21.converter.subConvertersrr r r rrrrrr __name__r,mainTestr5r4rfs # ??< 6  / @N#d44r2 'J/d zGr5