API Reference¶
Classes¶
- class ssdeep.Hash[source]¶
Hashlib like object. It is only supported with ssdeep/libfuzzy >= 2.10.
Raises: - InternalError – If lib returns internal error
- NotImplementedError – Required functions are not available
- digest(elimseq=False, notrunc=False)[source]¶
Obtain the fuzzy hash.
This operation does not change the state at all. It reports the hash for the concatenation of the data previously fed using update().
Returns: The fuzzy hash Return type: String Raises InternalError: If lib returns an internal error
- update(buf, encoding='utf-8')[source]¶
- Feed the data contained in the given buffer to the state.
Parameters: - buf (String|Byte) – The data to be hashed
- encoding (String) – Encoding is used if buf is String
Raises: - InternalError – If lib returns an internal error
- TypeError – If buf is not Bytes, String or Unicode
- class ssdeep.PseudoHash[source]¶
Hashlib like object. Use this class only if Hash() isn’t supported by your ssdeep/libfuzzy library. This class stores the provided data in memory, so be careful when hashing large files.
Functions¶
- ssdeep.compare(sig1, sig2)[source]¶
Computes the match score between two fuzzy hash signatures.
Returns a value from zero to 100 indicating the match score of the two signatures. A match score of zero indicates the signatures did not match.
Parameters: - sig1 (Bytes|String) – First fuzzy hash signature
- sig2 (Bytes|String) – Second fuzzy hash signature
Returns: Match score (0-100)
Return type: Integer
Raises: - InternalError – If lib returns an internal error
- TypeError – If sig is not String, Unicode or Bytes
- ssdeep.hash(buf, encoding='utf-8')[source]¶
Compute the fuzzy hash of a buffer
Parameters: buf (String|Bytes) – The data to be fuzzy hashed
Returns: The fuzzy hash
Return type: String
Raises: - InternalError – If lib returns an internal error
- TypeError – If buf is not String or Bytes
- ssdeep.hash_from_file(filename)[source]¶
Compute the fuzzy hash of a file.
Opens, reads, and hashes the contents of the file ‘filename’
Parameters: filename (String|Bytes) – The name of the file to be hashed
Returns: The fuzzy hash of the file
Return type: String
Raises: - IOError – If Python is unable to read the file
- InternalError – If lib returns an internal error