j)dZddlmZgdZddlmZddlZddlZej rddl m Z gdZ gdZ gd ZddZdZeddZdZdZdZedkrddlZejdSdS)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)askdenyallowfmtstrreturntype[SubConverter] | Nonec|}ddlm}|}|D]}|j}||vr|cSdS)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)r'r-sclscformatss /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/common/formats.pyrr;s* ))++    C!!!!!!      1 1 3 3C$ '>>III  4c ddlm}|}||}|dS|}||}|jrd|jdz}n|jrd|jdz}nd}||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.)r0r-r1regularizeFormatgetSubConverterFormatsregisterOutputExtensionsregisterInputExtensions)r'r-c fileFormatscfr5 firstOutputs r7rr[s~"!!!!!A##C((J| " " $ $C ZB "B7:: #B6q99  { ""r8tuple[str, ...]cnddlm}|}|dr |dd}t |}|g}|D]X}||jvr |jD]1}|dsd|z}| |2|rt|cSYt|Sg}|jD]1}|dsd|z}| |2t|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,r;N) r0r-r.r/ startswithrr1r2r?appendtuple)r'r-r5postexts r7rrse6"!!!!! ))++    C ~~c!""g "3 ' 'B z%%''99;; # #B"4441 ! !~~c**$)C C     #T{{""" #T{{-  C>>#&& Ci KK    T{{r8ct|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)fpr' unused_exts r7rrs?" b', ' ' \"   ++OC Jr8ct|tjstj|}t|j\}}|dS||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') Nr:rM)rRrA unused_extOuts r7rrsS2 b', ' ' \"   *29 5 5J |BI&&r8c ddlm}d}d|vrd}nfd|vrd}n_d|vsd |vrd }nT|D]-}|j}|D]!}|d |zrd |z}n".|t |\}}||fSd S) 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.mdr;r:)r0r-r1r2r?endswithr)urlr-rKr5 inputTypes extSamplerA unused_junks r7r r %s0"!!!!! C }} C C  ?c#9#9%%''99;;  B3J'   <<i00 /CE  ",S// K3zr8__main__)r'r(r)r*)r'r(r)rD)__doc__ __future__r__all__ functoolsr rOtypingt TYPE_CHECKINGmusic21.converter.subConvertersrr r r rrrrrr __name__r0mainTestr8r7rhsZ #"""""   ?=<<<<<< 666    /.. @N#N#N#d4444r2 ' ' 'J///d zNNNGr8