Added encipher & decipher methods

docs/changes.rst

@@ -16,6 +16,7 @@ Unreleased.
 
  - Added :meth:`Image.data_url() <wand.image.Image.data_url>` method. [:issue:`489`]
  - Added :attr:`Image.sampling_factors <wand.image.BaseImage.sampling_factors>` property. [:issue:`491`]
+ - Added :meth:`Image.encipher() <wand.image.BaseImage.encipher>` & :meth:`Image.decipher() <wand.image.BaseImage.decipher>` methods.
  - Uniformed additional pre-read parameters between :meth:`Image.__init__()` & :meth:`Image.read()`.
 
 

tests/image_methods_test.py

@@ -733,6 +733,16 @@ def test_emboss(fx_asset):
         assert was != img.signature
 
 
+def test_encipher_decipher():
+    with Image(filename='rose:') as img:
+        img.depth = 8  # Safety
+        was = img.signature
+        img.encipher(passphrase='secret')
+        assert was != img.signature
+        img.decipher(passphrase='secret')
+        assert was == img.signature
+
+
 def test_enhance(fx_asset):
     with Image(filename='rose:') as img:
         was = img.signature

wand/image.py

@@ -4190,6 +4190,24 @@ def cycle_color_map(self, offset=1):
         assertions.assert_integer(offset=offset)
         return library.MagickCycleColormapImage(self.wand, offset)
 
+    @manipulative
+    @trap_exception
+    def decipher(self, passphrase):
+        """Decrypt ciphered pixels into original values.
+
+        .. note::
+
+            :class:`~wand.exceptions.ImageError` will be thrown if the system's
+            ImageMagick library was compiled without cipher support.
+
+        :param passphrase: the secret passphrase to decrypt with.
+        :type passphrase: :class:`basestring`
+
+        .. versionadded:: 0.6.3
+        """
+        assertions.assert_string(passphrase=passphrase)
+        return library.MagickDecipherImage(self.wand, binary(passphrase))
+
     @manipulative
     @trap_exception
     def deconstruct(self):
@@ -4330,6 +4348,24 @@ def emboss(self, radius=0.0, sigma=0.0):
         assertions.assert_real(radius=radius, sigma=sigma)
         return library.MagickEmbossImage(self.wand, radius, sigma)
 
+    @manipulative
+    @trap_exception
+    def encipher(self, passphrase):
+        """Encrypt plain pixels into ciphered values.
+
+        .. note::
+
+            :class:`~wand.exceptions.ImageError` will be thrown if the system's
+            ImageMagick library was compiled without cipher support.
+
+        :param passphrase: the secret passphrase to encrypt with.
+        :type passphrase: :class:`basestring`
+
+        .. versionadded:: 0.6.3
+        """
+        assertions.assert_string(passphrase=passphrase)
+        return library.MagickDecipherImage(self.wand, binary(passphrase))
+
     @manipulative
     @trap_exception
     def enhance(self):