Upload 3363 files

4cef980 verified about 2 years ago

2.74 kB

# -*- coding: utf-8 -*-
#
#  Cipher/XOR.py : XOR
#
# ===================================================================
# The contents of this file are dedicated to the public domain.  To
# the extent that dedication to the public domain is not available,
# everyone is granted a worldwide, perpetual, royalty-free,
# non-exclusive license to exercise all rights associated with the
# contents of this file for any purpose whatsoever.
# No rights are reserved.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
# ===================================================================
"""XOR toy cipher
XOR is one the simplest stream ciphers. Encryption and decryption are
performed by XOR-ing data with a keystream made by contatenating
the key.
Do not use it for real applications!
:undocumented: __revision__, __package__
"""

__revision__ = "$Id$"

from Crypto.Cipher import _XOR

class XORCipher:
    """XOR cipher object"""

    def __init__(self, key, *args, **kwargs):
        """Initialize a XOR cipher object
        
        See also `new()` at the module level."""
        self._cipher = _XOR.new(key, *args, **kwargs)
        self.block_size = self._cipher.block_size
        self.key_size = self._cipher.key_size

    def encrypt(self, plaintext):
        """Encrypt a piece of data.
        :Parameters:
          plaintext : byte string
            The piece of data to encrypt. It can be of any size.
        :Return: the encrypted data (byte string, as long as the
          plaintext).
        """
        return self._cipher.encrypt(plaintext)

    def decrypt(self, ciphertext):
        """Decrypt a piece of data.
        :Parameters:
          ciphertext : byte string
            The piece of data to decrypt. It can be of any size.
        :Return: the decrypted data (byte string, as long as the
          ciphertext).
        """
        return self._cipher.decrypt(ciphertext)

def new(key, *args, **kwargs):
    """Create a new XOR cipher
    :Parameters:
      key : byte string
        The secret key to use in the symmetric cipher.
        Its length may vary from 1 to 32 bytes.
    :Return: an `XORCipher` object
    """
    return XORCipher(key, *args, **kwargs)

#: Size of a data block (in bytes)
block_size = 1
#: Size of a key (in bytes)
key_size = range(1,32+1)

	# -- coding: utf-8 --
	#
	# Cipher/XOR.py : XOR
	#
	# ===================================================================
	# The contents of this file are dedicated to the public domain. To
	# the extent that dedication to the public domain is not available,
	# everyone is granted a worldwide, perpetual, royalty-free,
	# non-exclusive license to exercise all rights associated with the
	# contents of this file for any purpose whatsoever.
	# No rights are reserved.
	#
	# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
	# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
	# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
	# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
	# BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
	# ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
	# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
	# SOFTWARE.
	# ===================================================================
	"""XOR toy cipher

	XOR is one the simplest stream ciphers. Encryption and decryption are
	performed by XOR-ing data with a keystream made by contatenating
	the key.

	Do not use it for real applications!

	:undocumented: __revision__, __package__
	"""

	__revision__ = "$Id$"

	from Crypto.Cipher import _XOR

	class XORCipher:
	"""XOR cipher object"""

	def __init__(self, key, args, *kwargs):
	"""Initialize a XOR cipher object

	See also `new()` at the module level."""
	self._cipher = _XOR.new(key, args, *kwargs)
	self.block_size = self._cipher.block_size
	self.key_size = self._cipher.key_size

	def encrypt(self, plaintext):
	"""Encrypt a piece of data.

	:Parameters:
	plaintext : byte string
	The piece of data to encrypt. It can be of any size.
	:Return: the encrypted data (byte string, as long as the
	plaintext).
	"""
	return self._cipher.encrypt(plaintext)

	def decrypt(self, ciphertext):
	"""Decrypt a piece of data.

	:Parameters:
	ciphertext : byte string
	The piece of data to decrypt. It can be of any size.
	:Return: the decrypted data (byte string, as long as the
	ciphertext).
	"""
	return self._cipher.decrypt(ciphertext)

	def new(key, args, *kwargs):
	"""Create a new XOR cipher

	:Parameters:
	key : byte string
	The secret key to use in the symmetric cipher.
	Its length may vary from 1 to 32 bytes.

	:Return: an `XORCipher` object
	"""
	return XORCipher(key, args, *kwargs)

	#: Size of a data block (in bytes)
	block_size = 1
	#: Size of a key (in bytes)
	key_size = range(1,32+1)