commit d679c9b229da21f8c356828891c0753f9b7ecfa5 Author: KatolaZ Date: Sat Jan 26 22:48:20 2019 +0000 initial commit diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..6957959 --- /dev/null +++ b/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2019 Vincenzo 'KatolaZ' Nicosia + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..4b7cb99 --- /dev/null +++ b/README.md @@ -0,0 +1,99 @@ + phrollo: a phlogroll in a shellscript +============================================= + +`phrollo` is a simple tool to manage a phlog roll. It uses a simple +configuration file and outputs the relevant selectors to be added to a +gophermap. The list of selectors of updated phlogs is sorted in +decreasing order of update time (meaning that more recent updates appear +at the top of the list). `phrollo` also outputs an updaterd config file, +to be used for future calls. + +`phrollo` detects updates by using `shasum -a 256`, i.e. by computing +a hash of the resource and comparing it with the hash obtained when the +resource was last seen. + + Usage +=========== + +1) +``` +./phrollo status.txt +``` + +In this case, `phrollo` will put a new config file in `status.txt.new`, +and output the sorted list of gopher selectors. The config file received +on input will also be saved in `status.txt.bak`. +2) + +``` + cat config.txt | ./phrollo +``` + +In this case, the new config file will be put in `phrollo.out`, and +output the sorted list of gopher selectors. + +IMPORTANT: The next time `phrollo` is run, it must be given the last +config file generated. + + Configuration file +======================== + +The format of the `phrollo` config file is as follows: + +DATE \t DESCRIPTION \t URI \t HOST \t PORT \t SHASUM + +where: + + - DATE: is the last time the phlog was updated, or an empty string for + a new phlog; + - DESCRIPTION: is the description of the phlog (e.g., the name of the + author) + - URI: is the path of the phlog + - HOST: well, the host + - PORT: normally 70 + - SHASUM: the shasum of the phlog at the time of the latest change, or + an empty string for a new phlog + + Example +============= + +Let us construct an initial `phrollo` config file containing all the +phlogs we would like to follow. Since `phrollo` has never seen any of +those phlogs, both DATE and SHASUM will be ignored. We will indicated +them with a "-" dash. Notice that fields are separated by actual TABs: + +``` +- Slugmax /~slugmax/cgi-bin/slerm zaibatsu.circumlunar.space 70 - +- RPDO /Phlog 1436.ninja 70 - +- Alex Shroeder / alexschroeder.ch 70 - +- Solderpunk /~solderpunk/phlog zaibatsu.circumlunar.space 70 - +- Tomasino /phlog gopher.black 70 - +- KatolaZ /~katolaz/phlog republic.circumlunar.space 70 - +``` + +Now we can feed this file to `phrollo` to get: + +``` +1(20190126) Alex Shroeder / alexschroeder.ch 70 +1(20190126) KatolaZ /~katolaz/phlog republic.circumlunar.space 70 +1(20190126) RPDO /Phlog 1436.ninja 70 +1(20190126) Slugmax /~slugmax/cgi-bin/slerm zaibatsu.circumlunar.space 70 +1(20190126) Solderpunk /~solderpunk/phlog zaibatsu.circumlunar.space 70 +1(20190126) Tomasino /phlog gopher.black 70 +``` + +which is a list of selectors corresponding to the phlogs specified in +the config file. Moreover, `phrollo` will also create the updated +config file `phrollo.out`: + +``` +20190126 Tomasino /phlog gopher.black 70 bd141abfc29522e3e2b5d00f1a656212201ae5def60de90a7ce847cddeb6d0db +20190126 Solderpunk /~solderpunk/phlog zaibatsu.circumlunar.space 70 4df8feff5237db12a4fb1c43d95f254dc26b0e35e3b008d53cc5004ad2c6acb9 +20190126 Slugmax /~slugmax/cgi-bin/slerm zaibatsu.circumlunar.space 70 bfd0e14e2c5b08fff6b968804dd253e488c5e0bfd9d80cec4ca7599928fac53f +20190126 RPDO /Phlog 1436.ninja 70 d61e34dfc71a10f5b45c6ccf7f6d96e4f976832efdd179e71a0981695b317dc9 +20190126 KatolaZ /~katolaz/phlog republic.circumlunar.space 70 af9b99199b344b027addeb09ba71621123bf799605b6190a65be145221bcefde +20190126 Alex Shroeder / alexschroeder.ch 70 36d66161d096c5c729a6433c411fad9da978931cdfab40e9bd57787aa0e0b1f6 +``` + +Then, we can run `phrollo` again using the latest updated config file +(i.e., `phrollo.out`) to detect updates. diff --git a/config_example.txt b/config_example.txt new file mode 100644 index 0000000..bcf109b --- /dev/null +++ b/config_example.txt @@ -0,0 +1,6 @@ +- Slugmax /~slugmax/cgi-bin/slerm zaibatsu.circumlunar.space 70 - +- RPDO /Phlog 1436.ninja 70 - +- Alex Shroeder / alexschroeder.ch 70 - +- Solderpunk /~solderpunk/phlog zaibatsu.circumlunar.space 70 - +- Tomasino /phlog gopher.black 70 - +- KatolaZ /~katolaz/phlog republic.circumlunar.space 70 - diff --git a/phrollo b/phrollo new file mode 100755 index 0000000..1e2ff91 --- /dev/null +++ b/phrollo @@ -0,0 +1,27 @@ +#!/bin/sh +# (c) 2019 KatolaZ +# MIT License + +FILEIN="${1:-/dev/stdin}" +TODAY="$(date +%Y%m%d)" +if [ "${FILEIN}" != '/dev/stdin' ]; then { + cat "${FILEIN}" | tee "${FILEIN}".bak > "${FILEIN}".new + FILEOUT="${FILEIN}".new +} else { + FILEOUT="$(basename $0).out" +} +fi + +IFS=' ' +while read -r D T S H P SH; do + NSH="$(printf "$S\r\n" | nc $H $P | shasum -a 256 | cut -d " " -f 1)" + [ $? -eq 0 ] && + [ "${SH}" != "${NSH}" ] && { + D="${TODAY}" + SH="${NSH}" + } + printf "%s\t%s\t%s\t%s\t%s\t%s\n" "$D" "$T" "$S" "$H" "$P" "$SH" +done < "${FILEIN}" | sort -rnk1 -k2 | tee "${FILEOUT}" | \ + sed -r "s/^([0-9][0-9]*) /1(\1) /g;s/ [a-f0-9][a-f0-9]*$//g" |\ + sort -k1 -k2 +