https://github.com/magcius/mpdsetup

magcius's MPD Setup
https://github.com/magcius/mpdsetup

Last synced: 7 days ago
JSON representation

magcius's MPD Setup

• Host: GitHub
• URL: https://github.com/magcius/mpdsetup
• Owner: magcius
• License: gpl-3.0
• Created: 2009-06-22T17:44:39.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2010-07-19T20:58:14.000Z (over 14 years ago)
• Last Synced: 2024-09-21T18:59:13.637Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 218 KB
• Stars: 6
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: COPYING

Awesome Lists containing this project

README

        

query.py

========

query.py is a query engine for MPD using LEPL and python-mpd.

Requirements

------------

* `Python >= 2.6`_

  

  - 2.6 is needed for its 'set' class

* `MPD >= 0.15`_

  

  - Older versions may work fine too

  

* `LEPL >= 4.0`_

  

  - ``easy_install lepl`` should work

  

* `python-mpd`_

  

  My fork.

Query Grammar

-------------

The grammar:

::

  

  String: /'[^']*'/ | /"[^"]*"/ | /[^\w]+/;

  

  Or:  '|' | '||' | /or/i;

  And: '&' | '&&' | /and/i;

  

  Tag: /%[a-zA-Z]+%/ | /<[a-zA-Z]+>/;

  TagCollectionOr:  Tag (Or Tag)*;

  TagCollectionAnd: TagCollectionOr (And TagCollectionOr)*;

  TagCollection: TagCollectionAnd;

  

  Comparator: '==' | /like/i;

  Comparison: TagCollectionAnd Comparator String;

  

  Atom: '(' AndExpression ')' |

        '{' AndExpression '}' |

        '[' AndExpression ']' | Comparison;

  

  OrExpression:  Atom (Or Atom)*;

  AndExpression: OrExpression (And OrExpression)*;

  

  Query: AndExpression EOS;

Notes

-----

* ``{}``, ``[]`` are included as well as parens as some shells

  take any of those three as special characters.

* Same with ``and`` and ``or``.

* '==' is a strict, case-sensitive match.

* 'like' checks for a substring of the full value in the database.

  For instance, if the database contains "The Beatles" and you do

  "like Beatles", it will match. If the database contains "Beatles"

  and you do "like The Beatles", it will not match. 'like' is case-

  insensitive.

* Tag collections allow you do things like:

  ``%artist% and %album% like "Gabe Dixon"``, which means

  that both the artist and the album must contain the substring

  "Gabe Dixon". %tag1% or %tag2% matches for either.

Query Examples

--------------

* ``%artist% like Beatles and [%title% or %album% like "Let It Be"]``

* ``%file% like "Video Game OST" and %artist% == "Lisa Miskovsky"``

* ``%genre% like Rock or %genre% like Pop``

Front-ends

----------

There are currently two front-ends to query.py. mpdgrep, and gtkfind.

These are successors to my old tools mpdgrep and zenfind, both written

in BASH. query.py should be backwards-compatible with both of them for

the most part, except for the implementation-specific "artist - album - title"

and "artist;album;title" searches.

mpdgrep should be bash-quote compatible, so that means that it acts like a query

engine straight from bash. Something like:

``$ mpdgrep [%artist% like "Zac Mac Band"] and [%title% like "Radio"]``

works perfectly on my computer.

.. _Python >= 2.6: http://www.python.org/

.. _MPD >= 0.15:   http://www.musicpd.org/

.. _LEPL >= 3.3:   http://www.acooke.org/lepl/

.. _python-mpd:    https://github.com/magcius/python-mpd