Spitfire/Patcher
Spitfire/Patcher
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

added replace-all patch type

Browse source
This commit is contained in:
partisan 2025-05-09 18:27:16 +02:00
parent bb7da3e154
commit 3d08b492ac
5 changed files with 134 additions and 25 deletions
Download patch file Download diff file Expand all files Collapse all files

68
README.md
View file

@ -63,6 +63,7 @@ Here are the details of each parameter used in the patching system:
- Defines the type of patch being applied. This parameter can be skipped if not applicable.
- Common types:
1. **`standard`:** Standard patching type that follows the `+` (add) and `-` (remove) syntax.
- Used for general file modifications.
- **Example:**
```patch
@ -72,9 +73,10 @@ Here are the details of each parameter used in the patching system:
-MOZ_APP_DISPLAYNAME=Firefox
+MOZ_APP_DISPLAYNAME=Spitfire
```
Note: *Type will fallback to t:standard when no type is specified.*
Note: *Type will fallback to t:standard when no type is specified.*
2. **`pref`:** Indicates that the patch is modifying preference settings (e.g., Firefox `prefs.js`).
- When `t:pref` is specified, the script will search for existing preferences in the input file and replace them with the new ones provided in the patch. If a preference is not found, it will be added to the end of the file.
- **Example:**
```patch
@ -85,6 +87,7 @@ Here are the details of each parameter used in the patching system:
+pref("extensions.getAddons.showPane", false); // HIDDEN
```
3. **`new`:** Used for creating new files or overwriting existing files with specified content.
- Creates a new file at the `o:` location.
- **Example:**
```patch
@ -94,6 +97,7 @@ Here are the details of each parameter used in the patching system:
+This is a new file created by Spitfire Patcher.
```
4. **`copy`:**: Copies files or directories from the input path to the output path, overwriting if necessary.
- Copies the contents of a file or directory from i: to o:.
- **Example:**
```patch
@ -102,21 +106,38 @@ Here are the details of each parameter used in the patching system:
o:/browser/branding/official
```
5. **`marker`:** Modifies a file relative to a specific marker line.
- A line starting with # defines the marker.
- Lines starting with + are inserted immediately after the marker.
- Lines starting with - are removed from the file (after the marker).
- **Example:**
```patch
t:marker
i:/browser/locales/en-US/firefox-l10n.js
o:/browser/locales/en-US/firefox-l10n.js
#static const RedirEntry kRedirMap[] =
+ {"store", "http://localhost:20351/",
+ nsIAboutModule::ALLOW_SCRIPT |
+ nsIAboutModule::URI_MUST_LOAD_IN_CHILD |
+ nsIAboutModule::URI_CAN_LOAD_IN_PRIVILEGEDABOUT_PROCESS},
```
- A line starting with # defines the marker.
- Lines starting with + are inserted immediately after the marker.
- Lines starting with - are removed from the file (after the marker).
- **Example:**
```patch
t:marker
i:/browser/locales/en-US/firefox-l10n.js
o:/browser/locales/en-US/firefox-l10n.js
#static const RedirEntry kRedirMap[] =
+ {"store", "http://localhost:20351/",
+ nsIAboutModule::ALLOW_SCRIPT |
+ nsIAboutModule::URI_MUST_LOAD_IN_CHILD |
+ nsIAboutModule::URI_CAN_LOAD_IN_PRIVILEGEDABOUT_PROCESS},
```
6. **`replace-all`: Global String Replacer**
- This patch type performs literal string replacements across **all files** under the target path.
- Unlike `standard` or `pref`, this uses `=>` to define replacements and does **not** use `+` or `-` prefixes.
- The patcher will automatically **skip modifying itself** (its own executable and folder).
```patch
t:replace-all
i:.
o:.
string_to_find => string_to_replace_with
```
### Example Patch Files
@ -146,14 +167,15 @@ o:/browser/branding/official/new-file.txt
### Summary of Parameters
| Parameter | Purpose | Example |
| ----------- | ------------------------------------- | ------------------------------------- |
| `i:` | Specifies the input file path. | `i:/browser/app/profile/firefox.js` |
| `o:` | Specifies the output file path. | `o:/browser/app/profile/firefox.js` |
| `t:` | Defines the type of patch. | `t:pref`, `t:standard`, `t:new`, `t:marker` |
| `+` | Adds a line to the output file. | `+MOZ_APP_DISPLAYNAME=Spitfire` |
| `-` | Removes a line from the input file. | `-MOZ_APP_DISPLAYNAME=Firefox` |
| `#` | Marks a reference line for insertion (used in `marker` type). | `# 'settings',` |
| Parameter | Purpose | Example |
| ----------- | -------------------------------------------------------------- | --------------------------------------------- |
| `i:` | Specifies the input file path. | `i:/browser/app/profile/firefox.js` |
| `o:` | Specifies the output file path. | `o:/browser/app/profile/firefox.js` |
| `t:` | Defines the type of patch. | `t:pref`, `t:standard`, `t:new`, `t:marker` |
| `+` | Adds a line to the output file. | `+MOZ_APP_DISPLAYNAME=Spitfire` |
| `-` | Removes a line from the input file. | `-MOZ_APP_DISPLAYNAME=Firefox` |
| `#` | Marks a reference line for insertion (used in`marker` type). | `# 'settings',` |
### Workflow