findupd: black-magic fuckery

Author: MingcongBai

findupd/README.md

@@ -1,46 +1,83 @@
-## Update outdated packages
-1. go to aosc-os-abbs
+## Update Outdated Packages (Quick-n-Easy)
 
-```$ cd /var/lib/acbs/repo```
+1. Go to an ABBS tree
 
-2. Dump repology's outdated pkgs info. to local json file
+```$ cd /path/to/abbs-tree```
+
+2. Move all scripts to $PATH (e.g. /usr/local/bin)
+
+```
+$ mv findupd* /usr/local/bin
+$ mv *.py /usr/local/bin
+```
+
+3. Check for updates
+
+```
+# For all updates
+$ findupd
+
+# For patch-level (a.k.a. stable-proposed) updates
+$ findupd-stable
+```
+
+## Update Outdated Packages (Stick Shift Mastery)
+
+1. Go to an ABBS tree
+
+```$ cd /path/to/abbs-tree```
+
+2. Move all scripts to $PATH (e.g. /usr/local/bin)
+
+```
+$ mv findupd* /usr/local/bin
+$ mv *.py /usr/local/bin
+```
+
+3. Dump repology's outdated pkgs info. to local json file
 
 ```$ python3 update-pkgs.py -d ../repology.json```
 
-3. Search repo's outdated pkgs and replace newest version. (e.g. In the extra-graphics only)
+4. Search for updates (e.g. In the extra-graphics only)
+
 ```
 $ python3 update-pkgs.py -j ../repology.json  -c extra-graphics -r
 ```
 
-### Save update info. as file
+### Save Update Data Source to File
 
 ```
 $ python3 update-pkgs.py -j ../repology.json -s cache.txt
 ```
 
-### Save load cache file
+### Load Saved Data Source (as cache)
 
 ```
 $ python3 update-pkgs.py -l cache.txt -c extra-graphics -r -q
 ```
 
-### Support source https://packages.aosc.io/
+### Use AOSC OS Packages Site's Data Source
+
 1. $ wget "https://packages.aosc.io/srcupd/aosc-os-abbs?type=json&page=all" -O packages.json
 
 2. $ python3 update-pkgs.py -j ../packages.json  -c extra-graphics -r
 
-## Rebuild packages
+## Rebuild Packages
+
 1. Dump the packages list to rebuild
+
 ```
 $ apt list $(apt-cache rdepends mlt | sort -u) > /path/to/mlt.txt
 ```
 
-2. go to aosc-os-abbs
+2. Go to an ABBS tree
+
 ```
-$ cd /var/lib/acbs/repo
+$ cd /path/to/abbs-tree
 ```
 
-3. Auto bump REL in repo
+3. Automatically bump REL in repo
+
 ```
 $ python3 rebuild.py /path/to/mlt.txt
 ```

findupd/findupd

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+rm -rf /tmp/packages.json
+wget 'https://packages.aosc.io/srcupd/aosc-os-abbs?type=json&page=all' \
+    -O /tmp/packages.json
+
+update-pkgs.py -j /tmp/packages.json -s /tmp/cache.txt -q
+
+for i in "$@"; do
+    update-pkgs.py -l /tmp/cache.txt -c $i -r -q
+done
+
+rm -rf /tmp/cache.txt

findupd/findupd-stable

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+rm -rf /tmp/packages.json
+wget 'https://packages.aosc.io/srcupd/aosc-os-abbs?type=json&page=all' \
+    -O /tmp/packages.json
+
+update-pkgs.py -p -j /tmp/packages.json -s /tmp/cache.txt -q
+
+for i in "$@"; do
+    update-pkgs.py -p -l /tmp/cache.txt -c $i -r -q
+done
+
+rm -rf /tmp/cache.txt