Tutorials or documentation?

[DedrichVonDorn]

Are there any tutorials or documentation available for this? Something a bit more robust than the example of logging into GitHub?

[hickford]

You're right, there should be.

There's a small example of form submission in the tests, if it helps. My own code using the library I can't publish.

Leaving this open, I'd like to write a Sphinx / readthedocs site.

[halhx]

Form Submission isn't good. I've just forked and will make some improvements there. Do you have a process for contributing code back?

[scarrick68]

Commenting to bring this back up. More in depth form example with submissions on consecutive pages, filling in select field (i mean elements), how to press a button on a page would all be very helpful.

[scarrick68]

The github example on the home page is unclear. I'm assuming this section

verify we are now logged in

messages = page2.soup.find('div', class_='flash-messages')
if messages:
print(messages.text)
assert page2.soup.select(".logout-form")

Checks for a div with that class which should only be present after log in. However, there is no div with class='flash-messages' on the login page or after being logged in. I checked in Chrome's console. the assert statement also didn't print anything when I ran the example.

print(page2.soup.title.text)

just prints "Github"

[moy]

I have some pieces of code using MechanicalSoup here: https://gitlab.com/chamilotools/chamilotools if anyone wants example. I think a "Projects using MechanicalSoup" section could be added to the README of MechanicalSoup so that people looking for examples can find more.

[eoghanmurray]

And another example (unfortunately an account is needed to see it in action, but might be useful as an example of a login/download/unzip-files pattern):
https://github.com/GoPixie/rdg-to-db/blob/master/download

[moy]

OK, there's now a tutorial on http://mechanicalsoup.readthedocs.io/en/latest/, and there's a separate issue at #114 to track remaining missing docs.