formelement 0.1.0__py3-none-any.whl

formelement/__init__.py

@@ -0,0 +1,15 @@
+"""Public package interface for formelement."""
+
+from .answer_patterns import AnswerPatternGenerator, dataGoogleForm
+from .field_types import AnswerFieldType, dataPilihan
+from .google_form_browser import GoogleFormBrowser
+from .google_form_submit import submit_answers
+
+__all__ = [
+    "AnswerFieldType",
+    "AnswerPatternGenerator",
+    "GoogleFormBrowser",
+    "dataGoogleForm",
+    "dataPilihan",
+    "submit_answers",
+]

formelement/answer_patterns.py

@@ -0,0 +1,141 @@
+import random
+
+
+class AnswerPatternGenerator:
+    def hitungUsia(self, batasAwal: int, batasAkhir: int) -> int:
+        return random.randint(batasAwal, batasAkhir)
+
+    def pilihTipe(self, jenis: list[int]) -> int:
+        data: list[int] = []
+
+        for i in range(len(jenis)):
+            if jenis[i] != 0:
+                data.append(i)
+
+        return random.sample(data, 1)[0]
+
+    def pilihanCheckbox(self, awal: int, akhir: int, banyakData: int) -> list[int]:
+        temp = random.randint(1, banyakData)
+
+        listData: list[int] = []
+        i = awal
+        while i <= akhir:
+            listData.append(i)
+            i += 1
+
+        return random.sample(listData, temp)
+
+    def polaJawab1(
+        self,
+        pola: int,
+        awal: int,
+        banyakSoal: int,
+        kelipatan: int,
+    ) -> list[int]:
+        p = awal
+        hasil: list[int] = []
+        for _ in range(banyakSoal):
+            hasil.append(p)
+            p += kelipatan
+        return hasil
+
+    def polaJawab2(
+        self,
+        pola: int,
+        awal: int,
+        banyakSoal: int,
+        kelipatan: int,
+    ) -> list[int]:
+        p = awal
+        hasil: list[int] = []
+        for _ in range(banyakSoal):
+            if pola == 0:
+                s1 = random.choice([p, p + 1])
+            elif pola == 1:
+                s1 = random.choice([p, p + 1, p + 1])
+            elif pola == 2:
+                s1 = random.choice([p, p + 1, p + 1, p + 1])
+            elif pola == 3:
+                s1 = random.choice([p, p, p + 1])
+            elif pola == 4:
+                s1 = random.choice([p, p, p, p + 1])
+            else:
+                s1 = random.choice([p, p + 1])
+
+            hasil.append(s1)
+        return hasil
+
+    def polaJawab3(
+        self,
+        pola: int,
+        awal: int,
+        banyakSoal: int,
+    ) -> list[int]:
+        p = awal
+        hasil: list[int] = []
+        for _ in range(banyakSoal):
+            if pola == 0:
+                s1 = random.choice([p, p + 1, p + 2])
+            elif pola == 1:
+                s1 = random.choice([p, p + 1, p + 1, p + 2, p + 2])
+            elif pola == 2:
+                s1 = random.choice([p, p + 1, p + 1, p + 1, p + 2, p + 2, p + 2])
+            elif pola == 3:
+                s1 = random.choice(
+                    [p, p + 1, p + 1, p + 1, p + 1, p + 2, p + 2, p + 2, p + 2]
+                )
+            elif pola == 4:
+                s1 = random.choice([p, p, p + 1, p + 1, p + 2])
+            elif pola == 5:
+                s1 = random.choice([p, p, p, p + 1, p + 1, p + 1, p + 2])
+            elif pola == 6:
+                s1 = random.choice([p, p, p, p, p + 1, p + 1, p + 1, p + 1, p + 2])
+            elif pola == 7:
+                s1 = random.choice([p, p, p + 1, p + 1, p + 1, p + 2])
+            else:
+                s1 = random.choice([p, p + 1, p + 2])
+
+            hasil.append(s1)
+        return hasil
+
+    def polaJawab4(
+        self,
+        pola: int,
+        awal: int,
+        banyakSoal: int,
+        kelipatan: int,
+    ) -> list[int]:
+        p = awal
+        hasil: list[int] = []
+        for _ in range(banyakSoal):
+            if pola == 0:
+                s1 = random.choice([p, p + 1, p + 2, p + 3])
+            elif pola == 1:
+                s1 = random.choice([p, p + 1, p + 1, p + 2, p + 2, p + 3, p + 3])
+            elif pola == 2:
+                s1 = random.choice(
+                    [p, p + 1, p + 1, p + 1, p + 2, p + 2, p + 2, p + 3, p + 3, p + 3]
+                )
+            else:
+                s1 = random.choice([p, p + 1, p + 2, p + 3])
+
+            hasil.append(s1)
+            p += kelipatan
+        return hasil
+
+    def polaJawabCustom(
+        self,
+        awal: int,
+        soal: list[int],
+        kelipatan: int,
+    ) -> list[int]:
+        p = awal
+        hasil: list[int] = []
+        for i in range(len(soal)):
+            s1 = soal[i] + p
+            hasil.append(s1)
+            p += kelipatan
+        return hasil
+
+
+dataGoogleForm = AnswerPatternGenerator

