fix up ci

CONTRIBUTING.md

@@ -0,0 +1,19 @@
+# Installation
+
+This project uses poetry. Create a virtual environment, and run `poetry install`
+
+# Versioning (Maintainers only)
+
+Before merging your changes, make sure to bump the versions.
+
+Make a version bump to `pyproject.toml`. If the underlying dependency on the llamacloud platform OpenAPI
+sdk needs bumping, make sure to bring that in as well. If updating dependencies, run `poetry lock`.
+
+The legacy `llama_parse` package re-exports some of `llama_cloud_services` in the old namespace. The
+versions need to be kept consistent to sidecar it with `llama_cloud_services`. Bump it's version in `llama_parse/pyproject.toml`, and also bump it's dependency version of `llama-cloud-services` to match.
+
+You can also do this with `./scripts/version-bump.py set 0.x.x` if you have `uv` installed.
+
+Once the change is merged, push a tag `git tag -a v0.x.x -m 0.x.x` and `git push origin 0.x.x`.
+
+This tagging step can be done with `./scripts/version-bump tag`.

llama_parse/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "llama-parse"
-version = "0.6.50"
+version = "0.6.51"
 description = "Parse files into RAG-Optimized formats."
 authors = ["Logan Markewich <logan@llamaindex.ai>"]
 license = "MIT"

scripts/version-bump.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# dependencies = ["click", "tomlkit"]
+# ///
+
+import click
+import subprocess
+import sys
+import tomlkit
+from pathlib import Path
+
+
+def get_current_versions() -> tuple[str, str, str]:
+    """Get current versions from both pyproject.toml files."""
+    # Read main pyproject.toml
+    main_content = Path("pyproject.toml").read_text()
+    main_doc = tomlkit.parse(main_content)
+    main_version = main_doc["tool"]["poetry"]["version"]
+
+    # Read llama_parse/pyproject.toml
+    llama_parse_content = Path("llama_parse/pyproject.toml").read_text()
+    llama_parse_doc = tomlkit.parse(llama_parse_content)
+    llama_parse_version = llama_parse_doc["tool"]["poetry"]["version"]
+    dependency_version = llama_parse_doc["tool"]["poetry"]["dependencies"][
+        "llama-cloud-services"
+    ]
+
+    return str(main_version), str(llama_parse_version), str(dependency_version)
+
+
+def validate_versions(
+    main_version: str, llama_parse_version: str, dependency_version: str
+) -> list[str]:
+    """Validate that versions are consistent and return warnings."""
+    warnings = []
+
+    if main_version != llama_parse_version:
+        warnings.append(
+            f"Version mismatch: main={main_version}, llama_parse={llama_parse_version}"
+        )
+
+    # Extract version from dependency string (e.g., ">=0.6.51" -> "0.6.51")
+    if dependency_version and dependency_version.startswith(">="):
+        dep_ver = dependency_version[2:]
+        if dep_ver != main_version:
+            warnings.append(
+                f"Dependency version mismatch: dependency={dep_ver}, main={main_version}"
+            )
+
+    return warnings
+
+
+def set_version(version: str) -> None:
+    """Set version across all pyproject.toml files using tomlkit to preserve formatting."""
+    # Update main pyproject.toml
+    main_content = Path("pyproject.toml").read_text()
+    main_doc = tomlkit.parse(main_content)
+    main_doc["tool"]["poetry"]["version"] = version
+    Path("pyproject.toml").write_text(tomlkit.dumps(main_doc))
+
+    # Update llama_parse/pyproject.toml
+    llama_parse_content = Path("llama_parse/pyproject.toml").read_text()
+    llama_parse_doc = tomlkit.parse(llama_parse_content)
+    llama_parse_doc["tool"]["poetry"]["version"] = version
+    llama_parse_doc["tool"]["poetry"]["dependencies"][
+        "llama-cloud-services"
+    ] = f">={version}"
+    Path("llama_parse/pyproject.toml").write_text(tomlkit.dumps(llama_parse_doc))
+
+    click.echo(f"Updated all versions to {version}")
+
+
+def get_current_branch() -> str:
+    """Get the current git branch."""
+    result = subprocess.run(
+        ["git", "branch", "--show-current"], capture_output=True, text=True, check=True
+    )
+    return result.stdout.strip()
+
+
+def create_and_push_tag(version: str) -> None:
+    """Create a git tag and push it."""
+    current_branch = get_current_branch()
+    if current_branch != "main":
+        click.echo(
+            f"Error: Not on main branch (currently on {current_branch})", err=True
+        )
+        sys.exit(1)
+
+    tag_name = f"v{version}"
+
+    # Create tag
+    subprocess.run(["git", "tag", tag_name], check=True)
+    click.echo(f"Created tag {tag_name}")
+
+    # Push tag
+    subprocess.run(["git", "push", "origin", tag_name], check=True)
+    click.echo(f"Pushed tag {tag_name}")
+
+
+@click.group()
+def cli() -> None:
+    """Version management for llama-cloud-services."""
+    pass
+
+
+@cli.command()
+def get() -> None:
+    """Get current versions and show validation warnings."""
+    main_version, llama_parse_version, dependency_version = get_current_versions()
+
+    click.echo("Current versions:")
+    click.echo(f"  llama-cloud-services: {main_version}")
+    click.echo(f"  llama-parse: {llama_parse_version}")
+    click.echo(f"  dependency reference: {dependency_version}")
+
+    warnings = validate_versions(main_version, llama_parse_version, dependency_version)
+    if warnings:
+        click.echo("\nValidation warnings:")
+        for warning in warnings:
+            click.echo(f"  ⚠️  {warning}")
+    else:
+        click.echo("\n✅ All versions are consistent")
+
+
+@cli.command()
+@click.argument("version")
+def set(version: str) -> None:
+    """Set version across all pyproject.toml files."""
+    set_version(version)
+
+
+@cli.command()
+@click.option(
+    "--version", help="Version to tag (uses current version if not specified)"
+)
+def tag(version: str | None = None) -> None:
+    """Create and push a git tag for the current version."""
+    if not version:
+        main_version, _, _ = get_current_versions()
+        version = main_version
+
+    create_and_push_tag(version)
+
+
+if __name__ == "__main__":
+    cli()