.github/actions/release-pypi/action.yml

@@ -0,0 +1,15 @@
+name: "Release PyPI"
+description: "Release PyPI"
+inputs:
+  pypi-token:
+    required: true
+    description: "PyPI token"
+runs:
+  using: "composite"
+  steps:
+    - name: Release PyPI
+      shell: bash
+      run: |
+        export UV_PUBLISH_PASSWORD="${{ inputs.pypi-token }}"
+        export UV_PUBLISH_USERNAME="__token__"
+        uv publish --publish-url https://upload.pypi.org/legacy/

.github/actions/release-slack-bot/action.yml

@@ -0,0 +1,23 @@
+name: "Release Slack Bot"
+description: "Release Slack Bot"
+inputs:
+  slack-token:
+    required: true
+    description: "Slack token"
+runs:
+  using: "composite"
+  steps:
+    # TODO: use python exec instead
+    - uses: slackapi/slack-github-action@v2.0.0
+      with:
+        method: chat.postMessage
+        token: ${{ inputs.slack-token }}
+        payload: |
+          username: ${{ job.status == 'success' && format('Released codegen@{0}', github.ref_name) || format('Failed to release codegen@{0}', github.ref_name) }}
+          channel: "#release"
+          icon_emoji: "${{ job.status == 'success' && ':white_check_mark:' || ':x:' }}"
+          text: |
+            Actor: `${{ github.triggering_actor }}`
+            Author: `${{ github.event.head_commit.author.username }}`
+            ${{ format('Commit: <{0}/{1}/commit/{2}|{1}@{2}>', github.server_url, github.repository, github.sha) || ''}}
+            View <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}|GHA logs>

.github/actions/run_ats/action.yml → .github/actions/run-ats/action.yml

@@ -38,7 +38,7 @@ runs:
       run: |
         uv run codecovcli create-commit -t ${{ inputs.codecov_token }}
         uv run codecovcli create-report -t ${{ inputs.codecov_token }}
-        bash .github/actions/run_ats/ats.sh
+        bash .github/actions/run-ats/ats.sh
 
     - name: Run tests
       shell: bash

.github/workflows/auto-release.yml

@@ -3,15 +3,14 @@ on:
   push:
     branches:
       - develop
-  workflow_dispatch:
-
-permissions:
-  contents: read
 
 jobs:
-  release:
-    name: Release
+  semantic-version:
+    if: false # TODO(CG-10755): merge this with release.yml
+    name: Semantic version
     runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.semantic.outputs.release-version }}
     permissions:
       checks: read # to wait for required checks
       contents: write # to be able to publish a GitHub release
@@ -36,3 +35,11 @@ jobs:
         id: semantic
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  release:
+    needs: semantic-version
+    uses: ./.github/workflows/release.yml
+    permissions:
+      contents: write
+    with:
+      tag: ${{ needs.semantic-version.outputs.tag }}

.github/workflows/cache-warm-up.yml

@@ -27,7 +27,7 @@ jobs:
         with:
           ref: develop # Ensure we're operating on the 'develop' branch
 
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
 
   warm-up-cache:
@@ -46,7 +46,7 @@ jobs:
         with:
           ref: develop # Ensure we're operating on the 'develop' branch
 
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
 
       - name: Cache oss-repos

.github/workflows/mypy.yml

@@ -20,7 +20,7 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
 
       - name: Get changed files

.github/workflows/pre-commit.yml

@@ -22,7 +22,7 @@ jobs:
           ref: ${{ github.event.pull_request.head.ref }}
           token: ${{ secrets.REPO_SCOPED_TOKEN }}
 
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
 
       - name: Setup-pre-commit

.github/workflows/release.yml

@@ -1,15 +1,25 @@
 name: Build & Release
 
 on:
+  workflow_call:
+    inputs:
+      tag:
+        required: true
+        type: string
+        description: Tag to release
+  # TODO(CG-10758): create if it does not exist
+  # workflow_dispatch:
+  #   inputs:
+  #     tag:
+  #       required: true
+  #       type: string
+  #       description: Tag to release # TODO: create if it does not exist
   push:
     tags:
       - v*
-    branches:
-      - develop
   pull_request:
     branches:
       - develop
-  workflow_dispatch:
 
 permissions:
   contents: read
@@ -41,7 +51,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          ref: ${{ github.event.pull_request.head.ref || github.ref }}
+          ref: ${{ inputs.tag || github.event.pull_request.head.ref || github.ref }}
 
       - name: Install UV
         uses: astral-sh/setup-uv@v5.2
