Merge pull request #64 from scrapy/add-css2xpath

[MRG+1] Add a css2xpath util function available at the top-level

parsel/__init__.py

@@ -8,3 +8,4 @@
 __version__ = '1.0.3'
 
 from parsel.selector import Selector, SelectorList  # NOQA
+from parsel.csstranslator import css2xpath  # NOQA

parsel/csstranslator.py

@@ -96,3 +96,11 @@ class GenericTranslator(TranslatorMixin, OriginalGenericTranslator):
 
 class HTMLTranslator(TranslatorMixin, OriginalHTMLTranslator):
     pass
+
+
+_translator = HTMLTranslator()
+
+
+def css2xpath(query):
+    "Return translated XPath version of a given CSS query"
+    return _translator.css_to_xpath(query)

tests/test_selector_csstranslator.py

@@ -113,6 +113,14 @@ def test_unknown_pseudo_class(self):
             self.assertRaises(exc, self.c2x, css)
 
 
+class UtilCss2XPathTest(unittest.TestCase):
+    def test_css2xpath(self):
+        from parsel import css2xpath
+        expected_xpath = (u"descendant-or-self::*[@class and contains("
+                          "concat(' ', normalize-space(@class), ' '), ' some-class ')]")
+        self.assertEqual(css2xpath('.some-class'), expected_xpath)
+
+
 class CSSSelectorTest(unittest.TestCase):
 
     sscls = Selector