commit 327e9aaecbd4fd98c003048ae7801d9234831b2a · dunkirk.sh/soapdump

+15 -4

README.md

···

       52
        
       

     

       53
        
       ### Installation

     

       54
        
       

     

       55
       -
       Install directly from the flake:

     

       56
       -
       

     

       57
        
       ```bash

     

       58
        
       nix profile install github:taciturnaxolotl/soapdump

     

       59
        
       ```

     

       60
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       61
        
       Or run without installing:

     

       62
        
       

     

       63
        
       ```bash

     
···

       66
        
       

     

       67
        
       ## Output Format

     

       68
        
       

     

       69
       -
       Tab-separated values with the following fields:

     

       70
        
       

     

       71
        
       ```

     

       72
        
       TRANS_NUM|AMOUNT|CURRENCY|FIRSTNAME|LASTNAME|STREET|CITY|STATE|ZIP|CCTYPE|CCLAST4|EXPMONTH|EXPYEAR|CVV|TRANSID|STATUS|CORRID|PROC_AMOUNT

     
···

       78
        
       

     

       79
        
       <p align="center">

     

       80
        
       	<a href="https://github.com/taciturnaxolotl/soapdump/blob/main/LICENSE.md"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a>

     

       81
       -
       </p>

···

       52
        
       

     

       53
        
       ### Installation

     

       54
        
       

     

       0
        
       
     

       0
        
       
     

       55
        
       ```bash

     

       56
        
       nix profile install github:taciturnaxolotl/soapdump

     

       57
        
       ```

     

       58
        
       

     

       59
       +
       or in the flake:

     

       60
       +
       

     

       61
       +
       ```nix

     

       62
       +
       {

     

       63
       +
         inputs.terminal-wakatime.url = "github:hackclub/terminal-wakatime";

     

       64
       +
       

     

       65
       +
         outputs = { self, nixpkgs, terminal-wakatime, ... }: {

     

       66
       +
           # Access the package as:

     

       67
       +
           # terminal-wakatime.packages.${system}.default

     

       68
       +
         };

     

       69
       +
       }

     

       70
       +
       ```

     

       71
       +
       

     

       72
        
       Or run without installing:

     

       73
        
       

     

       74
        
       ```bash

     
···

       77
        
       

     

       78
        
       ## Output Format

     

       79
        
       

     

       80
       +
       Pipe-separated values with the following fields:

     

       81
        
       

     

       82
        
       ```

     

       83
        
       TRANS_NUM|AMOUNT|CURRENCY|FIRSTNAME|LASTNAME|STREET|CITY|STATE|ZIP|CCTYPE|CCLAST4|EXPMONTH|EXPYEAR|CVV|TRANSID|STATUS|CORRID|PROC_AMOUNT

     
···

       89
        
       

     

       90
        
       <p align="center">

     

       91
        
       	<a href="https://github.com/taciturnaxolotl/soapdump/blob/main/LICENSE.md"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a>

     

       92
       +
       </p>

+57 -66

src/soapdump.cpp

