Skip to main content

Selenium based, user friendly Browser Automation API

Project description


For documentation, refer here

Here is a quick example,

from pybrowser import Browser 
    with Browser(browser_name=Browser.CHROME) as b:
        screenshot_path = b.take_screenshot()

Release Notes:


  • Changes

    • Changes in underlying Browser.requests_session object,

      • requests_session.result has been removed. There is just requests_session.response which is a blocking call (in case asynch flag is set). Also note, requests_session.is_request_done is still available to see if request is complete of not. There are no changes to other properties and are blocking in case of asynchronous call.

      • requests_session.content() method with options for bytes and text has been changed to properties, just like in underlying requests. That is now you call, requests_session.content for bytes and requests_session.text for text.

      • In context of above changes, Browser object also has below changes,

        • Browser.get and now returns requests_session object (used to be requests_session.response).
        • Browser.content() has been changed to properties. That is now you call, Browser.content for bytes and Browser.text for text.
  • New features

    • Support for remote url. Please note this requires Selenium Grid to be setup explicitly. Once done use the URL here.

    • Flags for Opera browser (Browser.OPERA). Webdriver executable needs to be present in driver_path. Please note EDGE and SAFARI are also supported the same way. That is, webdriver isn't automatically downloaded, instead path needs to be provided.


  • Changes

    Please note some key changes with regards to properties changing to methods.

    • Methods which were properties in initial release are now method calls. Below is the impacted list.

      In Browser,

      • Browser.refresh()
      • Browser.back()
      • Browser.forward()
      • Browser.maximize_window()
      • Browser.minimize_window()
      • Browser.fullscreen_window()
      • Browser.delete_all_cookies()
      • Browser.close()

      In Action (used by all elements),

      • Action.refresh()
      • Action.highlight()
      • Action.double_click()
      • Action.move_to_element()

      Specific elements also,

      • Checkbox.check()
      • Checkbox.uncheck()
      • Radio.unselect()
      • Input.clear()
    • Browser class __init__ method now has more options,

      • firefox_binary_path
      • firefox_profile_path
      • http_proxy
      • driver_path
    • Select element has below method changes,

      Select.options(get="text") method has been split to multiple properties to keep it simple,

      • Select.options_text
      • Select.options_value
      • Select.options_element

      Similar change has been done for Select.all_selected_options(get="text"),

      • Select.all_selected_options_text
      • Select.all_selected_options_value
      • Select.all_selected_options_element
    • File element changes,

      Below enhancements have been made to download feature,

      • Added more parameters -

        • unzip - Set this flag to unzip file. Default is False
        • del_zipfile - Set this flag to delete zip file after it has been unzipped. Default is False
        • add_to_ospath - Set this flag to add directory to PATH. Default is False
      • New properties -

        As you might already know, download happens in background (asynchronous) by default and can of course be changed with asynch. To check if download was successful, below properties are available,

        • is_download_complete - True or False
        • downloaded_files - list of downloaded files
    • HTML links method has below method changes,

      This is the one you would invoke via Browser as Browser.html()

      • Added more parameters -

        • images - You can filter out images. Default is False that means to include images, you will need to set this to True
        • name_length_limit - This limits the length of name of the url. Default is 60
      • Change in return type. Before this change, return type was a list of types (name, url). This has been changed to list of named_tuples of form ('Link', ['name', 'url'])

    • Changes in some env options.

      Removed below options as they don't have sense. Either you provide complete driver download url or provide version so that the API tries to download,


      Added below for Firefox support,

    • Refactoring (non functional) in code and tests. Lot more testing needed still :-\

  • New features

    • Support for Firefox !


  • Very first release !

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

get-pybrowser-0.2.0.tar.gz (39.0 kB view hashes)

Uploaded source

Built Distribution

get_pybrowser-0.2.0-py3-none-any.whl (47.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page