formelement/field_types.py

@@ -0,0 +1,15 @@
+from enum import Enum
+
+
+class AnswerFieldType(Enum):
+    ISIANPENDEK = 0
+    ISIANPANJANG = 1
+    KEBAWAH = 2
+    KESAMPING = 3
+    CHECKBOX = 4
+    LAINNYA = 5
+    DROPDOWN = 6
+    BUBBLE = 7
+
+
+dataPilihan = AnswerFieldType

formelement/google_form_browser.py

@@ -0,0 +1,152 @@
+import random
+import time
+
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webelement import WebElement
+
+from .field_types import AnswerFieldType as pil
+
+
+class GoogleFormBrowser:
+    driver: webdriver.Firefox
+
+    def __init__(self, driver: webdriver.Firefox):
+        self.driver = driver
+
+    def pindahHalaman(self):
+        time.sleep(3)
+        submit_button = self.driver.find_elements(By.XPATH, "//span[contains(text(), 'Berikutnya')]")
+        submit_button[0].click()
+
+    def kirim(self):
+        time.sleep(3)
+        submit_button = self.driver.find_elements(By.XPATH, "//span[contains(text(), 'Kirim')]")
+        submit_button[0].click()
+
+    def kirimJawaban(self):
+        time.sleep(2)
+        submit_button = self.driver.find_elements(By.XPATH, "//a[contains(text(), 'Kirim')]")
+        submit_button[0].click()
+
+    def tombol(self, pilihan: pil) -> list[WebElement]:
+        if pilihan == pil.ISIANPENDEK:
+            return self.driver.find_elements("css selector", ".whsOnd")
+        if pilihan == pil.ISIANPANJANG:
+            return self.driver.find_elements("css selector", ".KHxj8b")
+        if pilihan == pil.KEBAWAH:
+            return self.driver.find_elements("css selector", ".nWQGrd")
+        if pilihan == pil.KESAMPING:
+            return self.driver.find_elements("css selector", ".T5pZmf")
+        if pilihan == pil.CHECKBOX:
+            return self.driver.find_elements("css selector", ".uHMk6b")
+        if pilihan == pil.LAINNYA:
+            return self.driver.find_elements("css selector", ".Hvn9fb")
+        if pilihan == pil.DROPDOWN:
+            return self.driver.find_elements("css selector", ".ry3kXd")
+        if pilihan == pil.BUBBLE:
+            return self.driver.find_elements("css selector", ".AB7Lab")
+        return []
+
+    def pilihDropdown(self, pilihan: str):
+        time.sleep(2)
+        option = self.driver.find_elements(By.XPATH, f"//span[contains(text(), '{pilihan}')]")
+        option[len(option) - 1].click()
+
+    def hitungUsia(self, batasAwal: int, batasAkhir: int) -> int:
+        return random.randint(batasAwal, batasAkhir)
+
+    def pilihTipe(self, jenis: list[int]) -> int:
+        data: list[int] = []
+
+        for i in range(len(jenis)):
+            if jenis[i] != 0:
+                data.append(i)
+
+        return random.sample(data, 1)[0]
+
+    def pilihanCheckbox(self, awal: int, akhir: int, banyakData: int) -> list[int]:
+        temp = random.randint(1, banyakData)
+
+        listData: list[int] = []
+        i = awal
+        while i <= akhir:
+            listData.append(i)
+            i += 1
+
+        return random.sample(listData, temp)
+
+    def polaJawab1(self, pola: int, awal: int, banyakSoal: int, kelipatan: int, jawab: list[WebElement]):
+        p = awal
+        for _ in range(banyakSoal):
+            jawab[p].click()
+            p += kelipatan
+
+    def polaJawab2(self, pola: int, awal: int, banyakSoal: int, kelipatan: int, jawab: list[WebElement]):
+        p = awal
+        for _ in range(banyakSoal):
+            if pola == 0:
+                s1 = random.choice([p, p + 1])
+            elif pola == 1:
+                s1 = random.choice([p, p + 1, p + 1])
+            elif pola == 2:
+                s1 = random.choice([p, p + 1, p + 1, p + 1])
+            elif pola == 3:
+                s1 = random.choice([p, p, p + 1])
+            elif pola == 4:
+                s1 = random.choice([p, p, p, p + 1])
+            else:
+                s1 = random.choice([p, p + 1])
+
+            jawab[s1].click()
+            p += kelipatan
+
+    def polaJawab3(self, pola: int, awal: int, banyakSoal: int, kelipatan: int, jawab: list[WebElement]):
+        p = awal
+        for _ in range(banyakSoal):
+            if pola == 0:
+                s1 = random.choice([p, p + 1, p + 2])
+            elif pola == 1:
+                s1 = random.choice([p, p + 1, p + 1, p + 2, p + 2])
+            elif pola == 2:
+                s1 = random.choice([p, p + 1, p + 1, p + 1, p + 2, p + 2, p + 2])
+            elif pola == 3:
+                s1 = random.choice([p, p + 1, p + 1, p + 1, p + 1, p + 2, p + 2, p + 2, p + 2])
+            elif pola == 4:
+                s1 = random.choice([p, p, p + 1, p + 1, p + 2])
+            elif pola == 5:
+                s1 = random.choice([p, p, p, p + 1, p + 1, p + 1, p + 2])
+            elif pola == 6:
+                s1 = random.choice([p, p, p, p, p + 1, p + 1, p + 1, p + 1, p + 2])
+            elif pola == 7:
+                s1 = random.choice([p, p, p + 1, p + 1, p + 1, p + 2])
+            else:
+                s1 = random.choice([p, p + 1, p + 2])
+
+            jawab[s1].click()
+            p += kelipatan
+
+    def polaJawab4(self, pola: int, awal: int, banyakSoal: int, kelipatan: int, jawab: list[WebElement]):
+        p = awal
+        for _ in range(banyakSoal):
+            if pola == 0:
+                s1 = random.choice([p, p + 1, p + 2, p + 3])
+            elif pola == 1:
+                s1 = random.choice([p, p + 1, p + 1, p + 2, p + 2, p + 3, p + 3])
+            elif pola == 2:
+                s1 = random.choice([p, p + 1, p + 1, p + 1, p + 2, p + 2, p + 2, p + 3, p + 3, p + 3])
+            else:
+                s1 = random.choice([p, p + 1, p + 2, p + 3])
+
+            jawab[s1].click()
+            p += kelipatan
+
+    def polaJawabCustom(self, awal: int, soal: list[int], kelipatan: int, jawab: list[WebElement]):
+        p = awal
+        for i in range(len(soal)):
+            s1 = soal[i] + p
+            jawab[s1].click()
+            p += kelipatan
+
+
+dataGoogleForm = GoogleFormBrowser

