Support for "contains" find/search expression filter

[kowalcj0]

Hi,

Got a QQ: Does python-mpd2 support "contains" find/search expression filter?
If if does, then it would be great to have an example of it somewhere in the docs or tests.

PS. The reason I asked about it, is because the "contains" filter can come it handy when looking for a track with partial track details.

Here's an example of how it works in mpc (I've compared an exact match query with a query that uses "contains" filter):

Given there's a track called "Chico Science & Nação Zumbi - Maracatu Atômico" in MPD DB
When client executes mpc with an exact match search: mpc search '((artist == "Chico Science") AND (title == "Maracatu Atômico"))'
Then the search returns no results

Given there's a track called "Chico Science & Nação Zumbi - Maracatu Atômico" in MPD DB
When client executes mpc with a contains filter search: mpc search '((artist contains "Chico Science") AND (title contains "Maracatu Atômico"))'
Then the search returns 1 matching track: "Chico Science & Nação Zumbi - Maracatu Atômico"

Thanks

[Mic92]

Seems to work:

>>> c.find('(artist == "Eminem")')
[{'file': 'Eminem - Kamikaze (2018)/01. The Ringer.mp3', 'last-modified': '2019-01-24T10:31:03Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'The Ringer', 'album': 'Kamikaze', 'track': '1', 'date': '2018', 'genre': 
'Hip-Hop/Rap', 'composer': 'M. Mathers, R. Fraser, L. Resto, K. Marrero, M. Jacobson & R. Spence Jr', 'disc': '1', 'time': '338', 'duration': '337.975'}, {'file': 'Eminem - Kamikaze (2018)/02. Greatest.mp3', 'last-modified': 
'2019-01-24T10:30:58Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Greatest', 'album': 'Kamikaze', 'track': '2', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers, M Williams, J Miller, K. Lamar, A. H
ogan, Anthony Tiffith, J. Carter, J. Jenks & Steve Woods', 'disc': '1', 'time': '227', 'duration': '226.981'}, {'file': 'Eminem - Kamikaze (2018)/03. Lucky You (feat. Joyner Lucas).mp3', 'last-modified': '2019-01-24T10:31:01Z
', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Lucky You (feat. Joyner Lucas)', 'album': 'Kamikaze', 'track': '3', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers, M. Samuels, J Sweet, G. Lucas & R. 
Fraser', 'disc': '1', 'time': '245', 'duration': '244.718'}, {'file': 'Eminem - Kamikaze (2018)/05. Normal.mp3', 'last-modified': '2019-01-24T10:31:05Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Normal', 'album':
 'Kamikaze', 'track': '5', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers, R. Fraser, E. Bodin, Y. Nagano, F Wallin, H. Wirenstrand, L. Griffin Jr, M. Nichols & R.Sheldon', 'disc': '1', 'time': '223', 'durati
on': '222.514'}, {'file': 'Eminem - Kamikaze (2018)/06. Em Calls Paul (Skit).mp3', 'last-modified': '2019-01-24T10:30:59Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Em Calls Paul (Skit)', 'album': 'Kamikaze', 'tr
ack': '6', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers', 'disc': '1', 'time': '49', 'duration': '49.061'}, {'file': 'Eminem - Kamikaze (2018)/07. Stepping Stone.mp3', 'last-modified': '2019-01-24T10:31:04Z
', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Stepping Stone', 'album': 'Kamikaze', 'track': '7', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers, L. Resto & M. Resto', 'disc': '1', 'time': '310', '
duration': '309.684'}, {'file': "Eminem - Kamikaze (2018)/08. Not Alike (feat. Royce da 5'9_).mp3", 'last-modified': '2019-01-24T10:31:01Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Not Alike (feat. Royce da 5\'9
")', 'album': 'Kamikaze', 'track': '8', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers, R. Montgomery, B. / Chambers & R. Spence Jr', 'disc': '1', 'time': '288', 'duration': '288.133'}, {'file': 'Eminem - Kam
ikaze (2018)/09. Fall.mp3', 'last-modified': '2019-01-24T10:31:04Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Fall', 'album': 'Kamikaze', 'track': '9', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Math
ers, M Williams, L. Resto, BJ Burton & J. Vernon', 'disc': '1', 'time': '216', 'duration': '216.061'}, {'file': 'Eminem - Kamikaze (2018)/10. Kamikaze.mp3', 'last-modified': '2019-01-24T10:31:05Z', 'format': '44100:24:2', 'ar
tist': 'Eminem', 'title': 'Kamikaze', 'album': 'Kamikaze', 'track': '10', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'Tim Suby, M. Mathers, J. Smith, D. Simon & B. Ervin', 'disc': '1', 'time': '263', 'duration': '262
.533'}, {'file': 'Eminem - Kamikaze (2018)/11. Nice Guy (feat. Jessie Reyez).mp3', 'last-modified': '2019-01-24T10:31:01Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Nice Guy (feat. Jessie Reyez)', 'album': 'Kamik
aze', 'track': '11', 'date': '2018', 'genre': 'Hip-Hop/Rap', 'composer': 'M. Mathers, L. Resto, L. Griffin Jr, J. Reyez & F. Ball', 'disc': '1', 'time': '151', 'duration': '150.860'}, {'file': 'Eminem - Kamikaze (2018)/12. Go
od Guy (feat. Jessie Reyez).mp3', 'last-modified': '2019-01-24T10:31:04Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Good Guy (feat. Jessie Reyez)', 'album': 'Kamikaze', 'track': '12', 'date': '2018', 'genre': 'Hi
p-Hop/Rap', 'composer': 'Jessie Reyez, M. Mathers, R. Fraser, Y. Yamada, L. Gomamoto & Norio Joseph Aono', 'disc': '1', 'time': '142', 'duration': '142.239'}, {'file': 'Eminem - Kamikaze (2018)/13. Venom (Music From the Motio
n Picture).mp3', 'last-modified': '2019-01-24T10:31:04Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Venom (Music From the Motion Picture)', 'album': 'Kamikaze', 'track': '13', 'date': '2018', 'genre': 'Hip-Hop/Rap
', 'composer': 'M. Mathers & L. Resto', 'disc': '1', 'time': '270', 'duration': '269.612'}, {'file': 'Eminem - Revival (2017)/1. Walk On Water (feat. Beyoncé).mp3', 'last-modified': '2019-01-24T10:30:43Z', 'format': '44100:24
:2', 'artist': 'Eminem', 'title': 'Walk On Water (feat. Beyoncé)', 'album': 'Revival', 'track': '1', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '304', 'duration': '303.728'}, {'file': 'Eminem - Revival (2017)/2. Believe.
mp3', 'last-modified': '2019-01-24T10:30:56Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Believe', 'album': 'Revival', 'track': '2', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '315', 'duration': '315.431'}, {
'file': 'Eminem - Revival (2017)/3. Chloraseptic (feat. PHRESHER).mp3', 'last-modified': '2019-01-24T10:30:52Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Chloraseptic (feat. PHRESHER)', 'album': 'Revival', 'track
': '3', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '301', 'duration': '301.247'}, {'file': 'Eminem - Revival (2017)/4. Untouchable.mp3', 'last-modified': '2019-01-24T10:30:48Z', 'format': '44100:24:2', 'artist': 'Eminem'
, 'title': 'Untouchable', 'album': 'Revival', 'track': '4', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '370', 'duration': '370.236'}, {'file': 'Eminem - Revival (2017)/5. River (feat. Ed Sheeran).mp3', 'last-modified': '
2019-01-24T10:30:30Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'River (feat. Ed Sheeran)', 'album': 'Revival', 'track': '5', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '221', 'duration': '221.129'}, {'file':
 'Eminem - Revival (2017)/6. Remind Me (Intro).mp3', 'last-modified': '2019-01-24T10:30:11Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Remind Me (Intro)', 'album': 'Revival', 'track': '6', 'date': '2017', 'genre'
: 'Hip-Hop/Rap', 'time': '26', 'duration': '26.439'}, {'file': 'Eminem - Revival (2017)/7. Remind Me.mp3', 'last-modified': '2019-01-24T10:30:52Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Remind Me', 'album': 'R
evival', 'track': '7', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '225', 'duration': '225.283'}, {'file': 'Eminem - Revival (2017)/8. Revival (Interlude).mp3', 'last-modified': '2019-01-24T10:30:54Z', 'format': '44100:24
:2', 'artist': 'Eminem', 'title': 'Revival (Interlude)', 'album': 'Revival', 'track': '8', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '52', 'duration': '51.934'}, {'file': 'Eminem - Revival (2017)/9. Like Home (feat. Ali
cia Keys).mp3', 'last-modified': '2019-01-24T10:30:45Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Like Home (feat. Alicia Keys)', 'album': 'Revival', 'track': '9', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': 
'246', 'duration': '245.580'}, {'file': 'Eminem - Revival (2017)/10. Bad Husband (feat. X Ambassadors).mp3', 'last-modified': '2019-01-24T10:30:56Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Bad Husband (feat. X 
Ambassadors)', 'album': 'Revival', 'track': '10', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '288', 'duration': '288.003'}, {'file': 'Eminem - Revival (2017)/11. Tragic Endings (feat. Skylar Grey).mp3', 'last-modified': 
'2019-01-24T10:30:27Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Tragic Endings (feat. Skylar Grey)', 'album': 'Revival', 'track': '11', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '252', 'duration': '252.110
'}, {'file': 'Eminem - Revival (2017)/12. Framed.mp3', 'last-modified': '2019-01-24T10:30:56Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Framed', 'album': 'Revival', 'track': '12', 'date': '2017', 'genre': 'Hip-H
op/Rap', 'time': '253', 'duration': '253.260'}, {'file': 'Eminem - Revival (2017)/13. Nowhere Fast (feat. Kehlani).mp3', 'last-modified': '2019-01-24T10:30:56Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Nowhere F
ast (feat. Kehlani)', 'album': 'Revival', 'track': '13', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '264', 'duration': '264.284'}, {'file': 'Eminem - Revival (2017)/14. Heat.mp3', 'last-modified': '2019-01-24T10:30:48Z',
 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Heat', 'album': 'Revival', 'track': '14', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '250', 'duration': '250.099'}, {'file': 'Eminem - Revival (2017)/15. Offended.mp
