https://github.com/sparklemotion/mechanize

Mechanize is a ruby library that makes automated web interaction easy.
https://github.com/sparklemotion/mechanize

ruby scraping web

Last synced: 15 days ago
JSON representation

Mechanize is a ruby library that makes automated web interaction easy.

• Host: GitHub
• URL: https://github.com/sparklemotion/mechanize
• Owner: sparklemotion
• License: mit
• Created: 2008-04-18T16:55:10.000Z (over 16 years ago)
• Default Branch: main
• Last Pushed: 2024-08-21T20:36:14.000Z (3 months ago)
• Last Synced: 2024-08-21T22:48:15.976Z (3 months ago)
• Topics: ruby, scraping, web
• Language: Ruby
• Homepage: https://www.rubydoc.info/gems/mechanize/
• Size: 2.55 MB
• Stars: 4,389
• Watchers: 87
• Forks: 474
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-ruby-toolbox - Mechanize - The Mechanize library is used for automating interaction with websites. Mechanize automatically stores and sends cookies, follows redirects, and can follow links and submit forms. Form fields can be populated and submitted. Mechanize also keeps track of the sites that you have visited as a history. (Web Apps, Services & Interaction / HTTP clients)

README

        
# Mechanize

* https://www.rubydoc.info/gems/mechanize/

* https://github.com/sparklemotion/mechanize

[![Test suite](https://github.com/sparklemotion/mechanize/actions/workflows/ci.yml/badge.svg)](https://github.com/sparklemotion/mechanize/actions/workflows/ci.yml)

## Description

The Mechanize library is used for automating interaction with websites. Mechanize automatically stores and sends cookies, follows redirects, and can follow links and submit forms.  Form fields can be populated and submitted. Mechanize also keeps track of the sites that you have visited as a history.

## Dependencies

* Ruby >= 2.6

* Gems:

  * `addressable`

  * `domain_name`

  * `http-cookie`

  * `mime-types`

  * `net-http-digest_auth`

  * `net-http-persistent`

  * `nokogiri`

  * `rubyntlm`

  * `webrick`

  * `webrobots`

## Support:

The bug tracker is available here:

* https://github.com/sparklemotion/mechanize/issues

## Examples

If you are just starting, check out [GUIDE.rdoc](https://github.com/sparklemotion/mechanize/blob/main/GUIDE.rdoc) or [EXAMPLES.rdoc](https://github.com/sparklemotion/mechanize/blob/main/EXAMPLES.rdoc).

## Developers

Use bundler to install dependencies:

```

bundle install

```

Run all tests with:

```

bundle exec rake test

```

See also Mechanize::TestCase to read about the built-in testing infrastructure.

## Authors

* Eric Hodel

* Akinori MUSHA

* Aaron Patterson

* Lee Jarvis

* Mike Dalessio

## Acknowledgments

This library was heavily influenced by its namesake in the Perl world.  A big

thanks goes to [Andy Lester](http://petdance.com), the author of the original Perl module WWW::Mechanize which is available [here](http://search.cpan.org/dist/WWW-Mechanize/). Ruby Mechanize would not be around without you!

Thank you to Michael Neumann for starting the Ruby version. Thanks to everyone who's helped out in various ways. Finally, thank you to the people using this library!

## License

This library is distributed under the MIT license. Please see [LICENSE.txt](https://github.com/sparklemotion/mechanize/blob/main/LICENSE.txt).