Skip to content

Repository files navigation

Convey

Build Status Downloads

Swiss knife for mutual conversion of the web related data types, like base64 or outputs of the programs whois, dig, curl. A convenient way to quickly gather all meaningful information or to process large files that might freeze your spreadsheet processor.

Any input is accepted:

  • if a single value input is detected, all meaningful information is fetched
  • multiline base64/quoted_printable string gets decoded
  • log/XLS/XLSX/ODS file converted to CSV
  • CSV file (any delimiter, header or pandoc table format) performs one or more actions
    1. Pick, delete or sort columns (if only some columns are needed)
    2. Add a column (computes one field from another – see computing fields)
    3. Filter (keep/discard rows with specific values, no duplicates)
    4. Split by a column (produce separate files instead of single file; these can then be sent by generic SMTP or through OTRS)
    5. Change CSV dialect (change delimiter or quoting character, remove header)
    6. Aggregate (count grouped by a column, sum...)
    7. Merge (join other file)
$ convey example.com    # single value: all meaningful information is fetched
$ convey file.csv       # CSV/log/XLS file: pick, add, filter, split, aggregate, merge columns
$ convey --server       # the same engine as a web service
pip3 install convey

Python3.10+ required.

Documentation

  • Usage — single query, CSV processor, web service.
  • Installation — prerequisites, PyPI/GitHub install, bash completion, customisation.
  • Fields:
    • Computing fields — computable and detectable fields, whois module, overview of all methods.
    • External fields — custom Python methods, PickMethod and PickInput decorators.
  • Web service
  • Sending files — mailing split chunks via SMTP or OTRS, dynamic templates.
  • Examples — URL parsing, CSV processing, file splitting, base64, units, aggregate, merge…
  • CLI options
  • Changelog

Brought by CSIRT.cz.

Releases

Packages

Used by

Contributors

Languages