|
2 | 2 | title : 'Updating an existing package recipe' |
3 | 3 | date : 2025-08-01T14:33:00+01:00 |
4 | 4 | --- |
| 5 | +import { Aside } from '@astrojs/starlight/components'; |
5 | 6 |
|
6 | 7 | This page details the process of updating a package that is already present in the [AerynOS repository](https://github.com/AerynOS/recipes). |
7 | 8 |
|
@@ -125,3 +126,43 @@ sudo moss install "package name" |
125 | 126 | ``` |
126 | 127 |
|
127 | 128 | Once you have tested the package, you can make a submission for including the update in the repository. |
| 129 | + |
| 130 | +## Checking for updates |
| 131 | + |
| 132 | +To simplify update tracking for package maintainers, AerynOS provides a tool called **Ent**. Ent checks recipes against upstream sources to determine whether updates are available. |
| 133 | + |
| 134 | +Install Ent using `moss`: |
| 135 | + |
| 136 | +```bash |
| 137 | +sudo moss install ent |
| 138 | +``` |
| 139 | +**How Ent works** |
| 140 | + |
| 141 | +Ent scans the current directory and all subdirectories beneath it. It inspects each recipe `monitoring.yaml` file and compares the referenced `stone.yaml` recipe upstreams to determine whether newer versions are available. |
| 142 | + |
| 143 | +Because Ent operates relative to the directory in which it is executed, you can control the scope of the update check by choosing where to run the command within the recipes repository. |
| 144 | + |
| 145 | +***Running update checks*** |
| 146 | + |
| 147 | +To check for updates across all recipes, run the following command from the root of the recipes repository: |
| 148 | + |
| 149 | +```bash |
| 150 | +ent check updates |
| 151 | +``` |
| 152 | + |
| 153 | +You can also run this command from more specific locations: |
| 154 | + |
| 155 | +* **Repository root** |
| 156 | + Checks all recipes in the repository. |
| 157 | + |
| 158 | +* **Letter directory (for example, `f/`)** |
| 159 | + Checks only recipes whose names start with that letter. |
| 160 | + |
| 161 | +* **Specific recipe directory (for example, `f/firefox/`)** |
| 162 | + Checks only that single recipe. |
| 163 | + |
| 164 | +For example, running the command from `f/firefox/` will check only the Firefox recipe for available updates. |
| 165 | + |
| 166 | +<Aside type="note"> |
| 167 | + `ent` queries an upstream site for package release info *every time you run it*. Please be mindful of not running it gratuitously so as to remain a good ecosystem citizen. |
| 168 | +</Aside> |
0 commit comments