Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/davereid/drush-patchfile
Utilities for maintaining patches on a Drupal installation
https://github.com/davereid/drush-patchfile
Last synced: about 2 months ago
JSON representation
Utilities for maintaining patches on a Drupal installation
- Host: GitHub
- URL: https://github.com/davereid/drush-patchfile
- Owner: davereid
- Created: 2014-01-17T19:02:51.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2017-09-08T11:04:53.000Z (over 7 years ago)
- Last Synced: 2024-10-08T08:29:59.569Z (3 months ago)
- Language: PHP
- Size: 41 KB
- Stars: 32
- Watchers: 6
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Drush Patch File
## Why?
This project seeks to solve the following problems:
* 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](https://github.com/drush-ops/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:
```ini
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.
_Example patches.make for a Drush Make project that references any files that contain patches:_
```ini
# 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.
_Example patches.make for a project not using Drush Make:_
```ini
; @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](https://github.com/drush-ops/drush) 5.x or higher
- A valid Drush make file for patches (or normal Drush make files) as described
above.
- [Git](http://git-scm.com/downloads)
## Installation
Download or git clone this repository into your ~/.drush directory, or wherever
your local Drush commands are stored.
You should also add the canonical location of the patch make file to your
project's drushrc.php:
```ini
# 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.
Adding a patch with a direct patch remote URL:
```bash
drush patch-add noderefcreate https://drupal.org/files/763454-9.patch
```
Adding a patch from a Drupal.org issue:
```bash
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.
### 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.
### drush patch-apply-all (paa)
Use this command to apply all the patches listed in the patch file.
### 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.
The following indicates that the patches were successfully re-applied.
```bash
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.
```bash
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]
```