blocks-cli 0.1.34__tar.gz → 0.1.36__tar.gz

blocks-cli-0.1.36/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.1
+Name: blocks-cli
+Version: 0.1.36
+Summary: CLI tool for Blocks, a platform for writing custom AI-enabled codebase automations in Python. Leverage a full codebase-aware API. Automatically trigger automations from Github, Slack, and other providers.
+Home-page: https://github.com/BlocksOrg/sdk
+Author: BlocksOrg
+Author-email: dev@blocksorg.com
+License: AGPL
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Bug Tracking
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Blocks CLI
+
+A CLI tool for Blocks, a platform for writing custom AI-enabled codebase automations in Python. Leverage a full codebase-aware API. Automatically trigger automations from GitHub, Slack, and other providers.
+
+Status: Private alpha. Please keep your SDK updated to get the latest fixes and features.
+
+## Prerequisites
+
+- Python >= 3.9
+- `pip` available in your environment
+
+## Installation
+
+Blocks CLI is packaged with the Python SDK.
+
+```bash
+pip install blocks-sdk
+```
+
+Verify installation:
+
+```bash
+blocks --help
+```
+
+## Quick Start
+
+1) Initialize in your repository (creates a `.blocks` directory and optionally saves your API key):
+
+```bash
+# Option A: Provide key now
+blocks init --key <your-api-key>
+
+# Option B: Initialize, then configure later
+blocks init
+blocks configure --key <your-api-key>
+```
+
+2) Create a new automation scaffold:
+
+```bash
+blocks create my_automation
+```
+
+This generates `.blocks/my_automation/` with a starter `main.py` and `requirements.txt`.
+
+3) Edit the generated automation to set an event and repository:
+
+```python
+# .blocks/my_automation/main.py
+from blocks import task, on
+
+@task(name="my_automation")
+@on("github.pull_request", repos=["MyOrg/MyRepo"])
+def my_automation(event):
+    print(event)
+```
+
+4) Test the automation locally with a sample event:
+
+```bash
+blocks test .blocks/my_automation/main.py
+# If your file defines multiple automations, specify one by name:
+# blocks test .blocks/my_automation/main.py --name my_automation
+```
+
+5) Push the automation to Blocks:
+
+```bash
+blocks push .blocks/my_automation/main.py
+```
+
+## Command Reference
+
+- `blocks init [--key <api-key>]`: Initializes Blocks in the current repo by creating a `.blocks` directory. When `--key` is provided, verifies and saves your API key.
+- `blocks configure --key <api-key>`: Verifies and saves/updates your API key.
+- `blocks create <name>`: Creates a new automation under `.blocks/<name>/` with a starter template and `requirements.txt`.
+- `blocks test <file> [--name <automation>]`: Loads the automation from `<file>`, fetches a sample event for the configured trigger, and invokes it locally.
+- `blocks push <file>`: Packages dependencies and source, uploads the bundle, registers the automation, and triggers a build.
+
+## Naming Rules
+
+- Automation names must start with a letter and can include letters, numbers, dashes, and underscores.
+- Example valid names: `my_automation`, `code-reviewer`, `build_123`.
+
+## Troubleshooting
+
+- Already initialized: If `.blocks` exists, `blocks init` will report it. Use `blocks configure --key <api-key>` to update your key.
+- Invalid API key: Ensure your key is correct. You can manage keys at https://app.blocksorg.com
+- Missing event: The `@on("...")` decorator must specify a supported event. See events at https://docs.blocksorg.com/docs/events
+- Multiple automations in a file: Use `--name <automation>` with `blocks test` to choose one.
+
+## Upgrading
+
+```bash
+pip install -U blocks-sdk
+```
+
+## License
+
+AGPL-3.0. See `LICENSE` for details.

blocks-cli-0.1.36/README.md

