/AutoPR

Run AI-powered workflows over your codebase

Primary LanguagePythonMIT LicenseMIT

AutoPR logo

๐ŸŒณ AutoPR ๐ŸŒณ

Discord Docs

Run AI-powered workflows over your codebase

๐ŸŒŸ Features

๐ŸŒณ Living summaries of your code in nested READMEs
๐Ÿ“ TODOs kept track of in issues
โณ Keep history of an API call's result in git
๐Ÿ“„ Summarize changes by adding a "summarize" label to a PR
๐Ÿซต Custom actions configured in YAML

๐Ÿš€ Getting Started

Please see the installation guide.

๐Ÿ“ Maintainer Note

Though used internally, this project is currently not actively maintained.

Until v0.1.2, AutoPR autonomously generated pull requests from issues. If you'd still prefer to use AutoPR for this, set the following line in your github actions yaml:

      uses: docker://ghcr.io/irgolic/autopr:v0.1.2

Below is an example of AutoPR's Living README:

๐ŸŒณ Living Summary

This folder contains various files and folders related to automating tasks and workflows. It includes a Dockerfile for setting up a Docker image, a license file specifying the terms of use, a Makefile for automating development tasks, an action configuration file for a pull request workflow, a shell script for executing a Python module, a lock file and a configuration file for a Python project using Poetry, JSON schemas for defining strict workflows and trigger configurations, and a JSON schema for defining workflow definitions. These files and folders provide functionality for automating tasks, managing actions and Git operations, and executing customizable workflows.

๐Ÿ—๏ธ Sets up a Docker image based on the duffn/python-poetry:3.9-bullseye image
๐Ÿ”ง Installs git from the bullseye-backports repository
๐Ÿ“ฅ Copies an entrypoint script and makes it executable
๐Ÿ“ฅ Copies the pyproject.toml and poetry.lock files
๐Ÿ”ง Activates the virtual environment and installs the project dependencies using Poetry
๐Ÿ“ฅ Copies the rest of the files to the /app directory
๐Ÿ”ง Installs the application using Poetry
๐Ÿš€ Sets the entrypoint to /entrypoint.sh for running the app

๐Ÿ“„ This file contains the MIT License.
๐Ÿ”’ The license grants permission to use, modify, and distribute the software.
๐Ÿ“ The license requires the copyright notice and permission notice to be included in all copies.
๐Ÿšซ The software is provided "as is" without warranty.
๐Ÿ“… The license is valid until 2023.
๐Ÿ’ผ The license is owned by Raphael Francis Ltd.

๐Ÿ“ This file is a makefile-like configuration file.
๐Ÿ”ง It defines various targets and their associated commands.
๐Ÿ’ป The targets are: format, type, test, schema, and all.
๐Ÿ”ง The format target runs a command to format code using the black tool.
๐Ÿ”ง The type target runs a command to perform type checking using pyright.
๐Ÿ”ง The test target runs pytest on the autopr/tests directory.
๐Ÿ”ง The schema target runs a command to generate configuration entrypoints using autopr.models.config.
๐Ÿ”ง The all target runs all the targets in sequence: format, type, test, and schema.
๐Ÿ”ง This file is meant to automate common development tasks and ensure code quality.

๐Ÿ“„ This file is a configuration file for an automatic pull request workflow.
๐Ÿ”ง It specifies the details for running the workflow, such as the Docker image to use.
๐ŸŽจ It also includes branding information, such as the icon and color to use.
๐Ÿ”‘ The file defines inputs required for the workflow, such as the GitHub token and base branch.
๐ŸŽฅ It includes a default loading GIF URL to display while the pull request is being generated.
๐ŸŒฟ The file defines a template for the name of the target branch.
๐Ÿ”„ It specifies whether to overwrite existing branches and pull requests when creating from issues.

This folder contains a collection of Python files and folders related to automating tasks and workflows. It includes files for actions and utilities, an entry point for GitHub Actions, logging configuration, the main service for running triggers and workflows, models for building and executing workflows, services for managing actions and Git operations, trigger configurations, and scripts and configuration files for managing workflows. These files and folders provide functionality for automating tasks, interacting with the GitHub platform, and executing customizable workflows.

