yafowil.widget.autocomplete 1.8__py3-none-any.whl

yafowil/widget/autocomplete/__init__.py

@@ -0,0 +1,69 @@
+from yafowil.base import factory
+from yafowil.utils import entry_point
+import os
+
+
+resourcedir = os.path.join(os.path.dirname(__file__), 'resources')
+js = [{
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.menu.min.js',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.autocomplete.min.js',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.common',
+    'resource': 'widget.js',
+    'order': 21,
+}]
+default_css = [{
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.menu.css',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.autocomplete.css',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.common',
+    'resource': 'widget.css',
+    'order': 21,
+}]
+bootstrap_css = [{
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.menu.bootstrap.css',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.autocomplete.bootstrap.css',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.common',
+    'resource': 'widget.css',
+    'order': 21,
+}]
+plone5_css = [{
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.menu.plone5.css',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.dependencies',
+    'resource': 'jquery.ui.autocomplete.plone5.css',
+    'order': 20,
+}, {
+    'group': 'yafowil.widget.autocomplete.common',
+    'resource': 'widget.css',
+    'order': 21,
+}]
+
+
+@entry_point(order=10)
+def register():
+    from yafowil.widget.autocomplete import widget  # noqa
+    factory.register_theme('default', 'yafowil.widget.autocomplete',
+                           resourcedir, js=js, css=default_css)
+    factory.register_theme('bootstrap', 'yafowil.widget.autocomplete',
+                           resourcedir, js=js, css=bootstrap_css)
+    factory.register_theme('plone5', 'yafowil.widget.autocomplete',
+                           resourcedir, js=js, css=plone5_css)

yafowil/widget/autocomplete/example.py

@@ -0,0 +1,127 @@
+from yafowil.base import factory
+from yafowil.compat import IS_PY2
+import json
+
+
+if IS_PY2:
+    from urlparse import urlparse
+    from urlparse import parse_qs
+else:
+    from urllib.parse import urlparse
+    from urllib.parse import parse_qs
+
+
+lipsum = """Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
+eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
+veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo
+consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum
+dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident,
+sunt in culpa qui officia deserunt mollit anim id est laborum."""
+lipsum = sorted(set(lipsum.lower().replace('.', '').replace(',', '').split()))
+
+
+def json_response(url):
+    purl = urlparse(url)
+    qs = parse_qs(purl.query)
+    data = json_data(qs.get('term', [''])[0])
+    return {
+        'body': json.dumps(data),
+        'header': [('Content-Type', 'application/json')]
+    }
+
+
+def json_data(term):
+    data = lipsum
+    if term:
+        data = [_ for _ in data if _.startswith(term)]
+    return data
+
+
+DOC_STATIC = """\
+Autocomplete with static vocabulary
+-----------------------------------
+
+Autocomplete can make use of a static vocabulary source. Here words of blind
+text Lorem Ipsum are used. First the static list of words is generated
+
+.. code-block:: python
+
+    lipsum = '''Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
+    eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
+    veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
+    commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit
+    esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
+    cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id
+    est laborum.'''
+    lipsum = sorted(set(lipsum.lower().replace('.', '').replace(',', '').split()))
+
+Next, the field is defined as
+
+.. code-block:: python
+
+    field = factory('#field:autocomplete', props={
+        'label': 'Enter some text (local, lorem ipsum)',
+        'value': '',
+        'source': lipsum,
+    })
+"""
+
+DOC_JSON = """\
+Autocomplete with dynamic json vocabulary
+-----------------------------------------
+
+Instead of static lists autocomplete may ask the server for a list of words
+matching a given term. The source is a string and as such interpreted as a
+absolute or relative url
+
+.. code-block:: python
+
+    field = factory('#field:autocomplete', props={
+        'label': 'Enter some text (remote listdir)',
+        'value': '',
+        'source': 'yafowil.widget.autocomplete.json',
+        'minLength': 1,
+    })
+
+The server answers with a JSON response, here the example does it using WSGI
+and ``webob`` way. This code needs modification depending on the framework
+used
+
+.. code-block:: python
+
+    def json_response(environ, start_response):
+        data = lipsum
+        if environ['QUERY_STRING'].startswith('term='):
+            qsts = environ['QUERY_STRING'][5:]
+            data = [_ for _ in data if _.startswith(qsts)]
+        response = Response(content_type='application/json',
+                            body=json.dumps(data))
+        return response(environ, start_response)
+"""
+
+
+def get_example():
+    static_ac = factory('#field:autocomplete', name='static', props={
+        'label': 'Enter some text (local, lorem ipsum)',
+        'value': '',
+        'source': lipsum,
+    })
+    json_ac = factory('#field:autocomplete', name='json', props={
+        'label': 'Enter some text (remote listdir)',
+        'value': '',
+        'source': 'yafowil.widget.autocomplete.json',
+        'minLength': 1,
+    })
+    routes = {
+        'yafowil.widget.autocomplete.json': json_response,
+    }
+    return [{
+        'widget': static_ac,
+        'doc': DOC_STATIC,
+        'title': 'Static autocomplete',
+    }, {
+        'widget': json_ac,
+        'routes': routes,
+        'doc': DOC_JSON,
+        'title': 'JSON data autocomplete',
+    }]

yafowil/widget/autocomplete/resources/jquery.ui.autocomplete.bootstrap.css

@@ -0,0 +1,16 @@
+/*
+ * jQuery UI Autocomplete 1.10.3
+ *
+ * Copyright 2013, AUTHORS.txt (http://jqueryui.com/about)
+ * Dual licensed under the MIT or GPL Version 2 licenses.
+ * http://jquery.org/license
+ *
+ * http://jqueryui.com/autocomplete/
+ */
+
+.ui-autocomplete {
+    position: absolute;
+    top: 0;
+    left: 0;
+    cursor: default;
+}

yafowil/widget/autocomplete/resources/jquery.ui.autocomplete.css

@@ -0,0 +1,16 @@
+/*!
+ * jQuery UI Autocomplete 1.10.3
+ * http://jqueryui.com
+ *
+ * Copyright 2013 jQuery Foundation and other contributors
+ * Released under the MIT license.
+ * http://jquery.org/license
+ *
+ * http://docs.jquery.com/UI/Autocomplete#theming
+ */
+.ui-autocomplete {
+	position: absolute;
+	top: 0;
+	left: 0;
+	cursor: default;
+}