Drush Patch File
Why?
This project seeks to solve the following problems:, (*1)
- How do I document what patches I've applied to a project?
- How do I reliably know what patches are applied or not without manually checking every single one?
- How can I be reminded that I need to reapply a patch after downloading a module update?
About
This is a set of Drush commands to help you manage patches on your local Drupal
installation. Most developers (should) know about Drush Make files as a way to
store data about a site, installation profile, etc. When using Drush Make files,
typically you add information about the patches applied to a project in the
following way:, (*2)
projects[nodequeue][subdir] = contrib
projects[nodequeue][version] = 2.0-alpha1
projects[nodequeue][patch][] = "http://drupal.org/files/issues/1023606-qid-to-name-6.patch"
projects[nodequeue][patch][] = "http://drupal.org/files/issues/nodequeue_d7_autocomplete-872444-6.patch"
These Drush scripts can read a normal Drush make file just fine, and it will
only care about projects which have 'patch' defined. You should make sure that
the file referenced contains all the patches you need. If you have more than
one Drush make file (and most projects do), you can define a patches.make that
"includes" the other files., (*3)
Example patches.make for a Drush Make project that references any files that contain patches:, (*4)
# Our project contains patches for both Drupal core and contrib modules/themes.
includes[] = "drupal-org.make"
includes[] = "drupal-org-core.make"
If you are not using Drush make you can just add one Drush make file just for
the purpose of documenting your patches. I typically like to add extra
comments to give me even more info about each patch, like the issue to the
Drupal.org comment where I found the patch, or if the patch has been committed
to the module, and noting that I should remove it when I upgrade., (*5)
Example patches.make for a project not using Drush Make:, (*6)
; @see https://drupal.org/comment/5460918#comment-5460918
; @todo Remove when updating to 7.x-2.0-beta2 or higher
projects[nodequeue][patch][] = "https://drupal.org/files/node-mark-deprecated-1402634-1.patch"
; @see https://drupal.org/node/763454#comment-6070450
projects[noderefcreate][patch][] = "https://drupal.org/files/763454-9.patch"
Requirements
-
Drush 5.x or higher
- A valid Drush make file for patches (or normal Drush make files) as described
above.
- Git
Installation
Download or git clone this repository into your ~/.drush directory, or wherever
your local Drush commands are stored., (*7)
You should also add the canonical location of the patch make file to your
project's drushrc.php:, (*8)
# Patch file is relevant to the Drupal root directory. This example would refer
# a patch file that is located one directory up from the Drupal root. Define
# this option to save typing when running Drush commands for your project.
$options['patch-file'] = '../patches.make';
Usage
drush patch-add (pa)
Apply a patch to a project and list it in the patch file., (*9)
Adding a patch with a direct patch remote URL:, (*10)
drush patch-add noderefcreate https://drupal.org/files/763454-9.patch
Adding a patch from a Drupal.org issue:, (*11)
drush patch-add noderefcreate https://www.drupal.org/node/763454
Which patch do you want to apply?
[0] : Cancel
[1] : 763454-9.patch 3.37 KB by BrockBoland on comment 9
[2] : 763454-6-to-9.interdiff.txt 2.43 KB by BrockBoland on comment 9
[3] : noderefcreate_763454_multiredirect_to_origin.patch 3.19 KB by froboy on comment 5
[4] : noderefcreate_763454_multiredirect_to_origin.patch 3.16 KB by froboy on comment 6
[5] : noderefcreate_763454_multiredirect.patch 2.29 KB by akamaus on comment 4
drush patch-status (ps)
See a summary of the status of patches that have been applied. You'll receive
a status for each project that has patches. Response values are either Yes,
No, or Unsure. These should be obvious with the exception of Unsure. Unsure
means that the patch in question could neither be reverted from the current
state of the code (in which case the patch is applied, ie Yes) nor re-applied.
In the case of Unsure, you'll need to manually investigate the state of the
patch in question., (*12)
drush patch-project (pp)
Use this command to apply patches against a given project. If for example
you've updated a module and need to re-apply patches, you would use this comand
with that module name to do that., (*13)
drush patch-apply-all (paa)
Use this command to apply all the patches listed in the patch file., (*14)
drush pm-download (dl)
If you are running a drush dl on a module or theme that has a related patch,
after the download has been completed, the patch utility will attempt to apply
the patches again to the project. Use the patch application messages to see if
you will need to reroll the patch, or if it has been fixed., (*15)
The following indicates that the patches were successfully re-applied., (*16)
drush dl noderefcreate
Install location sites/all/modules/contrib/noderefcreate already exists. Do you want to overwrite it? (y/n): y
Project noderefcreate (7.x-1.0) downloaded to sites/all/modules/contrib/noderefcreate. [success]
noderefcreate patched with 763454-9.patch. [ok]
The following means either the patch does not apply and needs to be re-rolled,
or that the patch has possibly been included in the release that you downloaded,
and is no longer necessary., (*17)
drush dl noderefcreate
Install location sites/all/modules/contrib/noderefcreate already exists. Do you want to overwrite it? (y/n): y
Project noderefcreate (7.x-1.0) downloaded to sites/all/modules/contrib/noderefcreate. [success]
Unable to patch noderefcreate with 763454-9.patch. [error]
Wallogit.com