···

       163
        
           std::cout << "    --generate-zsh-completion     Generate Zsh completion script\n";

     

       164
        
           std::cout << "    --generate-fish-completion    Generate Fish completion script\n";

     

       165
        
           std::cout << "    --man                         Generate man page\n\n";

     

       166
       -
           std::cout << "OUTPUT FORMAT:\n";

     

       167
       -
           std::cout << "    TRANS_NUM|AMOUNT|CURRENCY|FIRSTNAME|LASTNAME|STREET|CITY|STATE|ZIP|CCTYPE|CCLAST4|EXPMONTH|EXPYEAR|CVV|TRANSID|STATUS|CORRID|PROC_AMOUNT\n\n";

     

       168
       -
           std::cout << "FIELD DESCRIPTIONS:\n";

     

       169
       -
           std::cout << "    TRANS_NUM    - Transaction sequence number\n";

     

       170
       -
           std::cout << "    AMOUNT       - Order total amount\n";

     

       171
       -
           std::cout << "    CURRENCY     - Currency code (USD, etc)\n";

     

       172
       -
           std::cout << "    FIRSTNAME    - Customer first name\n";

     

       173
       -
           std::cout << "    LASTNAME     - Customer last name\n";

     

       174
       -
           std::cout << "    STREET       - Street address\n";

     

       175
       -
           std::cout << "    CITY         - City name\n";

     

       176
       -
           std::cout << "    STATE        - State/Province code\n";

     

       177
       -
           std::cout << "    ZIP          - Postal code\n";

     

       178
       -
           std::cout << "    CCTYPE       - Credit card type (Visa, MasterCard, etc)\n";

     

       179
       -
           std::cout << "    CCLAST4      - Last 4 digits of credit card\n";

     

       180
       -
           std::cout << "    EXPMONTH     - Card expiration month\n";

     

       181
       -
           std::cout << "    EXPYEAR      - Card expiration year\n";

     

       182
       -
           std::cout << "    CVV          - CVV code\n";

     

       183
       -
           std::cout << "    TRANSID      - PayPal transaction ID\n";

     

       184
       -
           std::cout << "    STATUS       - Transaction status (Success/Failure)\n";

     

       185
       -
           std::cout << "    CORRID       - Correlation ID\n";

     

       186
       -
           std::cout << "    PROC_AMOUNT  - Actually processed amount\n\n";

     

       187
       -
           std::cout << "EXAMPLES:\n";

     

       188
       -
           std::cout << "    # Get all transactions\n";

     

       189
       -
           std::cout << "    " << programName << " payments.log\n\n";

     

       190
       -
           std::cout << "    # Get only successful transactions\n";

     

       191
       -
           std::cout << "    " << programName << " payments.log | grep Success\n\n";

     

       192
       -
           std::cout << "    # Count transactions by state\n";

     

       193
       -
           std::cout << "    " << programName << " payments.log | cut -d'|' -f8 | sort | uniq -c | sort -nr\n\n";

     

       194
       -
           std::cout << "    # Find largest transaction\n";

     

       195
       -
           std::cout << "    " << programName << " payments.log | sort -t'|' -k2 -nr | head -1\n\n";

     

       196
       -
           std::cout << "    # Get transactions over $500\n";

     

       197
       -
           std::cout << "    " << programName << " payments.log | awk -F'|' '$2 > 500'\n\n";

     

       198
       -
           std::cout << "    # Summary stats\n";

     

       199
       -
           std::cout << "    " << programName << " -s payments.log\n";

     

       200
        
       }

     

       201
        
       

     

       202
        
       void generateBashCompletion() {

     
···

       263
        
       }

     

       264
        
       

     

       265
        
       void generateManPage() {

     

       266
       -
           std::cout << R"(.TH SOAPDUMP 1 "September 2025" "soapdump 0.1.0" "User Commands"

     

       267
        
       .SH NAME

     

       268
       -
       soapdump \- PayPal SOAP log parser

     

       269
        
       .SH SYNOPSIS

     

       270
        
       .B soapdump

     

       271
       -
       [\fIOPTIONS\fR] \fILOGFILE\fR

     

       272
        
       .SH DESCRIPTION

     

       273
        
       .B soapdump

     

       274
       -
       is a high-performance PayPal SOAP log parser that extracts transaction data from log files and outputs it in a structured format.

     

       0
        
       
     

       0
        
       
     

       275
        
       .SH OPTIONS

     

       276
        
       .TP

     

       277
        
       .BR \-h ", " \-\-help

     

       278
       -
       Show help message and exit.

     

       279
        
       .TP

     

       280
        
       .BR \-s ", " \-\-summary

     

       281
       -
       Show summary statistics only.

     

       282
        
       .TP

     

       283
        
       .BR \-r ", " \-\-raw

     

       284
       -
       Output raw structured data (default).

     

       285
        
       .TP

     

       286
        
       .BR \-\-generate-bash-completion

     

       287
       -
       Generate Bash completion script.

     

       288
        
       .TP

     

       289
        
       .BR \-\-generate-zsh-completion

     

       290
       -
       Generate Zsh completion script.

     

       291
        
       .TP

     

       292
        
       .BR \-\-generate-fish-completion

     

       293
       -
       Generate Fish completion script.

     

       294
        
       .TP

     

       295
        
       .BR \-\-man

     

       296
       -
       Generate this man page.

     

       297
        
       .SH OUTPUT FORMAT

     

       298
       -
       The output is pipe-separated with the following fields:

     

       299
       -
       .PP

     

       300
        
       TRANS_NUM|AMOUNT|CURRENCY|FIRSTNAME|LASTNAME|STREET|CITY|STATE|ZIP|CCTYPE|CCLAST4|EXPMONTH|EXPYEAR|CVV|TRANSID|STATUS|CORRID|PROC_AMOUNT

     

       0
        
       
     

       0
        
       
     

       301
        
       .SH EXAMPLES

     

       302
       -
       .TP

     

       303
       -
       Get all transactions:

     

       304
       -
       .B soapdump payments.log

     

       305
       -
       .TP

     

       306
       -
       Get only successful transactions:

     

       307
       -
       .B soapdump payments.log | grep Success

     

       308
       -
       .TP

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       309
        
       Count transactions by state:

     

       310
       -
       .B soapdump payments.log | cut -d'|' -f8 | sort | uniq -c | sort -nr

     

       311
       -
       .TP

     

       312
       -
       Find largest transaction:

     

       313
       -
       .B soapdump payments.log | sort -t'|' -k2 -nr | head -1

     

       314
       -
       .TP

     

       315
       -
       Get transactions over $500:

     

       316
       -
       .B soapdump payments.log | awk -F'|' '$2 > 500'

     

       317
       -
       .TP

     

       318
       -
       Summary stats:

     

       319
       -
       .B soapdump -s payments.log

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       320
        
       .SH AUTHOR

     

       321
       -
       Kieran Klukas <me@dunkirk.sh>

     

       0
        
       
     

       0
        
       
     

       322
        
       .SH COPYRIGHT

     

       323
       -
       Copyright \(co 2025 Kieran Klukas. License: MIT.

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       324
        
       )" << std::endl;

     

       325
        
       }

     

       326

