Metadata-Version: 2.1
Name: hashpipe
Version: 0.9.1
Summary: Regular expression match hasher
Home-page: https://github.com/scop/hashpipe
Author: Ville Skyttä
Author-email: ville.skytta@iki.fi
License: Apache License 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.3
Description-Content-Type: text/markdown
Requires-Dist: typing ; python_version < "3.5"

# hashpipe -- Regular expression match hasher

[![Python versions](https://img.shields.io/pypi/pyversions/hashpipe.svg)](https://pypi.org/project/hashpipe/)
[![PyPI version](https://badge.fury.io/py/hashpipe.svg)](https://badge.fury.io/py/hashpipe)
[![Build status](https://travis-ci.org/scop/hashpipe.svg?branch=master)](https://travis-ci.org/scop/hashpipe)
[![Test coverage](https://codecov.io/gh/scop/hashpipe/branch/master/graph/badge.svg)](https://codecov.io/gh/scop/hashpipe)

hashpipe is a command line tool and a Python library for hashing
regular expression matches in input data.

Matches are hashed with their HMAC hex digests using a configurable
key and digest algorithm, surrounded by angle brackets, and optionally
prefixed with a configurable string within the brackets.

What gets hashed for each match depends on whether the regular
expression contains capturing groups. If it doesn't, the entire match
content is hashed. If it does, only content of the first capturing
group is.

The command line tool operates as a pipe, reading standard input and
outputting to standard output.

## Examples

### Python

```python3
import os
import re

from hashpipe import Hashpipe

hashpipe = Hashpipe(
    pattern=re.compile(br"\bfox|dog\b"),
    algorithm="sha256",
    key=os.urandom(128),
)
hashed = hashpipe.hash_matches(b"The quick brown fox jumps over the lazy dog.")
# hashed now contains something like:
# b'The quick brown <00adbe4c178e322e582e4e45c4989a204655c4b3960c0be298bc763e29dc738b> '
# b'jumps over the lazy <ee68954fe2f64931fb63756a5ecd1e22b90984c6b29fe3340b159dcff1f98244>.'
```

### Shell

```
$ hashpipe --key=deadbeef --algorithm=md5 --prefix='{md5}' '^[^:]+' < /etc/passwd
<{md5}31572cc0e16e31b00f9888a18310ceab>:x:0:0:root:/root:/bin/bash
<{md5}1b4fa176c601aadfa5453b9074ba32d8>:x:1:1:daemon:/usr/sbin:/usr/sbin/nologin
...
```