formelement/google_form_submit.py

@@ -0,0 +1,174 @@
+import json
+import time
+from importlib import import_module
+from typing import Dict, Iterable, List, Optional, Sequence, Tuple
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+POST_URL_TEMPLATE = "https://docs.google.com/forms/d/e/{form_id}/formResponse"
+
+
+def _load_data_module(module_name: str):
+    return import_module(module_name)
+
+
+def _ensure_pages_aligned(
+    entry_ids: Sequence[Sequence[str]],
+    answers: Sequence[Sequence[str]],
+) -> None:
+    if len(entry_ids) != len(answers):
+        raise ValueError(
+            "Answer pages do not match FORM_ENTRY_IDS pages. "
+            f"Expected {len(entry_ids)}, got {len(answers)}."
+        )
+
+    for index, (ids, values) in enumerate(zip(entry_ids, answers)):
+        if len(ids) != len(values):
+            raise ValueError(
+                f"Answer count on page {index + 1} mismatches FORM_ENTRY_IDS "
+                f"(expected {len(ids)}, got {len(values)})."
+            )
+
+
+def _compute_page_history(total_pages: int) -> str:
+    if total_pages <= 0:
+        return "0"
+    return ",".join(str(i) for i in range(total_pages))
+
+
+def _extract_entry_token(entry_id: str) -> int:
+    try:
+        return int(entry_id.split(".", 1)[1])
+    except (IndexError, ValueError) as error:
+        raise ValueError(f"Invalid entry id format: {entry_id}") from error
+
+
+def _build_partial_response(
+    entry_pages: Sequence[Sequence[str]],
+    answer_pages: Sequence[Sequence[str]],
+    session_state: str,
+) -> Optional[str]:
+    entries: List[List[object]] = []
+    for ids, values in zip(entry_pages, answer_pages):
+        for entry_id, answer in zip(ids, values):
+            entries.append(
+                [
+                    None,
+                    _extract_entry_token(entry_id),
+                    [answer],
+                    0,
+                ]
+            )
+
+    if not entries:
+        return None
+
+    payload: List[object] = [entries, None]
+    if session_state:
+        payload.append(session_state)
+
+    return json.dumps(payload, separators=(",", ":"))
+
+
+def _build_payload(
+    entry_ids: Sequence[Sequence[str]],
+    answers: Sequence[Sequence[str]],
+    session_state: str,
+    fbzx: Optional[str] = None,
+) -> Dict[str, str]:
+    total_pages = len(entry_ids)
+    last_page_ids = entry_ids[-1] if entry_ids else []
+    last_page_answers = answers[-1] if answers else []
+    timestamp_ms = str(int(time.time() * 1000))
+
+    payload: Dict[str, str] = {
+        entry_id: answer
+        for entry_id, answer in zip(last_page_ids, last_page_answers)
+    }
+
+    for entry_id in last_page_ids:
+        payload[f"{entry_id}_sentinel"] = ""
+
+    payload["dlut"] = timestamp_ms
+
+    partial = _build_partial_response(
+        entry_ids[:-1],
+        answers[:-1],
+        session_state,
+    )
+    if partial is not None:
+        payload["partialResponse"] = partial
+
+    payload["pageHistory"] = _compute_page_history(total_pages)
+    payload["fvv"] = "1"
+    if fbzx:
+        payload["fbzx"] = fbzx
+    payload["submissionTimestamp"] = timestamp_ms
+
+    return payload
+
+
+def submit_answers(
+    answers: Iterable[Iterable[str]],
+    *,
+    data_module: str = "2_data",
+    session_state: Optional[str] = None,
+    fbzx: Optional[str] = None,
+    dry_run: bool = False,
+) -> Tuple[Optional[int], Dict[str, str], str]:
+    """
+    Submit a multi-page Google Form response.
+
+    The referenced data module must expose:
+    - FORM_ID
+    - FORM_ENTRY_IDS
+    - optionally FORM_SESSION_STATE
+    - optionally FORM_FBZX
+    """
+
+    normalized_answers = [
+        [str(value) for value in page]
+        for page in answers
+    ]
+
+    module = _load_data_module(data_module)
+    form_id: str = getattr(module, "FORM_ID", "")
+    entry_ids: Sequence[Sequence[str]] = getattr(module, "FORM_ENTRY_IDS", [])
+    default_session_state: str = getattr(module, "FORM_SESSION_STATE", "")
+    default_fbzx: str = getattr(module, "FORM_FBZX", "")
+
+    if not form_id:
+        raise ValueError("FORM_ID is missing in the data module.")
+
+    entry_ids = [list(page) for page in entry_ids]
+    _ensure_pages_aligned(entry_ids, normalized_answers)
+
+    payload = _build_payload(
+        entry_ids,
+        normalized_answers,
+        session_state if session_state is not None else default_session_state,
+        fbzx if fbzx is not None else default_fbzx,
+    )
+
+    encoded = urlencode(payload)
+
+    if dry_run:
+        return None, payload, encoded
+
+    request = Request(
+        POST_URL_TEMPLATE.format(form_id=form_id),
+        data=encoded.encode("utf-8"),
+        headers={"Content-Type": "application/x-www-form-urlencoded"},
+    )
+
+    try:
+        with urlopen(request) as response:
+            response.read()
+            status = response.status
+    except HTTPError as error:
+        raise RuntimeError(f"HTTP {error.code}: {error.reason}") from error
+    except URLError as error:
+        raise RuntimeError(f"Request failed: {error.reason}") from error
+
+    return status, payload, encoded

