1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
Metadata-Version: 2.1
Name: mechanize
Version: 0.4.8
Summary: Stateful, programmatic web browsing
Home-page: https://github.com/python-mechanize/mechanize
Author: Kovid Goyal
Author-email: no@no.no
License: BSD
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: File Transfer Protocol (FTP)
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management :: Link Checking
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Traffic Generation
Classifier: Topic :: System :: Archiving :: Mirroring
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Markup
Classifier: Topic :: Text Processing :: Markup :: HTML
Classifier: Topic :: Text Processing :: Markup :: XML
Provides-Extra: fast
Provides-Extra: test
Provides-Extra: binarytest
License-File: LICENSE
mechanize - Automate interaction with HTTP web servers
##########################################################
|pypi| |build|
.. contents::
Major features
-----------------
Stateful programmatic web browsing in Python
- The browser class `mechanize.Browser` implements the
interface of `urllib2.OpenerDirector`, so any URL can
be opened not just `http`.
- Easy HTML form filling.
- Convenient link parsing and following.
- Browser history (`.back()` and `.reload()` methods).
- The `Referer` HTTP header is added properly (optional).
- Automatic observance of `robots.txt <http://www.robotstxt.org/wc/norobots.html>`_.
- Automatic handling of HTTP-Equiv and Refresh.
Installation
-----------------
To install for normal usage:
.. code-block:: bash
pip3 install mechanize
To install for development:
.. code-block:: bash
git clone https://github.com/python-mechanize/mechanize.git
cd mechanize
pip3 install -e .
To install manually, simply add the `mechanize` sub-directory somewhere on your
`PYTHONPATH`.
Documentation
---------------
See https://mechanize.readthedocs.io/en/latest/
Credits
-----------------
python-mechanize was the creation of John J. Lee. Maintenance was taken over by
Kovid Goyal in 2017.
Much of the code was originally derived from the work of the following people:
- Gisle Aas -- [libwww-perl]
- Jeremy Hylton (and many others) -- [urllib2]
- Andy Lester -- [WWW::Mechanize]
- Johnny Lee (coincidentally-named) -- MSIE CookieJar Perl code from which
mechanize's support for that is derived.
Also:
- Gary Poster and Benji York at Zope Corporation -- contributed significant
changes to the HTML forms code
- Ronald Tschalar -- provided help with Netscape cookies
Thanks also to the many people who have contributed bug reports and
patches.
.. |pypi| image:: https://img.shields.io/pypi/v/mechanize.svg?label=version
:target: https://pypi.python.org/pypi/mechanize
:alt: Latest version released on PyPi
.. |build| image:: https://dev.azure.com/divok/mechanize/_apis/build/status/python-mechanize.mechanize?branchName=master
:target: https://dev.azure.com/divok/mechanize/_build/latest?definitionId=3&branchName=master
:alt: Build status of the master branch
|
