rename to robobrowser

Author: jmcarp

.coveragerc

@@ -1,7 +1,7 @@
 [report]
 omit =
-    pyrobot/ordereddict.py
-    pyrobot/responses.py
+    robobrowser/ordereddict.py
+    robobrowser/responses.py
     */python?.?/*
     */lib-python/?.?/*.py
     */pypy/*

.travis.yml

@@ -14,6 +14,6 @@ install:
     - pip install coverage coveralls nose responses
 
 # command to run tests, e.g. python setup.py test
-script: nosetests --with-coverage --cover-package=pyrobot
+script: nosetests --with-coverage --cover-package=robobrowser
 
 after_success: coveralls

AUTHORS.rst

@@ -7,6 +7,6 @@ Redistribution and use in source and binary forms, with or without modification,
 
 * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
 
-* Neither the name of pyrobot nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+* Neither the name of robobrowser nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

CONTRIBUTING.rst

@@ -24,7 +24,7 @@ clean-pyc:
 	find . -name '*~' -exec rm -f {} +
 
 lint:
-	flake8 pyrobot tests
+	flake8 robobrowser tests
 
 test:
 	python setup.py test
@@ -33,15 +33,15 @@ test-all:
 	tox
 
 coverage:
-	coverage run --source pyrobot setup.py test
+	coverage run --source robobrowser setup.py test
 	coverage report -m
 	coverage html
 	open htmlcov/index.html
 
 docs:
-	rm -f docs/pyrobot.rst
+	rm -f docs/robobrowser.rst
 	rm -f docs/modules.rst
-	sphinx-apidoc -o docs/ pyrobot
+	sphinx-apidoc -o docs/ robobrowser
 	$(MAKE) -C docs clean
 	$(MAKE) -C docs html
 	open docs/_build/html/index.html

LICENSE

@@ -1,55 +1,62 @@
-PyRobot: Your friendly neighborhood web scraper
+RoboBrowser: Your friendly neighborhood web scraper
 ===============================================
 
-.. image:: https://badge.fury.io/py/pyrobot.png
-    :target: http://badge.fury.io/py/pyrobot
+.. image:: https://badge.fury.io/py/robobrowser.png
+    :target: http://badge.fury.io/py/robobrowser
 
-.. image:: https://travis-ci.org/jmcarp/pyrobot.png?branch=master
-        :target: https://travis-ci.org/jmcarp/pyrobot
+.. image:: https://travis-ci.org/jmcarp/robobrowser.png?branch=master
+        :target: https://travis-ci.org/jmcarp/robobrowser
 
-.. image:: https://coveralls.io/repos/jmcarp/pyrobot/badge.png?branch=master
-        :target: https://coveralls.io/r/jmcarp/pyrobot
+.. image:: https://coveralls.io/repos/jmcarp/robobrowser/badge.png?branch=master
+        :target: https://coveralls.io/r/jmcarp/robobrowser
 
-Homepage: `http://pyrobot.readthedocs.org/ <http://pyrobot.readthedocs.org/>`_
+Homepage: `http://robobrowser.readthedocs.org/ <http://robobrowser.readthedocs.org/>`_
+
+RoboBrowser is a simple, Pythonic library for browsing the web without a standalone web browser. RoboBrowser
+can fetch a page, click on links and buttons, and fill out and submit forms. If you need to interact with services
+that don't have APIs, RoboBrowser can help.
 
 .. code-block:: python
     
     import re
-    from pyrobot import RoboBrowser
+    from robobrowser import RoboBrowser
     
     # Browse to Rap Genius
     browser = RoboBrowser(history=True)
     browser.open('http://rapgenius.com/')
     
     # Search for Queen
-    form = browser.get_form(action=re.compile(r'search'))
+    form = browser.get_form(action='/search')
+    form            # <RoboForm q=>
     form['q'].value = 'queen'
     browser.submit_form(form)
 
     # Look up the first song
     songs = browser.select('.song_name')
     browser.follow_link(songs[0])
-    lyrics = browser.find(class_=re.compile(r'\blyrics\b'))
-    lyrics.text     # \n[Intro]\nIs this the real life...
+    lyrics = browser.select('.lyrics')
+    lyrics[0].text     # \n[Intro]\nIs this the real life...
     
     # Back to results page
     browser.back()
 
     # Look up my favorite song
     browser.follow_link('death on two legs')
+
+    # Can also search HTML using regex patterns
     lyrics = browser.find(class_=re.compile(r'\blyrics\b'))
     lyrics.text     # \n[Verse 1]\nYou suck my blood like a leech...
 
-PyRobot combines the best of two excellent Python libraries: 
+RoboBrowser combines the best of two excellent Python libraries: 
 `Requests <http://docs.python-requests.org/en/latest/>`_ and 
 `BeautifulSoup <http://www.crummy.com/software/BeautifulSoup/>`_. 
-PyRobot represents browser sessions using Requests and HTML responses 
+RoboBrowser represents browser sessions using Requests and HTML responses 
 using BeautifulSoup, transparently exposing methods of both libraries:
 
 .. code-block:: python
 
     import re
-    from pyrobot import RoboBrowser
+    from robobrowser import RoboBrowser
 
     browser = RoboBrowser(user_agent='a python robot')
     browser.open('https://github.com/')
@@ -58,7 +65,7 @@ using BeautifulSoup, transparently exposing methods of both libraries:
     browser.session.cookies['_gh_sess']         # BAh7Bzo...
     browser.session.headers['User-Agent']       # a python robot
 
-    # Searched the parsed HTML
+    # Search the parsed HTML
     browser.select('div.teaser-icon')       # [<div class="teaser-icon">
                                             # <span class="mega-octicon octicon-checklist"></span>
                                             # </div>,
@@ -68,24 +75,26 @@ using BeautifulSoup, transparently exposing methods of both libraries:
                                                         # <span class="mega-octicon octicon-checklist"></span>
                                                         # ...
 
-PyRobot also includes tools for working with forms, inspired by
+RoboBrowser also includes tools for working with forms, inspired by
 `WebTest <https://github.com/Pylons/webtest>`_ and `Mechanize <http://wwwsearch.sourceforge.net/mechanize/>`_.
 
 .. code-block:: python
     
-    from pyrobot import Browser
+    from robobrowser import RoboBrowser
+
     browser = RoboBrowser()
+    browser.open('http://twitter.com')
 
     # Get the signup form
     signup_form = browser.get_form(class_='signup')
-    signup_form                     # <RoboForm user[name]=, user[email]=, ...
+    signup_form         # <RoboForm user[name]=, user[email]=, ...
 
     # Inspect its values
     signup_form['authenticity_token'].value     # 6d03597 ...
 
     # Fill it out
-    signup_form['user[name]'] = 'python-robot'
-    signup_form['user[user_password]'] = 'secret'
+    signup_form['user[name]'].value = 'python-robot'
+    signup_form['user[user_password]'].value = 'secret'
 
     # Serialize it to JSON
     signup_form.serialize()         # {'data': {'authenticity_token': '6d03597...',
@@ -97,3 +106,13 @@ PyRobot also includes tools for working with forms, inspired by
     # And submit
     browser.submit_form(signup_form)
 
+Requirements
+------------
+
+- Python >= 2.6 or >= 3.3
+
+License
+-------
+
+MIT licensed. See the bundled `LICENSE <https://github.com/jmcarp/robobrowser/blob/master/LICENSE>`_ file for more details.
+

Makefile

@@ -1,3 +1,5 @@
+-r requirements.txt
+
 coverage
 coveralls
 nose

README.rst

@@ -6,18 +6,18 @@ API Reference
 browser
 ------------
 
-.. automodule:: pyrobot.browser
+.. automodule:: robobrowser.browser
     :members:
 
 form
 ------------
 
-.. automodule:: pyrobot.forms.form
+.. automodule:: robobrowser.forms.form
     :members:
 
 fields
 ------------
 
-.. automodule:: pyrobot.forms.fields
+.. automodule:: robobrowser.forms.fields
     :members:
     :inherited-members: