{"author":null,"author_email":"Abubakar Abid ","bugtrack_url":null,"classifiers":["License :: OSI Approved :: MIT License","Operating System :: OS Independent","Programming Language :: Python :: 3"],"description":"

\n $\"PyPI\"$ \n $\"Python$ \n $\"Format\"$ \n $\"Test\"$ \n

\n\n\n

\n\n

\n\nGroovy is a Python-to-JavaScript transpiler, meaning that it converts Python functions to their JavaScript equivalents. It is used in the [Gradio](https://gradio.app) library, so that developers can write functions in Python and have them run as fast as client-side JavaScript ⚡. Instead of aiming for full coverage of Python features, groovy prioritizes **clear error reporting** for unsupported Python code, making it easier for developers to modify their functions accordingly.\n\n### 🚀 Features\n- Converts simple Python functions into JavaScript equivalents.\n- Supports a subset of the Python standard library along with some Gradio-specific classes.\n- Provides **complete error reporting** when a function can't be transpiled (either due to no equivalent in JavaScript or ambiguity).\n\n### 📦 Installation\nInstall groovy via pip:\n```bash\npip install groovy\n```\n\n### 🔧 Usage\n```python\nfrom groovy import transpile\n\ndef sum_range(n: int):\n total = 0\n for i in range(n):\n total = total + i\n return total\n\njs_code = transpile(sum)\nprint(js_code)\n```\nproduces:\n\n```\nfunction sum_range(n) {\n let total = 0;\n for (let i of Array.from({length: n}, (_, i) => i)) {\n total = (total + i);\n }\n return total;\n```\n\nNote that the JavaScript function is not necessarily minimized or optimized (yet) but it should return exactly the same value when called with the same arguments. While the internal implementation of the transpiled JavaScript function may differ slightly from the Python version (e.g. Python tuples may get converted to JS arrays), groovy tries to guarantee that the return values will be identical for the same inputs.\n\nIf groovy encounters unsupported syntax, it will **complain clearly** (throw a `TranspilationError` with all of the issues along with line numbers and the code that caused the issue, making it easy for developers to fix their code.\n\n\n```python\ndef example_function(x, y):\n z = x + y\n if z > 10:\n print(z)\n else:\n print(0)\n\ntranspile(example_function)\n```\n\nraises:\n\n```\nTranspilerError: 2 issues found:\n\n* Line 4: Unsupported function \"print()\"\n>> print(z)\n* Line 6: Unsupported function \"print()\"\n>> print(0)\n```\n\n### 🤔 Ambiguity\ngroovy takes a conservative approach when encountering ambiguous types. Instead of making assumptions about types, it will raise a `TranspilationError`. For example, a simple sum function without type hints will fail:\n\n```python\ndef sum(a, b):\n return a + b\n\ntranspile(sum) # Raises TranspilationError: Cannot determine types for parameters 'a' and 'b'\n```\n\nThis is because `+` could mean different things in JavaScript depending on the types (string concatenation vs numeric addition vs. custom behavior for a custom class). Adding type hints (which is **strongly recommended** for all usage) resolves the ambiguity:\n\n```python\ndef sum(a: int, b: int):\n return a + b\n\ntranspile(sum) # Works! Produces: function sum(a, b) { return (a + b); }\n```\n\n### 🔥 Supported Syntax\n\ngroovy supports the following Python syntax and built-in functions. Other functions will not be transpiled.\n\n**General**\n\n| Python Syntax | JavaScript Equivalent |\n|--------------|----------------------|\n| `def function(x: int)` | `function function(x)` |\n| `x + y`, `x - y`, `x * y`, `x / y` | `(x + y)`, `(x - y)`, `(x * y)`, `(x / y)` |\n| `x > y`, `x < y`, `x >= y`, `x <= y` | `(x > y)`, `(x < y)`, `(x >= y)`, `(x <= y)` |\n| `x == y`, `x != y` | `(x === y)`, `(x !== y)` |\n| `x in list`, `x not in list` | `list.includes(x)`, `!list.includes(x)` |\n| `x = value` | `let x = value` |\n| `if condition: ... elif: ... else: ...` | `if (condition) { ... } else if { ... } else { ... }` |\n| `for x in range(n)` | `for (let x of Array.from({length: n}, (_, i) => i))` |\n| `for x in list` | `for (let x of list)` |\n| `while condition` | `while (condition)` |\n| `[x for x in list if condition]` | `list.filter(x => condition).map(x => x)` |\n| `len(list)` | `list.length` |\n| `len(dict)` | `Object.keys(dict).length` |\n| `[1, 2, 3]` | `[1, 2, 3]` |\n| `(1, 2, 3)` | `[1, 2, 3]` |\n| `{\"key\": \"value\"}` | `{\"key\": \"value\"}` |\n| `x and y`, `x or y` | `(x && y)`, `(x || y)` |\n| `None` | `null` |\n\n\n**Gradio-specific syntax**\n\n| Python Syntax | JavaScript Equivalent |\n|--------------|----------------------|\n| `gr.Component(param=value)` | `{\"param\": \"value\", \"__type__\": \"update\"}` |\n\n\n### 📜 License\ngroovy is open-source under the [MIT License](https://github.com/abidlabs/groovy/blob/main/LICENSE).\n\n---\nContributions to increase coverage of the Python library that groovy can transpile are welcome! We welcome AI-generated PRs if the rationale is clear to follow, PRs are not too large in scope, and tests are included.\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":null,"license":null,"license_expression":null,"license_files":["LICENSE"],"maintainer":null,"maintainer_email":null,"name":"groovy","package_url":"https://pypi.org/project/groovy/","platform":null,"project_url":"https://pypi.org/project/groovy/","project_urls":{"homepage":"https://github.com/gradio-app/groovy","repository":"https://github.com/gradio-app/groovy"},"provides_extra":["dev"],"release_url":"https://pypi.org/project/groovy/0.1.2/","requires_dist":["pytest; extra == \"dev\"","ruff==0.9.3; extra == \"dev\""],"requires_python":">3.9","summary":"A small Python library created to help developers protect their applications from Server Side Request Forgery (SSRF) attacks.","version":"0.1.2","yanked":false,"yanked_reason":null}

Dependencies of groovy (2).
Dependency	Optional
pytest	true
ruff	true

Package search

groovy

project_urls

Dependencies

All package metadata

Releases