Skip to main content

Google Forms wrapper for Python

Project description

GForms

A python wrapper for public Google Forms.

This package does not implement form editing / sharing / other actions with user-owned forms

Installation

python3 -m pip install gforms

Features

  • Form parsing
    • All form settings are parsed
    • Multi-page forms are supported
    • Elements with input validation are supported
  • Form filling
    • Fill the entire form using a single callback function (see example)
    • Fill individual elements
    • Validate the form before submission
  • Form submission
    • Faster submission for multi-page forms (history emulation)

Limitations

  • Forms with required sign-in cannot be submitted
  • Forms with file upload cannot be parsed (sign-in is required for loading the form)
  • A CAPTCHA needs to be solved in order to send an e-mail with a response copy (when this option is enabled). CAPTCHA handling should be implemented separately
  • Form style is not parsed

Example

See example.py for more details.

from gforms import Form
from gforms.elements import Short, Value

def callback(element, page_index, element_index):
    # fill an element based on its position
    if page_index == 0 and element_index == 1:
        return 'Yes'
    # fill an element based on its type and name
    if isinstance(element, Short) and element.name == 'Your opinion:':
        return input(element.name)
    # fill choice elements with random values, skip optional elements if fill_optional is not used
    return Value.DEFAULT

url = 'https://docs.google.com/forms/d/e/.../viewform'

form = Form()

form.load(url)
print(form.to_str(indent=2))  # a text representation, may be useful for CLI applications

form.fill(callback)
form.submit()

# Faster submission for multi-page forms (use only one POST request)
# (in theory, you may get banned, but now the actual number of requests isn't checked)
form.submit(emulate_history=True)

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

gforms-1.2.2.tar.gz (30.4 kB view hashes)

Uploaded Source

Built Distribution

gforms-1.2.2-py3-none-any.whl (32.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page