Build Management

class BuildClient:
    def get(self) -> dict | None:
        """Get build information including status and logs."""
    
    def delete(self) -> None:
        """Delete build."""
    
    def abort(self) -> dict:
        """Abort running build."""
    
    def get_open_api_definition(self) -> dict | None:
        """Get OpenAPI definition for the build."""
    
    def wait_for_finish(self, *, wait_secs: int | None = None) -> dict | None:
        """Wait for build completion.
        
        Args:
            wait_secs: Maximum wait time in seconds
        """
    
    def log(self) -> LogClient:
        """Get build log client."""

class BuildClientAsync:
    """Async version of BuildClient with identical methods."""

class BuildCollectionClient:
    def list(
        self, 
        *, 
        limit: int | None = None, 
        offset: int | None = None, 
        desc: bool | None = None
    ) -> ListPage[dict]:
        """List Actor builds.
        
        Args:
            limit: Maximum number of builds
            offset: Pagination offset
            desc: Sort in descending order
        """

class BuildCollectionClientAsync:
    """Async version of BuildCollectionClient with identical methods."""

from apify_client import ApifyClient

client = ApifyClient('your-api-token')

# Trigger Actor build
actor = client.actor('my-actor-id')
build = actor.build(version_number='1.2.3', tag='production')

# Monitor build progress
build_client = client.build(build['id'])
result = build_client.wait_for_finish(wait_secs=600)

if result and result['status'] == 'SUCCEEDED':
    print("Build completed successfully")
else:
    print("Build failed or timed out")