@@ -70,7 +80,7 @@ jobs:
           path: ./wheelhouse/*.whl
 
   release:
-    if: startsWith(github.ref, 'refs/tags/')
+    if: ${{ inputs.tag || startsWith(github.ref, 'refs/tags/') }}
     needs: build
     runs-on: ubuntu-latest
     environment: release
@@ -90,31 +100,22 @@ jobs:
           pattern: wheels-*
 
       - name: Release PyPI
-        run: |
-          export UV_PUBLISH_PASSWORD="${{ secrets.PYPI_TOKEN }}"
-          export UV_PUBLISH_USERNAME="__token__"
-          uv publish --publish-url https://upload.pypi.org/legacy/
+        uses: ./.github/actions/release-pypi
+        with:
+          pypi-token: ${{ secrets.PYPI_TOKEN }}
 
       - name: Github release
         id: github-release
         uses: softprops/action-gh-release@v2
         with:
+          tag_name: ${{ inputs.tag || github.ref_name }}
           files: dist/*
           fail_on_unmatched_files: true
-          generate_release_notes: true
+          generate_release_notes: ${{ startsWith(github.ref, 'refs/tags/') }}
 
-      # TODO: use python exec instead
-      - uses: slackapi/slack-github-action@v2.0.0
+      - name: Slack notification
         if: always()
+        uses: ./.github/actions/release-slack-bot
         with:
-          method: chat.postMessage
-          token: ${{ secrets.SLACK_BOT_TOKEN }}
-          payload: |
-            username: ${{ job.status == 'success' && format('Released codegen@{0}', github.ref_name) || format('Failed to release codegen@{0}', github.ref_name) }}
-            channel: "#release"
-            icon_emoji: "${{ job.status == 'success' && ':white_check_mark:' || ':x:' }}"
-            text: |
-              Actor: `${{ github.triggering_actor }}`
-              Author: `${{ github.event.head_commit.author.username }}`
-              ${{ format('Commit: <{0}/{1}/commit/{2}|{1}@{2}>', github.server_url, github.repository, github.sha) || ''}}
-              View <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}|GHA logs>
+          release-tag: ${{ github.ref_name }}
+          slack-token: ${{ secrets.SLACK_BOT_TOKEN }}

.github/workflows/unit-tests.yml

@@ -17,10 +17,10 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
       - name: Run ATS and Tests
-        uses: ./.github/actions/run_ats
+        uses: ./.github/actions/run-ats
         timeout-minutes: 15
         with:
           default_tests: "tests/unit"
@@ -48,12 +48,12 @@ jobs:
     name: "Codemod tests ${{matrix.size}}: Sync Graph=${{matrix.sync_graph}}"
     steps:
       - uses: actions/checkout@v4
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
       - name: Cache oss-repos
         uses: ./.github/actions/setup-oss-repos
       - name: Run ATS and Tests
-        uses: ./.github/actions/run_ats
+        uses: ./.github/actions/run-ats
         timeout-minutes: 15
         with:
           default_tests: "tests/integration/codemod/test_codemods.py"
@@ -71,7 +71,7 @@ jobs:
     environment: parse-tests
     steps:
       - uses: actions/checkout@v4
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
 
       - name: Cache oss-repos
@@ -135,7 +135,7 @@ jobs:
     runs-on: ubuntu-latest-16
     steps:
       - uses: actions/checkout@v4
-      - name: Setup backend
+      - name: Setup environment
         uses: ./.github/actions/setup-environment
       - name: Test with pytest
         timeout-minutes: 5

.pre-commit-config.yaml

@@ -79,7 +79,7 @@ repos:
     hooks:
       - id: renovate-config-validator
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: "0.5.29"
+    rev: "0.5.30"
     hooks:
       - id: uv-sync
         args: ["--frozen", "--all-packages", "--all-extras"]

codegen-examples/pyproject.toml

@@ -3,7 +3,7 @@ name = "codegen-examples"
 version = "0.0.0"
 readme = "README.md"
 requires-python = ">=3.12, <3.14"
-dependencies = ["codegen==0.5.30"]
+dependencies = ["codegen==0.6.1"]
 license = { file = "LICENSE" }
 classifiers = [
   "License :: OSI Approved :: Apache Software License",

docs/building-with-codegen/dependencies-and-usages.mdx

@@ -11,7 +11,7 @@ Codegen pre-computes dependencies and usages for all symbols in the codebase, en
 
 Codegen provides two main ways to track relationships between symbols:
 
-- [.dependencies](/api-reference/core/Symbol#dependencies) / [.get_dependencies(...)](/api-reference/core/Symbol#get-dependencies) - What symbols does this symbol depend on?
+- [.dependencies](/api-reference/core/Symbol#dependencies) / - What symbols does this symbol depend on?
 - [.usages](/api-reference/core/Symbol#usages) / [.usages(...)](/api-reference/core/Symbol#usages) - Where is this symbol used?
 
 Dependencies and usages are inverses of each other. For example, given the following input code:
@@ -129,12 +129,12 @@ The dependencies API lets you find what symbols a given symbol depends on.
 
 ```python
 # Get all direct dependencies
-deps = my_class.dependencies  # Shorthand for get_dependencies(UsageType.DIRECT)
+deps = my_class.dependencies  # Shorthand for dependencies(UsageType.DIRECT)
 
 # Get dependencies of specific types
-direct_deps = my_class.get_dependencies(UsageType.DIRECT)
-chained_deps = my_class.get_dependencies(UsageType.CHAINED)
-indirect_deps = my_class.get_dependencies(UsageType.INDIRECT)
+direct_deps = my_class.dependencies(UsageType.DIRECT)
+chained_deps = my_class.dependencies(UsageType.CHAINED)
+indirect_deps = my_class.dependencies(UsageType.INDIRECT)
 ```
 
 ### Combining Usage Types
@@ -143,10 +143,10 @@ You can combine usage types using the bitwise OR operator:
 
 ```python
 # Get both direct and indirect dependencies
-deps = my_class.get_dependencies(UsageType.DIRECT | UsageType.INDIRECT)
+deps = my_class.dependencies(UsageType.DIRECT | UsageType.INDIRECT)
 
 # Get all types of dependencies
-deps = my_class.get_dependencies(
+deps = my_class.dependencies(
     UsageType.DIRECT | UsageType.CHAINED |
     UsageType.INDIRECT | UsageType.ALIASED
 )
@@ -178,7 +178,83 @@ class_imports = [dep for dep in my_class.dependencies if isinstance(dep, Import)
 
 # Get all imports used by a function, including indirect ones
 all_function_imports = [
-    dep for dep in my_function.get_dependencies(UsageType.DIRECT | UsageType.INDIRECT)
+    dep for dep in my_function.dependencies(UsageType.DIRECT | UsageType.INDIRECT)
     if isinstance(dep, Import)
 ]
 ```
+## Traversing the Dependency Graph
+
+Sometimes you need to analyze not just direct dependencies, but the entire dependency graph up to a certain depth. The `dependencies` method allows you to traverse the dependency graph and collect all dependencies up to a specified depth level.
+
+### Basic Usage
+
+```python
+
+# Get only direct dependencies
+deps = symbol.dependencies(max_depth=1)
+
+# Get deep dependencies (up to 5 levels)
+deps = symbol.dependencies(max_depth=5)
+```
+
+The method returns a dictionary mapping each symbol to its list of direct dependencies. This makes it easy to analyze the dependency structure:
+
+```python
+# Print the dependency tree
+for sym, direct_deps in deps.items():
+    print(f"{sym.name} depends on: {[d.name for d in direct_deps]}")
+```
+
+### Example: Analyzing Class Inheritance
+
+Here's an example of using `dependencies` to analyze a class inheritance chain:
+
+```python
+class A:
+    def method_a(self): pass
+
+class B(A):
+    def method_b(self): 
+        self.method_a()
+
+class C(B):
+    def method_c(self):
+        self.method_b()
+
+# Get the full inheritance chain
+symbol = codebase.get_class("C")
+deps = symbol.dependencies(
+    max_depth=3
+)
+
+# Will show:
+# C depends on: [B]
+# B depends on: [A]
+# A depends on: []
+```
+
+### Handling Cyclic Dependencies
+
+The method properly handles cyclic dependencies in the codebase:
+
+```python
+class A:
+    def method_a(self):
+        return B()
+
+class B:
+    def method_b(self):
+        return A()
+
+# Get dependencies including cycles
+symbol = codebase.get_class("A")
+deps = symbol.dependencies()
+
+# Will show:
+# A depends on: [B]
+# B depends on: [A]
+```
+
+<Tip>
+  The `max_depth` parameter helps prevent excessive recursion in large codebases or when there are cycles in the dependency graph.
+</Tip>