Skip to main content

GitHub Actions with Python

Project description

dandori: GitHub Actions with Python

dandori runs on your Actions, and automate workflow with using Python.

Current Status is Super Early Alpha. DO NOT USE IT in your production repository.

How to Use

First, You need to define workflow. You can hook any events without manual/scheduled workflow such as pull_request, push or pull_request_review.

name: dandori_action
on: [pull_request, issue_comment]

jobs:
  run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-python@v2
        with:
          python-version: '3.9'
      - run: pip install dandori
      - run: dandori run
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Next, you can write your Python script or package on your repo, like dandori_handler.py or 'dandori_handlers/'. dandori automatically import your code and run handler functions defined in your code:

## dandori_handler.py

def handle_pull_request(ctx):
    if ctx.gh.payload.action == 'synchronize':
        ctx.gh.create_comment("You pushed new commits!!")


def handle_pull_request_comment(ctx):
    """It's a special handler type, issue_comment event on PR"""
    comment_body = ctx.gh.comment_body().strip()
    if comment_body.startswith('/some-command'):
        some_code_as_you_like()

If you want more than one file, you need to make a package:

## handlers/__init__.py
# Must be relative imports
from .pull_request import handle_pull_request
from .issue import handle_issue

## handlers/pull_request.py
def handle_pull_request(ctx):
    ...

## -- handlers/issue.py
def handle_issue(ctx):
    ...

Configuration

dandori supports pyproject.toml, or make any toml file as you like (default is dandori.toml).

In pyproject.toml, write config in tool.dandori section:

# pyproject.toml
[tool.dandori]
handlers = ['path/to/handler']

In independent toml file, write config in dandori section:

# dandori.toml
[dandori]
handlers = ['path/to/handler']

Use case

Share CI code with multiple repo:

name: dandori_action
on: [pull_request, issue_comment]

jobs:
  run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/checkout@v2
        with:
          repository: your/dandori-handler
          ref: v1  # something you need
          ssh-key: ${{ secrets.your_repo_key }}
          path: dandori-handler
      - uses: actions/setup-python@v2
        with:
          python-version: '3.9'
      - run: pip install dandori
      - run: dandori run -f dandori-handler/dandori.toml
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Use third party package in handler

Your handler module or package will be imported dynamically, so you can install any library in the "(virtual)env" same as dandori installed.

Most simple cale, install dandori with other library:

# Install libraries with pip
- run: pip install dandori requests python-dateutil

If you want use just a "command" and not to use global env, use ctx.ops.run_venv():

def handle_pull_request(ctx):
    ctx.ops.run_venv(["pip", "install", "twine"])
    ctx.ops.run_venv(['twine', 'upload', 'dist/*'])

Or dynamically install it and use it:

import importlib

def handle_pull_request(ctx):
    ctx.ops.run(["pip", "install", "requests"])
    requests = importlib.import_module('requests')

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dandori-0.1.13.tar.gz (13.9 kB view hashes)

Uploaded Source

Built Distribution

dandori-0.1.13-py3-none-any.whl (15.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page