๐Ÿ“ The file is a shell script
๐Ÿ”ง It sets the Git configuration for a specific directory
โœ‰๏ธ It sets the user email and name for Git commits
๐Ÿ“ฆ It activates a virtual environment
๐Ÿ It runs a Python module called autopr.gh_actions_entrypoint

๐Ÿ“„ This file is an executive summary of a project or report
๐Ÿ” It provides a high-level overview of the main points
๐Ÿ“ It highlights key findings, conclusions, and recommendations
๐Ÿ“Š It may include a summary of data or analysis
๐Ÿ‘ฅ It is intended for someone who is new to the project or report
๐Ÿšซ It does not include trivial details or technical explanations
๐Ÿ’ก It gives a clear understanding of the purpose and scope of the project
๐Ÿ‘€ It provides a quick glance at the content without going into depth
๐Ÿ’ผ It serves as a starting point for further exploration or discussion
๐Ÿ“Œ It is concise and easy to read, even if the file is empty

๐Ÿ“‹ This file is a configuration file for a Python project using Poetry.
๐Ÿ” It contains information about the project's name, version, and authors.
๐Ÿ“„ The license of the project is specified as MIT.
๐Ÿ“ฆ It lists the packages and their dependencies required for the project.
๐Ÿงช There are separate dependencies for testing and development.
๐Ÿ”ง The build system used is Poetry.
๐Ÿ” The file also includes configuration for the Pyright static type checker.
๐Ÿ” It specifies the line length and target version for the Black code formatter.

๐Ÿ“„ The file is a JSON schema describing a strict workflow definition.
๐Ÿ” It defines various actions that can be performed within the workflow.
๐Ÿ”€ Actions include commenting, setting issue titles, walking files, making API calls, running bash commands, and more.
๐Ÿ“ Each action has its own set of inputs and outputs.
๐Ÿ”„ The workflow steps are defined as an array of actions.
๐Ÿ“š The schema also includes definitions for various data types and declarations used within the actions.
๐Ÿ“ The purpose of the file is to provide a standardized structure for defining and executing strict workflows.
๐Ÿ—‚๏ธ The schema can be used to validate and ensure the correctness of workflow definitions.
๐Ÿงฉ It allows for easy integration with other tools and systems that support the schema.
๐Ÿ“š The file can serve as a reference for understanding the structure and capabilities of strict workflows.

๐Ÿ“„ This file is a JSON document describing a trigger configuration for a workflow.
๐Ÿ”— It defines various trigger types such as label, comment, push, and cron triggers.
๐Ÿ—’๏ธ Each trigger type has its own set of properties and can be customized.
๐Ÿ”€ Triggers can be used to initiate specific actions or workflows based on certain events.
๐Ÿ“ The document also includes definitions for different action models and their properties.
๐Ÿงฉ These action models can be used within the triggers to specify the desired behavior.
๐Ÿ“ The file provides a comprehensive overview of the available triggers and action models.
๐Ÿ”ง It can be used as a reference guide for configuring and customizing workflows.
๐Ÿ—‚๏ธ The file structure is organized using nested objects and properties.
๐Ÿ” It's important to review the specific trigger and action definitions to understand their functionality and usage.

๐Ÿ“„ This file is a JSON schema definition for a workflow definition.
๐Ÿ”ง It defines various types and properties for different actions and declarations used in the workflow.
๐Ÿ“ The schema includes definitions for actions like commenting, setting issue title, walking files, making API calls, running bash commands, etc.
๐Ÿ“š It also defines different types of declarations like template, variable, constant, and lambda declarations.
๐Ÿ“‹ The workflow definition includes a name, description, inputs, and outputs.
๐Ÿ”ข It consists of a list of steps which can be actions, workflow invocations, or conditional statements.
๐Ÿ”€ Conditional statements can have if-else branches and support different conditions like lambda expressions and context checks.
๐Ÿ”„ Workflow invocations can be either regular or iterable.
๐Ÿ”‘ Overall, this file provides a structured definition for creating and executing workflows with various actions and conditions.