formelement-0.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Iqbal Rahman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

formelement-0.1.0.dist-info/METADATA

@@ -0,0 +1,95 @@
+Metadata-Version: 2.1
+Name: formelement
+Version: 0.1.0
+Summary: Form automation utilities with browser drivers such as GoogleFormBrowser.
+Home-page: https://pypi.org/project/formelement/
+Author: Iqbal Rahman
+Author-email: iqbal@example.com
+License: MIT
+Platform: UNKNOWN
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium (>=4.20)
+
+# formelement
+
+`formelement` is a Python package for form automation.
+
+It currently provides:
+
+- answer pattern helpers
+- Google Form browser automation with Selenium
+- Google Form HTTP submission helpers
+
+The package is structured so you can later extend it with other drivers such as `MonkeyFormBrowser`.
+
+## Install
+
+```bash
+pip install formelement
+```
+
+`selenium` is installed automatically because browser automation is part of the core package.
+
+## Quick start
+
+Generate answer patterns:
+
+```python
+from formelement import AnswerPatternGenerator
+
+generator = AnswerPatternGenerator()
+answers = generator.polaJawab3(0, 1, 5)
+print(answers)
+```
+
+Use the browser driver:
+
+```python
+from selenium import webdriver
+from formelement import AnswerFieldType, GoogleFormBrowser
+
+driver = webdriver.Firefox()
+form = GoogleFormBrowser(driver)
+
+short_inputs = form.tombol(AnswerFieldType.ISIANPENDEK)
+```
+
+Submit form answers:
+
+```python
+from formelement import submit_answers
+
+status, payload, encoded = submit_answers(
+    [["Alice", "24"], ["Yes"]],
+    data_module="my_form_data",
+    dry_run=True,
+)
+```
+
+Your `data_module` must define:
+
+```python
+FORM_ID = "your-form-id"
+FORM_ENTRY_IDS = [
+    ["entry.123", "entry.456"],
+    ["entry.789"],
+]
+FORM_SESSION_STATE = ""
+FORM_FBZX = ""
+```
+
+## Public API
+
+- `AnswerPatternGenerator`
+- `AnswerFieldType`
+- `GoogleFormBrowser`
+- `submit_answers`
+
+Legacy aliases from the original project are still available:
+
+- `dataGoogleForm`
+- `dataPilihan`
+
+

