crsysapi 6.21.0

Python interface to CryptoSys API

This is a Python interface to the CryptoSys API library <https://www.cryptosys.net/api.html>.

CryptoSys API is a library to carry out “symmetrical” encryption using block ciphers like AES and Triple DES; stream ciphers ArcFour, Salsa and ChaCha20; Authenticated Encryption with Additional Data (AEAD); message authentication algorithms HMAC, CMAC and KMAC; hash functions SHA-1, SHA-2 and SHA-3; the PBKDF2 and SCRYPT key derivation functions; and more.

Requires: Python 3. CryptoSys API v6.21 or above must be installed on your system. This is available from

https://www.cryptosys.net/api.html.

To use in Python’s REPL

Using wild import for simplicity.

>>> from crsysapi import *  # @UnusedWildImport
>>> Gen.version() # "hello world!" for CryptoSys API
62000
>>> Hash.hex_from_data(b'abc') # compute SHA-1 hash in hex of 'abc' as bytes
'a9993e364706816aba3e25717850c26c9cd0d89d'
>>> Hash.hex_from_string('abc', Hash.Alg.SHA256)   # same but over a string and using SHA-256
'ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad'
>>> h = Hash.data(b'abc')   # h is a byte array (bytes->bytes)
>>> print(Cnv.tohex(h))     # display the byte array in hex
A9993E364706816ABA3E25717850C26C9CD0D89D

The stricter way using the crsysapi prefix.

>>> import crsysapi
>>> crsysapi.Gen.version() # Underlying core CryptoSys API dll
62000
>>> crsysapi.__version__  # crsysapi.py module version
6.20.0.0000
>>> crsysapi.Hash.hex_from_data(b'abc') # compute SHA-1 hash in hex of 'abc' as bytes
'a9993e364706816aba3e25717850c26c9cd0d89d'
>>> crsysapi.Hash.hex_from_string('abc', crsysapi.Hash.Alg.SHA256)   # same but over a string and using SHA-256
'ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad'
>>> h = crsysapi.Hash.data(b'abc')   # h is a byte array (bytes->bytes)
>>> print(crsysapi.Cnv.tohex(h))     # display the byte array in hex
A9993E364706816ABA3E25717850C26C9CD0D89D

Note that crsysapi.Gen.version() gives the version number of the underlying core (native) CryptoSys API DLL, and crsysapi.__version__ gives the version of the Python crsysapi module.

Examples

See the test file test/test_crsysapi.py for examples of all classes and methods. This creates any required test files automatically.

Contact

For more information or to make suggestions, please contact us at https://www.cryptosys.net/contact/

David Ireland

DI Management Services Pty Ltd

Australia

<https://www.di-mgt.com.au> <https://www.cryptosys.net>

18 May 2023

Revision History

6.21.0 (2023-05-18)

• Changes to match main core module version 6.21.

6.20.0 (2023-04-09)

• First release of crsysapi.py, the Python interface to CryptoSys API v6.20.