@@ -0,0 +1,101 @@
+# Blocks CLI
+
+A CLI tool for Blocks, a platform for writing custom AI-enabled codebase automations in Python. Leverage a full codebase-aware API. Automatically trigger automations from GitHub, Slack, and other providers.
+
+Status: Private alpha. Please keep your SDK updated to get the latest fixes and features.
+
+## Prerequisites
+
+- Python >= 3.9
+- `pip` available in your environment
+
+## Installation
+
+Blocks CLI is packaged with the Python SDK.
+
+```bash
+pip install blocks-sdk
+```
+
+Verify installation:
+
+```bash
+blocks --help
+```
+
+## Quick Start
+
+1) Initialize in your repository (creates a `.blocks` directory and optionally saves your API key):
+
+```bash
+# Option A: Provide key now
+blocks init --key <your-api-key>
+
+# Option B: Initialize, then configure later
+blocks init
+blocks configure --key <your-api-key>
+```
+
+2) Create a new automation scaffold:
+
+```bash
+blocks create my_automation
+```
+
+This generates `.blocks/my_automation/` with a starter `main.py` and `requirements.txt`.
+
+3) Edit the generated automation to set an event and repository:
+
+```python
+# .blocks/my_automation/main.py
+from blocks import task, on
+
+@task(name="my_automation")
+@on("github.pull_request", repos=["MyOrg/MyRepo"])
+def my_automation(event):
+    print(event)
+```
+
+4) Test the automation locally with a sample event:
+
+```bash
+blocks test .blocks/my_automation/main.py
+# If your file defines multiple automations, specify one by name:
+# blocks test .blocks/my_automation/main.py --name my_automation
+```
+
+5) Push the automation to Blocks:
+
+```bash
+blocks push .blocks/my_automation/main.py
+```
+
+## Command Reference
+
+- `blocks init [--key <api-key>]`: Initializes Blocks in the current repo by creating a `.blocks` directory. When `--key` is provided, verifies and saves your API key.
+- `blocks configure --key <api-key>`: Verifies and saves/updates your API key.
+- `blocks create <name>`: Creates a new automation under `.blocks/<name>/` with a starter template and `requirements.txt`.
+- `blocks test <file> [--name <automation>]`: Loads the automation from `<file>`, fetches a sample event for the configured trigger, and invokes it locally.
+- `blocks push <file>`: Packages dependencies and source, uploads the bundle, registers the automation, and triggers a build.
+
+## Naming Rules
+
+- Automation names must start with a letter and can include letters, numbers, dashes, and underscores.
+- Example valid names: `my_automation`, `code-reviewer`, `build_123`.
+
+## Troubleshooting
+
+- Already initialized: If `.blocks` exists, `blocks init` will report it. Use `blocks configure --key <api-key>` to update your key.
+- Invalid API key: Ensure your key is correct. You can manage keys at https://app.blocksorg.com
+- Missing event: The `@on("...")` decorator must specify a supported event. See events at https://docs.blocksorg.com/docs/events
+- Multiple automations in a file: Use `--name <automation>` with `blocks test` to choose one.
+
+## Upgrading
+
+```bash
+pip install -U blocks-sdk
+```
+
+## License
+
+AGPL-3.0. See `LICENSE` for details.

{blocks-cli-0.1.34 → blocks-cli-0.1.36}/blocks_cli/commands/push.py

@@ -17,10 +17,31 @@ from blocks_cli.registration import get_blocks_state_and_module_from_file
 from blocks_cli.package import warn_current_package_version
 
 @blocks_cli.command()
-def push(file: Path = typer.Argument(..., help="Name of blocks file to push.")):
+def push(
+    file: Path = typer.Argument(..., help="Name of blocks file to push."),
+    bump: Optional[str] = typer.Option(
+        None,
+        "--bump",
+        flag_value="patch",
+        help="Bump version for public automations. Options: major, minor, patch. Defaults to patch if no value provided.",
+    ),
+    force_build: bool = typer.Option(False, "--force-build", help="Force a new build even if a successful build already exists")
+):
     try:
         warn_current_package_version()
 
+        bump_type = None
+        if bump is not None:
+            bump_val = bump.lower()
+            if bump_val not in ("major", "minor", "patch"):
+                raise Exception(
+                    f"Invalid bump type '{bump}'. Valid options are: major, minor, patch"
+                )
+            bump_type = bump_val
+            console.print(
+                f"[yellow]Version bump requested: {bump_type} (applies to public automations only)[/yellow]"
+            )
+
         # Create automation
         with Progress(
             SpinnerColumn(),
@@ -105,7 +126,10 @@ def push(file: Path = typer.Argument(..., help="Name of blocks file to push.")):
                 "pip_dependencies": pip_dependencies,
                 "bundle_id": bundle_id,
                 "automations": [],
+                "force_build": force_build,
             }
+            if bump_type is not None:
+                registration_payload["bump_type"] = bump_type
 
             for automation in state.automations:
                 trigger_kwargs = automation.get("trigger_kwargs", {})
@@ -130,12 +154,21 @@ def push(file: Path = typer.Argument(..., help="Name of blocks file to push.")):
 
                 function_name = automation.get("function_name")
                 function_source_code = automation.get("function_source_code")
