Gael Pasgrimaud avatar Gael Pasgrimaud committed f795064

fix #18

Comments (0)

Files changed (7)

+0.6.1
+------
+
+Move README.txt at package root
+
+Add CHANGES.txt and add it to long_description
+
+0.6
+----
+
+Added PyQuery.outerHtml
+
+Added PyQuery.fn
+
+Added PyQuery.map
+
+Change PyQuery.each behavior to reflect jQuery api
+
+
+pyquery: a jquery-like library for python
+=========================================
+
+pyquery allows you to make jquery queries on xml documents.
+The API is as much as possible the similar to jquery. pyquery uses lxml for fast
+xml and html manipulation.
+
+This is not (or at least not yet) a library to produce or interact with
+javascript code. I just liked the jquery API and I missed it in python so I
+told myself "Hey let's make jquery in python". This is the result.
+
+It can be used for many purposes, one idea that I might try in the future is to
+use it for templating with pure http templates that you modify using pyquery.
+I can also be used for web scrapping or for theming applications with
+`Deliverance`_.
+
+The `project`_ is being actively developped on a mercurial repository on
+Bitbucket. I have the policy of giving push access to anyone who wants it
+and then to review what he does. So if you want to contribute just email me.
+
+Please report bugs on the `bitbucket
+<http://bitbucket.org/olauzanne/pyquery/issues?status=new&status=open>`_ issue
+tracker.
+
+.. _deliverance: http://www.gawel.org/weblog/en/2008/12/skinning-with-pyquery-and-deliverance
+.. _project: http://www.bitbucket.org/olauzanne/pyquery/
+
+Quickstart
+==========
+
+You can use the PyQuery class to load an xml document from a string, a lxml
+document, from a file or from an url::
+
+    >>> from pyquery import PyQuery as pq
+    >>> from lxml import etree
+    >>> import urllib
+    >>> d = pq("<html></html>")
+    >>> d = pq(etree.fromstring("<html></html>"))
+    >>> d = pq(url='http://google.com/')
+    >>> d = pq(url='http://google.com/', opener=lambda url: urllib.urlopen(url).read())
+    >>> d = pq(filename=path_to_html_file)
+
+Now d is like the $ in jquery::
+
+    >>> d("#hello")
+    [<p#hello.hello>]
+    >>> p = d("#hello")
+    >>> p.html()
+    'Hello world !'
+    >>> p.html("you know <a href='http://python.org/'>Python</a> rocks")
+    [<p#hello.hello>]
+    >>> p.html()
+    u'you know <a href="http://python.org/">Python</a> rocks'
+    >>> p.text()
+    'you know Python rocks'
+
+You can use some of the pseudo classes that are available in jQuery but that
+are not standard in css such as :first :last :even :odd :eq :lt :gt :checked
+:selected :file::
+
+    >>> d('p:first')
+    [<p#hello.hello>]
+
+News
+=====
+
+.. include:: ../CHANGES.txt
-.. include:: ../pyquery/README.txt
+.. include:: ../README.txt
 
 Full documentation
 ==================
    tips
    testing
    future
+   changes
 
 More documentation
 ==================
 
 .. _jquery website: http://docs.jquery.com/
 .. _code: http://www.bitbucket.org/olauzanne/pyquery/src/tip/pyquery/pyquery.py
-.. _here: http://pyquery.org
 .. _color cheat sheet: http://colorcharge.com/wp-content/uploads/2007/12/jquery12_colorcharge.png
+.. _here: http://packages.python.org/pyquery/
 
 Indices and tables
 ==================

pyquery/README.txt

-pyquery: a jquery-like library for python
-=========================================
-
-pyquery allows you to make jquery queries on xml documents.
-The API is as much as possible the similar to jquery. pyquery uses lxml for fast
-xml and html manipulation.
-
-This is not (or at least not yet) a library to produce or interact with
-javascript code. I just liked the jquery API and I missed it in python so I
-told myself "Hey let's make jquery in python". This is the result.
-
-It can be used for many purposes, one idea that I might try in the future is to
-use it for templating with pure http templates that you modify using pyquery.
-I can also be used for web scrapping or for theming applications with
-`Deliverance`_.
-
-The `project`_ is being actively developped on a mercurial repository on
-Bitbucket. I have the policy of giving push access to anyone who wants it
-and then to review what he does. So if you want to contribute just email me.
-
-The full documentation is available on `pyquery.org`_.
-
-.. _deliverance: http://www.gawel.org/weblog/en/2008/12/skinning-with-pyquery-and-deliverance
-.. _project: http://www.bitbucket.org/olauzanne/pyquery/
-.. _pyquery.org: http://pyquery.org/
-
-Quickstart
-==========
-
-You can use the PyQuery class to load an xml document from a string, a lxml
-document, from a file or from an url::
-
-    >>> from pyquery import PyQuery as pq
-    >>> from lxml import etree
-    >>> import urllib
-    >>> d = pq("<html></html>")
-    >>> d = pq(etree.fromstring("<html></html>"))
-    >>> d = pq(url='http://google.com/')
-    >>> d = pq(url='http://google.com/', opener=lambda url: urllib.urlopen(url).read())
-    >>> d = pq(filename=path_to_html_file)
-
-Now d is like the $ in jquery::
-
-    >>> d("#hello")
-    [<p#hello.hello>]
-    >>> p = d("#hello")
-    >>> p.html()
-    'Hello world !'
-    >>> p.html("you know <a href='http://python.org/'>Python</a> rocks")
-    [<p#hello.hello>]
-    >>> p.html()
-    u'you know <a href="http://python.org/">Python</a> rocks'
-    >>> p.text()
-    'you know Python rocks'
-
-You can use some of the pseudo classes that are available in jQuery but that
-are not standard in css such as :first :last :even :odd :eq :lt :gt :checked
-:selected :file::
-
-    >>> d('p:first')
-    [<p#hello.hello>]
-
     return resp(environ, start_response)
 
 class TestReadme(doctest.DocFileCase):
-    path = os.path.join(dirname, 'README.txt')
+    path = os.path.join(dirname, '..', 'README.txt')
 
     def __init__(self, *args, **kwargs):
         parser = doctest.DocTestParser()
 from setuptools import setup, find_packages
 import sys, os
 
-long_description = open(os.path.join('pyquery', 'README.txt')).read()
+def read(*names):
+    values = dict()
+    for name in names:
+        filename = name+'.txt'
+        if os.path.isfile(filename):
+            value = open(name+'.txt').read()
+        else:
+            value = ''
+        values[name] = value
+    return values
 
-version = '0.6'
+long_description="""
+%(README)s
+
+See http://packages.python.org/pyquery/ for the full documentation
+
+News
+====
+
+%(CHANGES)s
+
+""" % read('README', 'CHANGES')
+
+version = '0.6.1'
 
 setup(name='pyquery',
       version=version,
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.