https://github.com/FastestMolasses/fBrowser
Helpful Selenium functions to make web-scraping easier and faster
https://github.com/FastestMolasses/fBrowser
helper-functions python3 selenium selenium-functions selenium-python webscraper webscraping
Last synced: 4 months ago
JSON representation
Helpful Selenium functions to make web-scraping easier and faster
- Host: GitHub
- URL: https://github.com/FastestMolasses/fBrowser
- Owner: FastestMolasses
- License: mit
- Created: 2018-10-11T06:53:45.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-12T15:09:14.000Z (almost 6 years ago)
- Last Synced: 2024-11-11T05:41:02.994Z (12 months ago)
- Topics: helper-functions, python3, selenium, selenium-functions, selenium-python, webscraper, webscraping
- Language: Python
- Size: 21.5 KB
- Stars: 18
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# fBrowser | Quick-start Your Selenium Project
This library was created in order to help users quick-start their webscraping project. It includes several useful functions including a browser handler, new tab functionality, and more.
## Installation
```
$ pip3 install fBrowser
```
## Usage
### Browser Handler
You can decorate your function with a browserHandler. This will create the driver and properly quit it if an exception occurs or when the program ends.
```python
from time import sleep
from fBrowser import browserHandler
@browserHandler()
def main(driver):
driver.get('https://www.google.com')
sleep(5)
main()
```
You can also pass in these optional arguments:
```python
@browserHandler(path='', firefox=False, proxy=':',
headless=True, implicitWaitTime=60, incognito=True)
```
### New Tab
Run a function in a new tab of Chrome. It will automatically close and switch contexts when it finishes executing.
You can use the `newTab` function to decorate your selenium functions. Doing so will execute your function in a new tab of the browser. Your decorated function must have its first parameter for the webdriver.
```python
from time import sleep
from fBrowser import browserHandler, newTab
@newTab
def loadTheVerge(driver):
driver.get('https://www.theverge.com')
sleep(2)
@browserHandler()
def main(driver):
driver.get('https://www.google.com')
sleep(2)
loadTheVerge(driver)
main()
```
### Login
Use this helper function to login into a site. Simply pass in your email / username and your password. (This function assumes that the input tags in the form have attributes @type=username, @type=email, or @type=password).
```python
import fBrowser
from fBrowser import browserHandler
@browserHandler()
def main(driver):
driver.get(
'https://stackoverflow.com/users/login')
fBrowser.login(driver, email='testing@gmail.com', password='abc123')
main()
```
### Fill Inputs
Quickly fill multiple inputs with either a single value or multiple values.
```python
import fBrowser
from fBrowser import browserHandler
@browserHandler()
def main(driver):
driver.get('example.com')
# A list of xpaths to the inputs
xpaths = ['//*[@name="foo"]', '//*[@name="bar"]', '//@name="fooBar"']
# Fill with multiple values
fBrowser.fillInputs(driver, xpaths, ['value1', 'value2', 'value3'])
# Or pass in one value
fBrowser.fillInputs(driver, xpaths, 'hello world')
main()
```
### Human Type
Don't want to get flagged as a bot? Fill your inputs using a human-like typing speed.
```python
import fBrowser
from time import sleep
from fBrowser import browserHandler
@browserHandler()
def main(driver):
driver.get('https://www.google.com')
chatInput = driver.find_element_by_xpath('//*[@name="q"]')
# Will input the string at a human-like typing speed
fBrowser.humanType(driver, chatInput, 'Hello world!')
sleep(5)
main()
```
## Contributing
1. Fork it ()
2. Create your feature branch (`git checkout -b feature/fooBar`)
3. Commit your changes (`git commit -am 'Add some fooBar'`)
4. Push to the branch (`git push origin feature/fooBar`)
5. Create a new Pull Request