Metadata-Version: 2.1
Name: Num6
Version: 0.3.1
Summary: Num6 - An encrypter and decrypter tool for Python 3 (open source).
Home-page: https://github.com/almas-ali/num6
Author: Md. Almas Ali
Author-email: almaspr3@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security :: Cryptography
Classifier: Natural Language :: English
Classifier: Environment :: Console
Description-Content-Type: text/markdown
License-File: LICENSE

# Num6 - A Powerful Encrypter And Decrypter Tool
**Version 0.3.1**

Num6 is a very intelligent and efficient encrypter and decrypter open source tool. 
It is very fast and mostly user friendly.
Every characters are very much efficiently added to the library.
There just imaginary numbers not copied from anything.
All numbers are 6 digit number, this how it named **Num6**.
It is a Command Line Tools Upcoming is **GUI** Coming Soon...

**This is a Python 3 based script. Made and developed by [Md. Almas Ali](https://facebook.com/md.almasali.0 "Md. Almas Ali")**

### Details
[![LICENSE](https://img.shields.io/github/license/dwisiswant0/WiFiID.svg "LICENSE")](LICENSE)
![GitHub repo size](https://img.shields.io/github/repo-size/Almas-Ali/Num6?style=plastic "Size")

### Downloads
[![Downloads](https://static.pepy.tech/personalized-badge/num6?period=total&units=none&left_color=grey&right_color=blue&left_text=Total%20Downloads)](https://pepy.tech/project/num6 "Downloads")
[![Downloads](https://static.pepy.tech/personalized-badge/num6?period=month&units=none&left_color=grey&right_color=blue&left_text=Total%20Downloads)](https://pepy.tech/project/num6 "Downloads")
[![Downloads](https://static.pepy.tech/personalized-badge/num6?period=week&units=none&left_color=grey&right_color=blue&left_text=Total%20Downloads)](https://pepy.tech/project/num6 "Downloads")

> To get more details about this project download visit [Num6 Downloads][5]


## Logo
![Image](https://raw.githubusercontent.com/Almas-Ali/Num6/main/IMG/logo0.jpg)

## Character Library
![Image](https://raw.githubusercontent.com/Almas-Ali/Num6/main/IMG/img1.png)
![Image](https://raw.githubusercontent.com/Almas-Ali/Num6/main/IMG/img2.png)
![Image](https://raw.githubusercontent.com/Almas-Ali/Num6/main/IMG/img3.png)
![Image](https://raw.githubusercontent.com/Almas-Ali/Num6/main/IMG/img4.png)
![Image](https://raw.githubusercontent.com/Almas-Ali/Num6/main/IMG/img5.png)

## **Installation:**
As this is a python package, so you will have to setup this tool by pip.

## **For Windows**
Install Python 3 then follow the steps.
```
pip install num6
```

## **For Linux**
### All steps are given below: <br>
First install some essentials <br>
```
sudo apt-get update && sudo apt-get upgrade && sudo apt-get install python3 python3-dev python3-pip
```
Now you can install Num6 by pip.
```
pip3 install num6
```

## Installing from source
If your qurious you can also install it from source. For that you need this github repository in your computer. <br>
To clone this repository past this command in your command prompt or terminal. <br>

1. First install git

    1. For windows :
        * Download it from [Git][1] website.

    2. For Linux :
        ```
        sudo apt-get install git
        ```
2. Then past this command in your prompt:
    
    ```
    git clone https://github.com/almas-ali/num6.git
    ```
3. After clonning this repository follow this steps:

    1. For windows :

        1. Download [Git][1] from website.
        2. Download [Python 3][2] from website.
        3. Type `cd Num6`
        4. Type `python setup.py install`

    2. For Linux :

        1. First install [Git][1]
            ```
            sudo apt-get install git
            ```
        2. Then install [Python 3][2]
            ```
            sudo apt-get update && sudo apt-get upgrade && sudo apt-get install python3 python3-dev python3-pip
            ```

        3. After install [Python 3][2]
            * Type `cd Num6`
            * Type `python3 setup.py install`

## **Usage**
After you have successfully install Num6 on your system, then you can import it.
```
import num6
```
You can use two magor functions in there encrypt() and decrypt(). They takes two arguments now, string and pin. String is must but pin is optional. As default pin is 1.

**Example**

```
import num6
num6.encrypt('This is a test string')
```
**Output**
```
525252202020220022003300000010220022003300000010101010000010033030110011003300033030000010003300033030033033220022300033110010
```

```
import num6
num6.encrypt('This is a test string', 2)
```
**Output**
```
112112112212112112112212112112112212112212333133112212333133112212333133112212112212333133333133112212112212333133333133211222211222333133333133333133333133333133333133122111333133112212112212333133333133112212112212333133333133211222211222333133333133333133333133333133333133122111333133122111333133122111333133122111333133333133333133333133333133122111333133333133211222211222333133211222333133122111122111333133333133122111122111333133333133211222211222333133333133333133211222211222333133211222333133333133333133333133333133122111333133333133333133211222211222333133333133333133211222211222333133211222333133333133211222211222333133211222211222112212112212333133333133112212112212211222333133333133333133211222211222122111122111333133333133122111333133
```
Now how can you decrypt it like ugly looking number.

**Example**
```
import num6
num6.decrypt('525252202020220022003300000010220022003300000010101010000010033030110011003300033030000010003300033030033033220022300033110010')
```

**Output**
```
This is a test string
```

**Second example**
```
import num6
num6.decrypt('112112112212112112112212112112112212112212333133112212333133112212333133112212112212333133333133112212112212333133333133211222211222333133333133333133333133333133333133122111333133112212112212333133333133112212112212333133333133211222211222333133333133333133333133333133333133122111333133122111333133122111333133122111333133333133333133333133333133122111333133333133211222211222333133211222333133122111122111333133333133122111122111333133333133211222211222333133333133333133211222211222333133211222333133333133333133333133333133122111333133333133333133211222211222333133333133333133211222211222333133211222333133333133211222211222333133211222211222112212112212333133333133112212112212211222333133333133333133211222211222122111122111333133333133122111333133', 2)
```
**Output**
```
This is a test string
```

<div id="cli-example"></div>

## External Use As CLI
You can also use it as a CLI.
#### Windows
```
python -m num6 -h
```
#### Linux
```
python3 -m num6 -h
```

#### Output
```
usage: Num6 [-h] [-v] [-e ENCRYPT] [-d DECRYPT] [-p PIN] [-c]

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show the version information
  -e ENCRYPT, --encrypt ENCRYPT
                        to encrypt data from cli
  -d DECRYPT, --decrypt DECRYPT
                        to decrypt data from cli
  -p PIN, --pin PIN     set pin for encrpyt or decrypt data from cli
  -c, --cli             to use in interactive cli mode

```

## Some commands that you have to know

### In line encryption and decryption

### Encryption
#### Input (without any pin spacified)
```
python3 -m num6 -e 'test string'
```

#### Output
```
033030110011003300033030000010003300033030033033220022300033110010
```

#### Input (with pin spacified)

```
python3 -m num6 -e 'Num6 is great !' -p 3
```

### Output

```
112212122111112212112212122111112212122111122111112212112212122111112212122111122111112212112212122111112212112212122111112212112212122111112212122111122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222122111122111112212112212122111112212122111122111112212112212122111112212122111122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111112212122111122111112212112212112212112212122111122111112212112212112212122111112212112212122111122111122111112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111122111112212112212122111112212122111122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222122111122111112212112212122111112212122111122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111112212112212122111122111122111122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212122111112212112212122111122111122111122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111122111112212112212122111122111122111122111112212112212122111122111122111211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222112212122111122111112212112212112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111122111112212112212122111112212122111112212112212122111122111122111122111112212112212122111122111122111122111122111112212112212122111112212122111122111112212112212122111112212122111112212112212122111122111122111
```


### decryption
#### Input (without any pin spacified)
```
python3 -m num6 -d 033030110011003300033030000010003300033030033033220022300033110010
```

#### Output
```
test string
```

#### Input (with pin spacified)

```
python3 -m num6 -d 112212122111112212112212122111112212122111122111112212112212122111112212122111122111112212112212122111112212112212122111112212112212122111112212122111122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222122111122111112212112212122111112212122111122111112212112212122111112212122111122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111112212122111122111112212112212112212112212122111122111112212112212112212122111112212112212122111122111122111112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111122111112212112212122111112212122111122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222122111122111112212112212122111112212122111122111112212112212122111112212211222211222211222122111211222211222211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111112212112212122111122111122111122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212122111112212112212122111122111122111122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111122111112212112212122111122111122111122111112212112212122111122111122111211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222211222211222211222122111211222211222112212122111122111112212112212112212112212122111122111112212112212112212211222211222211222122111211222211222112212122111122111112212112212112212211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222211222211222211222122111211222211222122111112212112212122111122111122111211222211222211222122111211222211222122111122111112212112212122111112212122111112212112212122111122111122111122111112212112212122111122111122111122111122111112212112212122111112212122111122111112212112212122111112212122111112212112212122111122111122111 -p 3
```

### Output

```
Num6 is great !
```

### Calling the interactive CLI tool
```
python3 -m num6 --cli
```
**CLI Interface**

```
Num6 - A Powerful Encrypter And Decrypter Tool

1.  For word or line encryption
2.  For word or line decryption

3.  For file encryption enter path
4.  For file decryption enter path

0.  For stop the programme
00. For clearing the screen

© Copyright collected by Md. Almas Ali

Choice : 
```

We don't need to teach it to you. Anyone can play with it and learn it. It's an user friendly tool for our users.


## Encode your scripts
You can encode your scripts using this num6 module like builtin module marshal and base64 in Python3. Many fetures you can compare. Give it try today ! 
<br>


## For any bug report feel free to set a pull request or issue in Github

Our Github link : [Num6][3] <br>
Pypi link : [Num6][4] <br>

[1]: <https://git-scm.com/download> "Git"
[2]: <https://python.org/downloads> "Python 3"
[3]: <https://github.com/almas-ali/num6> "Num6 Github"
[4]: <https://pypi.org/project/Num6> "Num6 Pypi"
[5]: <https://pepy.tech/project/num6> "Download History"

-----------------------

Change Logs
========================

> Jump to latest changes <a href="#latest">Latest Chage</a>

1. Initial relese 0.0.1 (18-11-2020)

2. Updated some feture and made it comfurtable for python internal use. 0.1 (11-04-2021)

3. Updated some codes, improved performance, minor bugfix. 0.2 (02-07-2021)

4. Minor changed to functions. (04-07-2021)
    1. Functions name changed.
        1. encrypter() to encrypt()
        2. decrypter() to decrypt()
    
    2. Now those function will can take two argumens.
        1. **Strings** : Which is encryption or decryption values.
        2. **Pin** : Which is security number for encryption or decryption values. It can be must than 6 For some issue. It wll increase soon.
    3. Logics chaged. It is not so huge difference so on. But we are trying to improve our logics.

<div id="latest"></div>

5. Documentation update and minor bug fixed. (04-07-2021)
    1. In this version of [Num6][3] We have clear some documentation.
    2. Interactive CLI have been added. <a href="#cli-example">CLI Example</a>

--------------------------

