xahaud/hook/generate_extern.sh

#!/bin/bash
set -eu

SCRIPT_DIR=$(dirname "$0")
SCRIPT_DIR=$(cd "$SCRIPT_DIR" && pwd)

APPLY_HOOK="$SCRIPT_DIR/../include/xrpl/hook/hook_api.macro"

{
    echo '// For documentation please see: https://xrpl-hooks.readme.io/reference/'
    echo '// Generated using generate_extern.sh'
    echo '#include <stdint.h>'
    echo '#ifndef HOOK_EXTERN'
    echo '#ifdef __cplusplus'
    echo 'extern "C" {'
    echo '#endif'
    echo
    awk '
        function trim(s) {
            sub(/^[[:space:]]+/, "", s);
            sub(/[[:space:]]+$/, "", s);
            return s;
        }

        {
            line = $0;
            
            # Skip block comments
            if (line ~ /\/\*/) {
                next;
            }
            
            # Look for comment lines that start with // and contain function signature
            if (line ~ /^[[:space:]]*\/\/[[:space:]]*[a-zA-Z_][a-zA-Z0-9_]*[[:space:]]+[a-zA-Z_][a-zA-Z0-9_]*[[:space:]]*\(/) {
                # Remove leading // and trim
                sub(/^[[:space:]]*\/\/[[:space:]]*/, "", line);
                line = trim(line);
                
                # Check if function name is "_g" to add attribute
                if (line ~ /[[:space:]]+_g[[:space:]]*\(/) {
                    # Insert __attribute__((noduplicate)) before _g
                    sub(/[[:space:]]+_g/, " __attribute__((noduplicate)) _g", line);
                }

                if (line ~ /[[:space:]]+dice[[:space:]]*\(/) {
                    print "/*";
                    print "    Consensus entropy APIs.";
                    print "";
                    print "    min_tier is a fail-closed floor:";
                    print "      1 = consensus_fallback, 2 = participant_aligned, 3 = validator_quorum.";
                    print "    min_count is the minimum validator/reveal count the caller accepts.";
                    print "";
                    print "    If the most recent finalized entropy object does not satisfy both floors,";
                    print "    these APIs return TOO_LITTLE_ENTROPY. Open-ledger and simulate execution";
                    print "    are provisional previews over the entropy currently visible to the node;";
                    print "    final ordered ledger execution may see a different entropy object.";
                    print "*/";
                }
                
                # printf("\n");
                
                printf("extern %s\n\n", line);
            }
        }
    ' "$APPLY_HOOK"

    echo '#ifdef __cplusplus'
    echo '}'
    echo '#endif'
    echo '#define HOOK_EXTERN'
    echo '#endif  // HOOK_EXTERN'
} | (
    cd "$SCRIPT_DIR/.."
    clang-format --style=file -
)