py-aps 0.0.5

Autodesk Platform Service APIs Python SDK

py-aps

Python SDK for Autodesk Platform Service APIs

Installation

pip install py-aps

Overview

py-aps is a Python SDK that provides a simple and intuitive interface for interacting with Autodesk Platform Services (formerly known as Forge) APIs. This SDK simplifies authentication, data management, and automation workflows for APS-powered applications.

Features

• Authentication: Easy OAuth2 authentication flow
• Data Management: Access and manage files in BIM 360, ACC, and other Autodesk cloud storage
• Automation: Automate design and engineering workflows

Quick Start

Authentication

from pyaps.auth import AuthClient, Scopes

# 2-legged OAuth
client = AuthClient(client_id="...", client_secret="...")
token = client.two_legged.get_token([Scopes.DATA_READ])

Data Management

from pyaps.datamanagement import DataManagementClient

dm = DataManagementClient(token_provider=lambda: token.access_token)

# List hubs and projects
hubs = list(dm.hubs.list())
projects = list(dm.hubs.list_projects(hub_id))

# Browse folders
contents = list(dm.folders.contents(project_id, folder_id))

Design Automation

from pyaps.automation import AutomationClient

auto = AutomationClient(token_provider=lambda: token.access_token)

# List engines
engines = auto.list_engines()

# Create and execute workitem
workitem = auto.start_workitem({
    'activityId': 'Owner.MyActivity+prod',
    'arguments': {...}
})

For more examples, see src/pyaps/auth/example.py, src/pyaps/datamanagement/example.py, and src/pyaps/automation/example.py.

Project Status

Current version: v0.0.4 - Design Automation API support added

This package is currently in early development. Active development is underway by voidbox.

Version History

• v0.0.4 - Added Design Automation API client (Engines, AppBundles, Activities, WorkItems)
• v0.0.3 - Added Data Management API client (Hubs, Projects, Folders, Items, Versions, Buckets, Objects)
• v0.0.2 - Added OAuth 2.0 authentication client with 2-legged/3-legged flows, PKCE support, and token management
• v0.0.1 - Initial package release (placeholder)

Contributing

We welcome bug reports and feature requests through GitHub Issues.

This project is primarily developed by voidbox. External pull requests have limited review capacity.

License

Apache-2.0 License - see the LICENSE file for details.

Links

• GitHub Repository
• PyPI Package
• Autodesk Platform Services Documentation