add REPRODUCIBLE

This commit is contained in:
Joey Hess 2025-02-19 14:16:36 -04:00
parent f52385f63d
commit ace9944d1c
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38

View file

@ -10,7 +10,7 @@ When an compute special remote is initremoted, a program is specified:
The user adds an annexed file that is computed by the program by running The user adds an annexed file that is computed by the program by running
a command like this: a command like this:
git-annex addcomputed --with myremote \ git-annex addcomputed --to myremote \
--input raw=file.raw --value passes=10 \ --input raw=file.raw --value passes=10 \
--output photo=file.jpeg --output photo=file.jpeg
@ -72,7 +72,7 @@ supports. This allows `git-annex addcomputed` and `git-annex initremote` to
list inputs and outputs, and also lets them reject invalid inputs and list inputs and outputs, and also lets them reject invalid inputs and
outputs. outputs.
In this mode, the program is run a paramter "list". In this mode, the program is run with a "list" parameter.
It should output lines, in the form: It should output lines, in the form:
INPUT[?] Name Description INPUT[?] Name Description
@ -83,6 +83,12 @@ Use "INPUT" when a file is an input to the computation,
and "VALUE" for all other input values. Use "INPUT?" and "VALUE?" and "VALUE" for all other input values. Use "INPUT?" and "VALUE?"
for optional inputs and values. for optional inputs and values.
The program can also optionally output a "REPRODUCIBLE" line.
That indicates that the results of its computations are
expected to be bit-for-bit reproducible.
That makes `git-annex addcomputed` behave as if the `--reproducible`
option is set.
An example `git-annex-compute-foo` shell script follows: An example `git-annex-compute-foo` shell script follows:
#!/bin/sh #!/bin/sh
@ -91,6 +97,7 @@ An example `git-annex-compute-foo` shell script follows:
echo "INPUT raw A photo in RAW format" echo "INPUT raw A photo in RAW format"
echo "VALUE? passes Number of passes" echo "VALUE? passes Number of passes"
echo "OUTPUT photo Computed JPEG" echo "OUTPUT photo Computed JPEG"
echo "REPRODUCIBLE"
exit 0 exit 0
fi fi
if [ -z "$ANNEX_COMPUTE_VALUE_passes" ]; then if [ -z "$ANNEX_COMPUTE_VALUE_passes" ]; then