j;hdZddlmZgdZddlZddlZddlZddlZddlZddl Z ddl Z ej dZ ej dZ d)d Zd*d+dZd,d-dZd,d-dZd.d/dZd0d1dZd1dZd2dZd3dZd4dZejGd d!Z d5d6d'Zed(krddlZejdSdS)7z Tools for working with strings ) annotations) whitespaceEqual getNumFromStrhyphenToCamelCasecamelCaseToHyphenspaceCamelCasegetMd5 formatStr stripAccentsnormalizeFilenameremovePunctuationparenthesesMatchParenthesesMatchNz\s+z +astrbreturnboolctd|}td|}td|}td|}||krdSdS)a returns True if a and b are equal except for whitespace differences >>> a = ' hello \n there ' >>> b = 'hello there' >>> c = ' bye there ' >>> common.whitespaceEqual(a, b) True >>> common.whitespaceEqual(a, c) False TF) WHITESPACEsubLINEFEED)rrs /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/common/stringTools.pyrr,sc r1Ar1A RA RAAvvtu 0123456789usrStrnumberstuple[str, str]cg}g}|D]1}||vr||||2d|d|fS)a$ Given a string, extract any numbers. Return two strings, the numbers (as strings) and the remaining characters. >>> common.getNumFromStr('23a') ('23', 'a') >>> common.getNumFromStr('23a954Hello') ('23954', 'aHello') >>> common.getNumFromStr('') ('', '') r)appendjoin)rrfoundremainchars rrrCso E F   7?? LL     MM$     775>>2776?? **r- replacementcd}t||D]%\}}|dkr|}||z }&|S)a Given a hyphen-connected-string, change it to a camelCaseConnectedString. The replacement can be specified to be something besides a hyphen. >>> common.hyphenToCamelCase('movement-name') 'movementName' >>> common.hyphenToCamelCase('movement_name', replacement='_') 'movementName' Safe to call on a string lacking the replacement character: >>> common.hyphenToCamelCase('voice') 'voice' And on "words" beginning with numbers: >>> common.hyphenToCamelCase('music-21') 'music21' rr) enumeratesplit capitalize)rr'postiwords rrrZs[. DV\\+6677&&4 66DD DOO%% %DD Krc(t|dkrtd||krtdtjdd|zdz|}tjdd|zdz|S)aF Given a camel-cased string, or a mixture of numbers and characters, create a space separated string. The replacement can be specified to be something besides a hyphen, but only a single character and not (for internal reasons) an uppercase character. code from https://stackoverflow.com/questions/1175208/elegant-python-function-to-convert-camelcase-to-snake-case >>> common.camelCaseToHyphen('movementName') 'movement-name' First letter can be uppercase as well: >>> common.camelCaseToHyphen('MovementName') 'movement-name' >>> common.camelCaseToHyphen('movementNameName') 'movement-name-name' >>> common.camelCaseToHyphen('fileName', replacement='_') 'file_name' Some things you cannot do: >>> common.camelCaseToHyphen('fileName', replacement='NotFound') Traceback (most recent call last): ValueError: Replacement must be a single character. >>> common.camelCaseToHyphen('fileName', replacement='A') Traceback (most recent call last): ValueError: Replacement cannot be an uppercase character. z'Replacement must be a single character.z-Replacement cannot be an uppercase character.z(.)([A-Z][a-z]+)z\1z\2z([a-z0-9])([A-Z]))len ValueErrorlowerrer)rr's1s rrrzsF ;1BCCCk))HIII "EK$7%$? H HB 6%u{':U'BB G G M M O OOrTcd}d}d}d}d}g}|d} n|} |D]} | |vrd}nd}|r|s|sd}nd}|s|s|rd}nd}|rC| s|s|r|d|| n|| |rd}d}d|} | D]-} d| } | | | } .|r| dd} | S) a Given a camel-cased string, or a mixture of numbers and characters, create a space separated string. If replaceUnderscore is True (default) then underscores also become spaces (but without the _) >>> common.spaceCamelCase('thisIsATest') 'this Is A Test' >>> common.spaceCamelCase('ThisIsATest') 'This Is A Test' >>> common.spaceCamelCase('movement3') 'movement 3' >>> common.spaceCamelCase('opus41no1') 'opus 41 no 1' >>> common.spaceCamelCase('opus23402no219235') 'opus 23402 no 219235' >>> common.spaceCamelCase('opus23402no219235').title() 'Opus 23402 No 219235' There is a small list called fixMeList that can fix mistakes. >>> common.spaceCamelCase('PMFC22') 'PMFC 22' >>> common.spaceCamelCase('hello_myke') 'hello myke' >>> common.spaceCamelCase('hello_myke', replaceUnderscore=False) 'hello_myke' z 0123456789.FN)PMFCT r_)isupperr!r"replace)rreplaceUnderscore fixMeListrfirstNum firstCharisNumber lastIsNumr, fixupListr%postStrfixMe fixMeSpaceds rrrsw<GHIHID   7??HHH  H Y HHH   i III  ||~~ ! !Y ! C   KK     KK     IIIIggdmmG66hhuoo //+u55,//#s++ Nrct|Attjttjz}tj} ||n8#t $r+||dYnwxYw|S)z Return an md5 hash from a string. If no value is given then the current time plus a random number is encoded. >>> common.getMd5('test') '098f6bcd4621d373cade4e832627b4f6' NUTF-8) rtimerandomhashlibmd5update TypeErrorencode hexdigest)valuems rr r s }DIKK  3v}#7#77 A(  ((( g&&'''''( ;;==sA..2B#"B#c|g|}tt|D]}||}t|tr|d||<t|t sS t |||<`#t$r2 |d||<n#t$rd||<YnwxYwYwxYwd |dzS)a DEPRECATED: do not use. May be removed at any time. Format one or more data elements into string suitable for printing straight to stderr or other outputs >>> a = common.formatStr('test', '1', 2, 3) >>> print(a) test 1 2 3 zutf-8rr8 ) ranger1 isinstancebytesdecoderreprrMAttributeErrorr")msgrest_of_messagekeywordsr-xs rr r s  ! !C 3s88__    F a   'XXg&&CF!S!!  aA    XXg..CFF%   CFFF    88C==4 s6/B B> B&%B>&B85B>7B88B>=B> inputStringc2tjd|ddddddddd d}d d |DS) u removes accents from unicode strings. >>> s = 'trés vite' >>> 'é' in s True >>> common.stripAccents(s) 'tres vite' Also handles the German Eszett and smart quotes >>> common.stripAccents('Muß') 'Muss' >>> common.stripAccents('Süss, “êtré”') 'Suss, "etre"' Note -- it is still possible to have non-Ascii characters after this, like in this Japanese expression for music: >>> common.stripAccents('音楽') '音楽' NFKDßssu“"u”u‘'u’rc:g|]}tj||S) unicodedata combining).0cs r z stripAccents..Gs(III! 0Ea0H0HIAIIIr)rg normalizer;r")r^ nfkd_forms rr r (s0 fk22 t                77IIyIII J JJrnamechd}t|}|dkr3|ddkr't||dz d}|d|dz }t|}|ddd}t jd d |}|||z }|S) u take a name that might contain unicode characters, punctuation, or spaces and normalize it so that it is POSIX compliant (except for the limit on length). Takes in a string or unicode string and returns a string (unicode in Py3) without any accented characters. >>> common.normalizeFilename('03-Niccolò all’lessandra.not really.xml') '03-Niccolo_all_lessandra_not_really.xml' N.asciiignorerGz[^\w-]r9)r1rr rNrWr4rstrip)rn extensionlenNames rr r JsI$iiG{{tBx3Wq[\\*++ LWq[L!   D ;;w ) ) 0 0 9 9D 6)S$ ' ' - - / /D  Krsc|tddtj}||}|S)z Remove all punctuation from a string. >>> common.removePunctuation('This, is! my (face).') 'This is my face' r)r maketransstring punctuation translate)ryr{outs rr r fs2 b"f&899I ++i C Jrc8eZdZUded<ded<ded<ded<dS) rintstartendrtextlist[ParenthesesMatch]nestedN)__name__ __module__ __qualname____annotations__rfrrrrqs9JJJ HHH III""""""rr()opencloserc |r|stdtdddg}|g}d}d}|t|krD|sh|||t|z|krJt|t|zddg}|||t|z }~|s|||t|z|krt|dkrtd|d|d |d |}||_||j||_|dj||t|z }-||d kr| }nd}|dz }|t|kDt|dkr$td |d |djdz d |jS)ap Utility tool to return a list of parentheses matches for a string using a dataclass called `ParenthesesMatch` which has indices of the `start` and `end` of the match, and the `text` of the match, and a set of `nested` ParenthesesMatch objects (which may have their own nested objects). >>> st = r'Bologne wrote (a (whole) (lot) \(of\)) sym\(ph(on)ies\) concertantes.' >>> common.stringTools.parenthesesMatch(st) [ParenthesesMatch(start=15, end=37, text='a (whole) (lot) \\(of\\)', nested=[ParenthesesMatch(start=18, end=23, text='whole', nested=[]), ParenthesesMatch(start=26, end=29, text='lot', nested=[])]), ParenthesesMatch(start=47, end=49, text='on', nested=[])] Other brackets can be used: >>> st = r'[Whammy bars] and [oboes] do [not [mix] very] [well.]' >>> common.stringTools.parenthesesMatch(st, open='[', close=']') [ParenthesesMatch(start=1, end=12, text='Whammy bars', nested=[]), ParenthesesMatch(start=19, end=24, text='oboes', nested=[]), ParenthesesMatch(start=30, end=44, text='not [mix] very', nested=[ParenthesesMatch(start=35, end=38, text='mix', nested=[])]), ParenthesesMatch(start=47, end=52, text='well.', nested=[])] The `open` and `close` parameters can be multiple characters: >>> st = r'Did you eat <> today <>>>' >>> common.stringTools.parenthesesMatch(st, open='<<', close='>>') [ParenthesesMatch(start=14, end=19, text='beans', nested=[]), ParenthesesMatch(start=30, end=46, text='Pythagoreas<>', nested=[ParenthesesMatch(start=43, end=44, text='?', nested=[])])] They cannot, however, be empty: >>> common.stringTools.parenthesesMatch(st, open='', close='') Traceback (most recent call last): ValueError: Neither open nor close can be empty. Unmatched opening or closing parentheses will raise a ValueError: >>> common.stringTools.parenthesesMatch('My (parentheses (sometimes (continue',) Traceback (most recent call last): ValueError: Opening '(' at index 3 was never closed >>> common.stringTools.parenthesesMatch('This is a example>', open='<', close='>') Traceback (most recent call last): ValueError: Closing '>' without '<' at index 23. Note that using multiple characters like a prefix can have unintended consequences: >>> st = r'[Pitch("C4"), [Pitch("D5"), Pitch("E6")], Pitch("Pity("Z9")")]' >>> common.stringTools.parenthesesMatch(st, open='Pitch("', close='")') Traceback (most recent call last): ValueError: Closing '")' without 'Pitch("' at index 59. So to do something like this, you might need to get creative: >>> out = common.stringTools.parenthesesMatch(st, open='("', close='")') >>> out [ParenthesesMatch(start=8, end=10, text='C4', nested=[]), ParenthesesMatch(start=22, end=24, text='D5', nested=[]), ParenthesesMatch(start=35, end=37, text='E6', nested=[]), ParenthesesMatch(start=49, end=59, text='Pity("Z9")', nested=[ParenthesesMatch(start=55, end=57, text='Z9', nested=[])])] >>> extractedPitches = [] >>> for match in out: ... if st[match.start - 7:match.start] == 'Pitch("': ... extractedPitches.append(match.text) >>> extractedPitches ['C4', 'D5', 'E6', 'Pity("Z9")'] * New in v9.3. z$Neither open nor close can be empty.rFrr0zClosing z without z at index rr\zOpening z was never closed) r2rr1r!poprrrr)ryrr mainMatchstacklastCharWasBackslashr-curPMs rrrxsZ AuA?@@@ RR00I%.KE  A c!ff**$ aCII o&$..$QT]BB??E LL    TNA & Aa#e**n$%..5zzQ !TE!T!Td!T!TPQ!T!T!TUUUIIKKEEI5;q=)EJ "I  # #E * * * UOA  Q44<<';#; #(  Q- c!ff**0 5zzA~~[D[[eAhnq6H[[[\\\  r__main__)rrrrrr)r)rrrrrr)r&)rrr'rrr)TN)rrrr)N)rr)r^rrr)rnrrr)ryrrr)rr)ryrrrrrrr)__doc__ __future__r__all__ dataclassesrJrIr4rHr|rgcompilerrrrrrrr r r r r dataclassrrrmusic21mainTestrfrrrs&#"""""    RZ   2:e  .+++++.@(P(P(P(P(PVNNNNNb(    <KKKKD8     ########qqqqqj zNNNGr