https://github.com/machu-gwu/windtalker-project
Encrypt and decrypt text, binaries, files, and directories with a variety of cipher options.
https://github.com/machu-gwu/windtalker-project
cryptography encryption python tool
Last synced: 4 months ago
JSON representation
Encrypt and decrypt text, binaries, files, and directories with a variety of cipher options.
- Host: GitHub
- URL: https://github.com/machu-gwu/windtalker-project
- Owner: MacHu-GWU
- License: mit
- Created: 2016-05-17T09:10:41.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-01-22T20:16:51.000Z (over 2 years ago)
- Last Synced: 2024-05-02T06:01:16.703Z (about 2 years ago)
- Topics: cryptography, encryption, python, tool
- Language: Python
- Homepage:
- Size: 573 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
- Authors: AUTHORS.rst
Awesome Lists containing this project
README
.. image:: https://readthedocs.org/projects/windtalker/badge/?version=latest
:target: https://windtalker.readthedocs.io/
:alt: Documentation Status
.. image:: https://github.com/MacHu-GWU/windtalker-project/workflows/CI/badge.svg
:target: https://github.com/MacHu-GWU/windtalker-project/actions?query=workflow:CI
.. image:: https://codecov.io/gh/MacHu-GWU/windtalker-project/branch/master/graph/badge.svg
:target: https://codecov.io/gh/MacHu-GWU/windtalker-project
.. image:: https://img.shields.io/pypi/v/windtalker.svg
:target: https://pypi.python.org/pypi/windtalker
.. image:: https://img.shields.io/pypi/l/windtalker.svg
:target: https://pypi.python.org/pypi/windtalker
.. image:: https://img.shields.io/pypi/pyversions/windtalker.svg
:target: https://pypi.python.org/pypi/windtalker
.. image:: https://img.shields.io/badge/Release_History!--None.svg?style=social
:target: https://github.com/MacHu-GWU/windtalker-project/blob/master/release-history.rst
.. image:: https://img.shields.io/badge/STAR_Me_on_GitHub!--None.svg?style=social
:target: https://github.com/MacHu-GWU/windtalker-project
------
.. image:: https://img.shields.io/badge/Link-Document-blue.svg
:target: https://windtalker.readthedocs.io/
.. image:: https://img.shields.io/badge/Link-API-blue.svg
:target: https://windtalker.readthedocs.io/py-modindex.html
.. image:: https://img.shields.io/badge/Link-Install-blue.svg
:target: `install`_
.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
:target: https://github.com/MacHu-GWU/windtalker-project
.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
:target: https://github.com/MacHu-GWU/windtalker-project/issues
.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
:target: https://github.com/MacHu-GWU/windtalker-project/issues
.. image:: https://img.shields.io/badge/Link-Download-blue.svg
:target: https://pypi.org/pypi/windtalker#files
Welcome to ``windtalker`` Documentation
==============================================================================
.. image:: https://windtalker.readthedocs.io/_static/windtalker-logo.png
:target: https://windtalker.readthedocs.io/
In World War II, US Marine specially recruited a lots of bilingual Navajo speakers to serve in their standard communications units in the Pacific Theater. These Navajo transmitted tactical messages over military telephone or radio communications nets using formal or informally developed codes built upon their native languages. These people, we call them --- **Wind Talker**
``windtalker`` is a utility tools built on top of `cryptography `_ and `rsa `_. With this, **you can encrypt/decrypt binary data, text, files or even a entire directory in single line of code**! It support both symmetry and asymmetry encryption algorithm. For usage, you should start from `HERE `_
Example (SymmtricCipher):
.. code-block:: python
>>> from windtalker import SymmetricCipher
>>> c = SymmetricCipher(password="password") # Fernet encrypter
>>> c.encrypt_text("Hello")
Z0FBQUFBQlo0VHpVVjdWR0xCb0VEc0dMVUxib25jZEwzTWZ1UC1raFVmWndwNERrTmZVR1hNdzE3ZS05RWkwWXBrTi1adUhRWTNWYkxUT1Vkekh3MlVVcHZXLWxaMWMyOEE9PQ==
>>> c.encrypt_file(r"C:\test.py") # c.decrypt_file(xxx) for decryption
C:\test-encrypted.py
>>> c.encrypt_dir(r"C:\User\Admin\Document") # c.decrypt_dir(xxx) for decryption
C:\User\Admin\Document-encrypted.py
**HARDCODE YOUR PASSWORD IN YOUR CODE IS DANGEROUS!**:
You can create a ``.windtalker`` text file in your ${HOME} directory. and put your secret password in it. ``windtalker.SymmetricCipher`` can automatically read password from it.
${HOME} directory:
- Windows: ``C:\Users\``
- MacOS: ``/Users/``
- Linux: ``/home/``
For more features and how to use RSA to encrypt your file or directory, please read `THIS `_
.. _install:
Install
------------------------------------------------------------------------------
``windtalker`` is released on PyPI, so all you need is to:
.. code-block:: console
$ pip install windtalker
To upgrade to latest version:
.. code-block:: console
$ pip install --upgrade windtalker