Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fill HTML login forms automatically
Branch: master

Merge pull request #10 from orthographic-pedant/spell_check/available

Fixed typographical error, changed availabe to available in README.
latest commit ab3a58e9f6
@pablohoffman pablohoffman authored


loginform Coverage report

loginform is a library for filling HTML login forms given the login url, username & password. Which form and fields to fill are inferred automatically.

It's implemented on top of lxml form filling, and thus depends on lxml.


Usage is very simple and best illustrated with an example:

>>> from loginform import fill_login_form
>>> import requests
>>> url = ""
>>> r = requests.get(url)
>>> fill_login_form(url, r.text, "john", "secret")
([('authenticity_token', 'FQgPiKd1waDL+pycPH8IGutirTnP69SiZgm0zXwn+VQ='),
  ('login', 'john'),
  ('password', 'secret')],

And it is possible to use it as a tool to quickly debug a login form:

$ python -m loginform -u john -p secret
method: POST
- authenticity_token: FQgPiKd1waDL+pycPH8IGutirTnP69SiZgm0zXwn+VQ=
- login: john
- password: secret


A collection of real-world samples is used to keep this library tested. Those samples are managed as follows:

First, you select a site to try, find out its login url, and run the following command to try loginform on it:

$ python

From the output you can judge if it worked or not. If it worked, great. If it didn't, you would hack to make it work and then add the sample with:

$ python -w github

Note that we gave the sample a name (github in this case).

To list all available samples use:

$ python -l

To run all tests, install tox and run:

$ tox
Something went wrong with that request. Please try again.