formelement-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+formelement/__init__.py,sha256=r3iZupdPfaaSaOwJwxmTlXH-X4mljYIvFe2BvbjZctw,425
+formelement/answer_patterns.py,sha256=u1QO3W7vDw0vPdu15ctlEDr98pK2JHNqPm65kzVxOdc,4016
+formelement/field_types.py,sha256=D38-l7WIQtqGWqq_w5sbMvRc9PdUBgjPF9IKhuuGci0,225
+formelement/google_form_browser.py,sha256=1mqg-nbb0ihnt1LOggYy1ZlsNoqnq_mrh0xGsAur0cU,5583
+formelement/google_form_submit.py,sha256=QItLcEa4MdMXnOb73ViflnO5O7xuwl9dlFnY5o4AAvE,5039
+formelement-0.1.0.dist-info/LICENSE,sha256=tf1o27LAAwRgOQkajRdiMOmeSPI8vNKi6xgUzNU7pnY,1069
+formelement-0.1.0.dist-info/METADATA,sha256=cf7pAdL8HCHpqMwnTciE2etjYqDexRvJpXLR9CuJELw,1882
+formelement-0.1.0.dist-info/WHEEL,sha256=ewwEueio1C2XeHTvT17n8dZUJgOvyCWCt0WVNLClP9o,92
+formelement-0.1.0.dist-info/top_level.txt,sha256=-zvOEToKwzJP1llc4a6iZXx8RfKktqoCswgtrF87VEI,12
+formelement-0.1.0.dist-info/RECORD,,

formelement-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.37.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

formelement-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+formelement