3', 'last-modified': '2019-01-24T10:30:49Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Offended', 'album': 'Revival', 'track': '15', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '321', 'duration': '321.021'}, {
'file': 'Eminem - Revival (2017)/16. Need Me (feat. P!nk).mp3', 'last-modified': '2019-01-24T10:30:40Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Need Me (feat. P!nk)', 'album': 'Revival', 'track': '16', 'date': 
'2017', 'genre': 'Hip-Hop/Rap', 'time': '266', 'duration': '265.564'}, {'file': 'Eminem - Revival (2017)/17. In Your Head.mp3', 'last-modified': '2019-01-24T10:30:37Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'In
 Your Head', 'album': 'Revival', 'track': '17', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '183', 'duration': '182.729'}, {'file': 'Eminem - Revival (2017)/18. Castle.mp3', 'last-modified': '2019-01-24T10:30:55Z', 'forma
t': '44100:24:2', 'artist': 'Eminem', 'title': 'Castle', 'album': 'Revival', 'track': '18', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '255', 'duration': '254.853'}, {'file': 'Eminem - Revival (2017)/19. Arose.mp3', 'las
t-modified': '2019-01-24T10:30:56Z', 'format': '44100:24:2', 'artist': 'Eminem', 'title': 'Arose', 'album': 'Revival', 'track': '19', 'date': '2017', 'genre': 'Hip-Hop/Rap', 'time': '275', 'duration': '274.732'}]

Currently I am not working or using this library but I would accept other pull requests that enhance documentation.