Metadata-Version: 2.1
Name: tinyaes
Version: 1.0.3
Summary: tiny-AES-c wrapper in Cython
Home-page: https://github.com/naufraghi/tinyaes-py
Author: Matteo Bertini
Author-email: naufraghi@develer.com
License: MIT
Keywords: AES Cryptography block-cipher stream-cipher
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security :: Cryptography
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Cython
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# tiny-AES-c Cython wrapper

[![PyPI version](https://badge.fury.io/py/tinyaes.svg)](https://pypi.org/project/tinyaes/)



[`tinyaes`](https://github.com/naufraghi/tinyaes-py) is a few lines Cython

wrapper for the [`tiny-AES-c`](https://github.com/kokke/tiny-AES-c) library, a

_Small portable AES128/192/256 in C_.



The library offers a few modes, CTR mode is the only one currently wrapped.

Given the C API works modifying a buffer in-place, the wrapper offers:



- `CTR_xcrypt_buffer(..)` that works on all bytes convertible types, and

  encrypting a copy of the buffer,

- `CTR_xcrypt_buffer_inplace(..)` that works on `bytearray`s only, modifying

  the buffer in-place.



## Release notes

- 1.0.3rc1 (Nov 4, 2021):

  - add Python 3.10 to the matrix

- **1.0.2** (Nov 4, 2021):

  - version bump from 1.0.2rc1

  - bump to `manylinux2010` because of tlsv1 errors and drop Python 2.7

    missing in the new image

- 1.0.2rc1 (Apr 7, 2021):

  - added release Python 3.9 on Windows, Linux (`manylinux1`) and OSX

  - updated upstream [`tiny-AES-c`](https://github.com/kokke/tiny-AES-c) with

    some cleanups and small optimizations

- **1.0.1** (Jun 8, 2020):

  - release Python 3.6 OSX and Windows wheels

  - updated upstream [`tiny-AES-c`](https://github.com/kokke/tiny-AES-c) with

    some code changes

- **1.0.0** (Feb 20, 2020): updated readme (no code changes)

- 1.0.0a3 (Feb 7, 2020): fix bytes in-place mutation error

- 1.0.0a2 (Jan 29, 2020): first public release



## Like to help?



The CI is up and running, but on Linux only, running a minimal test suite that

uses [hypothesis](https://hypothesis.works), and that allowed me to find a

first bug, a missed variable replacement that had nefarious consequences.



The source package released on PyPI should be usable on Windows and MacOS too,

just `pip install tinyaes`.



The development instead is Linux centered, without any guide yet, but the CI

script can be a guide.



### TL;DR



- Download [Just](https://github.com/casey/just) and put it in your `PATH`.

- `just test` should install the library and the dependencies and run the tests

  using your default Python version.

- Inspect the `justfile` for some hints about what happens.



## Thanks



The library is very minimal, but nonetheless, it uses a lot of existing

software. I'd like to thank:



- [Cython](https://cython.org) developer for their wonderful "product", both

  the library and the documentation.



- Kudos to `kokke` for their [tiny-AES-c](https://github.com/kokke/tiny-AES-c)

  library, very minimal and easy to build and wrap for any usage that needs only

  the few AES modes it exposes.



- [Just](https://github.com/casey/just) developers for their automation tool,

  I use in most of my projects.



- A huge thank to all the [hypothesis](https://github.com/HypothesisWorks/hypothesis)

  authors to their fantastic library, that helped me to find an miss-named

  variable bug that I worked very hard to add in a 6 lines of code wrapper! And

  to this [Data-driven testing with Python](https://www.develer.com/en/data-driven-testing-with-python/)

  article that had left me with the desire to try the library.