+                function_hash = automation.get("function_hash")
+                function_arg_count = automation.get("function_arg_count")
+                function_kwarg_count = automation.get("function_kwarg_count")
+                function_kwargs_info = automation.get("function_kwargs_info")
                 config_schema = automation.get("config_class").model_json_schema() if automation.get("config_class") else None
                 trigger_alias = automation.get("trigger_alias")
 
                 # Extract known fields
                 automation_config = {
                     "name": automation_name,
+                    "function_hash": function_hash,
+                    "function_source_code": function_source_code,
+                    "function_arg_count": function_arg_count,
+                    "function_kwarg_count": function_kwarg_count,
+                    "function_kwargs_info": function_kwargs_info,
                     "import_path": f"{file.name}:{function_name}",
                     "runner": runner,
                     "runtime": runtime,

{blocks-cli-0.1.34 → blocks-cli-0.1.36}/blocks_cli/config/auth.py

@@ -10,6 +10,7 @@ class AuthConfig(BaseModel):
     wid: Optional[str] = ""
     # Corresponds to env variable BLOCKS_AUTH__API_KEY
     api_key: Optional[str] = ""
+    job_session_token: Optional[str] = ""
 
     def save_api_key(self, api_key: str) -> None:
         """Save the API key to the config file."""

{blocks-cli-0.1.34 → blocks-cli-0.1.36}/setup.py

@@ -6,7 +6,7 @@ with open("requirements.txt") as f:
 
 setup(
     name="blocks-cli",  
-    version="0.1.34",
+    version="0.1.36",
     packages=find_packages(),
     include_package_data=True, 
     install_requires=requirements,

blocks-cli-0.1.34/PKG-INFO

@@ -1,69 +0,0 @@
-Metadata-Version: 2.1
-Name: blocks-cli
-Version: 0.1.34
-Summary: CLI tool for Blocks, a platform for writing custom AI-enabled codebase automations in Python. Leverage a full codebase-aware API. Automatically trigger automations from Github, Slack, and other providers.
-Home-page: https://github.com/BlocksOrg/sdk
-Author: BlocksOrg
-Author-email: dev@blocksorg.com
-License: AGPL
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Software Development :: Bug Tracking
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: Software Development :: Code Generators
-Classifier: Topic :: Software Development :: Version Control :: Git
-Classifier: Topic :: Communications :: Chat
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# Blocks CLI
-
-A CLI tool for Blocks, a platform for writing custom AI-enabled codebase automations in Python. Leverage a full codebase-aware API. Automatically trigger automations from Github, Slack, and other providers.
-
-> We're currently in private alpha, we recommend consistently updating your SDK to the latest version to get the latest features and fixes.
-
-## Getting Started
-
-### 1. Install CLI (Packaged with SDK)
-
-```bash
-pip install blocks-sdk
-```
-
-### 2. Create a new Blocks project
-
-```bash
-mkdir -p .blocks/myautomation
-cd .blocks/myautomation
-```
-
-### 3. Create a new automation
-
-```python
-# automation.py
-from blocks import task, on
-
-@task(name="my_automation")
-@on("github.pull_request", repos=["MyOrg/MyRepo"])
-def my_automation(event):
-    print(event)
-```
-
-### 5. Upload your automation
-
-```bash
-blocks init --api-key <your-api-key>
-blocks push automation.py
-```

blocks-cli-0.1.34/README.md

@@ -1,39 +0,0 @@
-# Blocks CLI
-
-A CLI tool for Blocks, a platform for writing custom AI-enabled codebase automations in Python. Leverage a full codebase-aware API. Automatically trigger automations from Github, Slack, and other providers.
-
-> We're currently in private alpha, we recommend consistently updating your SDK to the latest version to get the latest features and fixes.
-
-## Getting Started
-
-### 1. Install CLI (Packaged with SDK)
-
-```bash
-pip install blocks-sdk
-```
-
-### 2. Create a new Blocks project
-
-```bash
-mkdir -p .blocks/myautomation
-cd .blocks/myautomation
-```
-
-### 3. Create a new automation
-
-```python
-# automation.py
-from blocks import task, on
-
-@task(name="my_automation")
-@on("github.pull_request", repos=["MyOrg/MyRepo"])
-def my_automation(event):
-    print(event)
-```
-
-### 5. Upload your automation
-
-```bash
-blocks init --api-key <your-api-key>
-blocks push automation.py
-```