···

       163
        
           std::cout << "    --generate-zsh-completion     Generate Zsh completion script\n";

     

       164
        
           std::cout << "    --generate-fish-completion    Generate Fish completion script\n";

     

       165
        
           std::cout << "    --man                         Generate man page\n\n";

     

       166
       +
           std::cout << "For detailed information, field descriptions, and examples, run:\n";

     

       167
       +
           std::cout << "    " << programName << " --man | man -l -\n";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       168
        
       }

     

       169
        
       

     

       170
        
       void generateBashCompletion() {

     
···

       231
        
       }

     

       232
        
       

     

       233
        
       void generateManPage() {

     

       234
       +
           std::cout << R"(.TH SOAPDUMP 1 "December 2024" "soapdump 1.0" "User Commands"

     

       235
        
       .SH NAME

     

       236
       +
       soapdump \- parse PayPal SOAP transaction logs

     

       237
        
       .SH SYNOPSIS

     

       238
        
       .B soapdump

     

       239
       +
       [\fIOPTIONS\fR] \fIlogfile\fR

     

       240
        
       .SH DESCRIPTION

     

       241
        
       .B soapdump

     

       242
       +
       parses PayPal SOAP log files to extract transaction data. It reads log entries containing XML request/response pairs and outputs structured transaction information in pipe-delimited format suitable for further processing with standard Unix tools.

     

       243
       +
       

     

       244
       +
       The program matches SOAP requests with their corresponding responses to provide complete transaction records including customer information, payment details, and processing results.

     

       245
        
       .SH OPTIONS

     

       246
        
       .TP

     

       247
        
       .BR \-h ", " \-\-help

     

       248
       +
       Display help information and exit

     

       249
        
       .TP

     

       250
        
       .BR \-s ", " \-\-summary

     

       251
       +
       Display summary statistics instead of raw transaction data

     

       252
        
       .TP

     

       253
        
       .BR \-r ", " \-\-raw

     

       254
       +
       Output raw transaction data in pipe-delimited format (default behavior)

     

       255
        
       .TP

     

       256
        
       .BR \-\-generate-bash-completion

     

       257
       +
       Output bash shell completion script

     

       258
        
       .TP

     

       259
        
       .BR \-\-generate-zsh-completion

     

       260
       +
       Output zsh shell completion script

     

       261
        
       .TP

     

       262
        
       .BR \-\-generate-fish-completion

     

       263
       +
       Output fish shell completion script

     

       264
        
       .TP

     

       265
        
       .BR \-\-man

     

       266
       +
       Output this manual page in troff format

     

       267
        
       .SH OUTPUT FORMAT

     

       268
       +
       By default, transactions are output one per line with pipe-separated fields:

     

       269
       +
       

     

       270
        
       TRANS_NUM|AMOUNT|CURRENCY|FIRSTNAME|LASTNAME|STREET|CITY|STATE|ZIP|CCTYPE|CCLAST4|EXPMONTH|EXPYEAR|CVV|TRANSID|STATUS|CORRID|PROC_AMOUNT

     

       271
       +
       

     

       272
       +
       Fields may be empty if not present in the source data.

     

       273
        
       .SH EXAMPLES

     

       274
       +
       Parse a log file and display all transactions:

     

       275
       +
       .RS

     

       276
       +
       .B soapdump paypal.log

     

       277
       +
       .RE

     

       278
       +
       

     

       279
       +
       Show only successful transactions:

     

       280
       +
       .RS

     

       281
       +
       .B soapdump paypal.log | grep '|Success|'

     

       282
       +
       .RE

     

       283
       +
       

     

       284
        
       Count transactions by state:

     

       285
       +
       .RS

     

       286
       +
       .B soapdump paypal.log | cut -d'|' -f8 | sort | uniq -c | sort -rn

     

       287
       +
       .RE

     

       288
       +
       

     

       289
       +
       Find the largest transaction amount:

     

       290
       +
       .RS

     

       291
       +
       .B soapdump paypal.log | sort -t'|' -k2 -rn | head -1

     

       292
       +
       .RE

     

       293
       +
       

     

       294
       +
       Show transactions over $500:

     

       295
       +
       .RS

     

       296
       +
       .B soapdump paypal.log | awk -F'|' '$2 > 500'

     

       297
       +
       .RE

     

       298
       +
       

     

       299
       +
       Display summary statistics:

     

       300
       +
       .RS

     

       301
       +
       .B soapdump --summary paypal.log

     

       302
       +
       .RE

     

       303
       +
       .SH FILES

     

       304
       +
       The input file should contain PayPal SOAP API log entries with request and response XML data.

     

       305
        
       .SH AUTHOR

     

       306
       +
       Written by Kieran Klukas.

     

       307
       +
       .SH REPORTING BUGS

     

       308
       +
       Report bugs to <me@dunkirk.sh>

     

       309
        
       .SH COPYRIGHT

     

       310
       +
       Copyright \(co 2024 Kieran Klukas.

     

       311
       +
       License MIT: <https://opensource.org/licenses/MIT>

     

       312
       +
       .br

     

       313
       +
       This is free software: you are free to change and redistribute it.

     

       314
       +
       There is NO WARRANTY, to the extent permitted by law.

     

       315
        
       )" << std::endl;

     

       316
        
       }

     

       317