xor-cipher-core

Simple, reusable and optimized XOR ciphers in Python (core).

xor-cipher-core is the core of xor-cipher.

Installing

Python 3.8 or above is required.

pip

Installing the library with pip is quite simple:

$ pip install xor-cipher-core

Alternatively, the library can be installed from source:

$ pip install git+https://github.com/xor-cipher/xor-cipher-core.git

Or via cloning the repository:

$ git clone https://github.com/xor-cipher/xor-cipher-core.git
$ cd xor-cipher-core
$ pip install .

uv

You can add xor-cipher-core as a dependency with the following command:

$ uv add xor-cipher-core

Examples

Simple Cipher

Use the xor function to perform the simple XOR cipher:

>>> from xor_cipher_core import xor
>>> xor(b"Hello, world!", 0x42)
b"\n'..-nb5-0.&c"

Cyclic Cipher

Use the cyclic_xor function to perform the cyclic XOR variation:

>>> from xor_cipher_core import cyclic_xor
>>> cyclic_xor(b"Hello, world!", b"BLOB")
b"\n)#.-`o5->#&c"

In-Place Cipher

There are functions to perform the XOR cipher in-place, on bytearray instances:

>>> from xor_cipher_core import xor_in_place
>>> data = bytearray(b"Hello, world!")
>>> xor_in_place(data, 0x42)
>>> data
bytearray(b"\n'..-nb5-0.&c")

Documentation

You can find the documentation here.

Support

If you need support with the library, you can send an email.

Changelog

You can find the changelog here.

Security Policy

You can find the Security Policy of xor-cipher-core here.

Contributing

If you are interested in contributing to xor-cipher-core, make sure to take a look at the Contributing Guide, as well as the Code of Conduct.

License

xor-cipher-core is licensed under the MIT License terms. See License for details.