Skip to content
A command line tool for interfacing with Drupal.org
PHP
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore
.travis.yml
README.md
box.json
composer.json
composer.lock
drupalorg

README.md

Drupal.org CLI

Latest Stable Version Total Downloads Latest Unstable Version License

A command line tool for interfacing with Drupal.org. Uses the Drupal.org REST API.

Requirements

  • PHP 7.2 or higher, with cURL support
  • Git - Currently required to apply and create patches. Very useful for contributing patches back to an issue.

Installation

Installing manually

  1. Download the drupalorg.phar file from the latest release.

  2. Rename the file to drupalorg, ensure it is executable, and move it into a directory in your PATH (use echo $PATH to see your options).

  3. Run drupalorg and verify you can see the list of available commands.

Installing via Composer (deprecated)

Use the following command to install the command line tool via Composer:

composer global require mglaman/drupalorg-cli

Updating

Automatic updating is not yet supported. You will need to manually download new releases.

Usage

Use the 'list' command to see available commands.

drupalorg list

Commands

Available commands:
  help                         Displays help for a command
  list                         Lists commands
 cache
  cache:clear (cc)             Clears caches
 ci
 drupalci
  drupalci:list (ci:l)         Lists test results for an issue
  drupalci:watch (ci:w)        Watches a Drupal CI job
 issue
  issue:apply                  Applies the latest patch from an issue.
  issue:branch                 Creates a branch for the issue.
  issue:link                   Opens an issue
  issue:patch                  Generate a patch for the issue from committed local changes.
 maintainer
  maintainer:issues (mi)       Lists issues for a user, based on maintainer.
  maintainer:release-notes     Generate release notes.
 project
  project:issues (pi)          Lists issues for a project.
  project:kanban               Opens project kanban
  project:link                 Opens project page
  project:release-notes (rn)   View release notes for a release
  project:releases             Lists available releases
 tci
 travisci
  travisci:list (tci:l)        Lists Travis Ci builds for a Drupal project
  travisci:watch (tci:w)       Watches a Travis CI job

Getting Started

Working with project issues

If you want to use this to generate patches that you can contribute back to a Drupal project, it's best to work within a cloned repo of that project. To get instructions for cloning a project's repo, visit the "Version Control" tab on the project page.

From within the directory of the project we're working on:

  • drupalorg issue:apply [issue number] - Create a new branch for the given issue, apply the latest patch on the issue to the new branch, then commit the changes locally.
  • drupalorg issue:patch [issue number] - Create a new patch for the given issue from the changes committed locally.
You can’t perform that action at this time.