<div align="center">
<h1>Ashar</h1>
<strong>ashar - free & open source project for text encryption with password protection.</strong>
<br><br>
</div>
[![Test on Ubuntu latest](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-linux.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-linux.yml)
[![Test on Windows latest](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-win.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-win.yml)
[![Test on MacOS latest](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-mac.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-mac.yml)
[![pypi-setup](https://github.com/yasserbdj96/ashar/actions/workflows/pypi-setup.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/pypi-setup.yml)
![Upload to PYPI](https://github.com/yasserbdj96/ashar/actions/workflows/pipup.yml/badge.svg)
[![Deploy static content to Pages](https://github.com/yasserbdj96/ashar/actions/workflows/pages.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/pages.yml)
[![CodeQL](https://github.com/yasserbdj96/ashar/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/codeql-analysis.yml)
[![CodeFactor](https://www.codefactor.io/repository/github/yasserbdj96/ashar/badge)](https://www.codefactor.io/repository/github/yasserbdj96/ashar)
[![Supported Versions](https://img.shields.io/pypi/pyversions/ashar.svg)](https://pypi.org/project/ashar)
[![Visitors](https://visitor-badge.laobi.icu/badge?page_id=yasserbdj96.ashar&format=true)](https://github.com/yasserbdj96/ashar)
[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%99%A5-red)](https://github.com/yasserbdj96/ashar)
[![Stars](https://img.shields.io/github/stars/yasserbdj96/ashar?color=red)](https://github.com/yasserbdj96/ashar)
[![Forks](https://img.shields.io/github/forks/yasserbdj96/ashar?color=red)](https://github.com/yasserbdj96/ashar)
[![Watching](https://img.shields.io/github/watchers/yasserbdj96/ashar?label=Watchers&color=red&style=flat-square)](https://github.com/yasserbdj96/ashar)
![GitHub contributors](https://img.shields.io/github/contributors/yasserbdj96/ashar)
![GitHub closed issues](https://img.shields.io/github/issues-closed/yasserbdj96/ashar)
![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/yasserbdj96/ashar)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/yasserbdj96/ashar)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/yasserbdj96/ashar)
[![GitHub license](https://img.shields.io/github/license/yasserbdj96/ashar)](https://github.com/yasserbdj96/ashar)
[![Join the chat at https://gitter.im/yasserbdj96/ashar](https://badges.gitter.im/yasserbdj96/ashar.svg)](https://gitter.im/yasserbdj96/ashar?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
<br>
<h2>Python Package Installation:</h2>
```
# install from pypi:
❯ pip install ashar
# local install:
❯ git clone https://github.com/yasserbdj96/ashar.git
❯ cd ashar
❯ sudo python setup.py install
# uninstall:
❯ pip uninstall ashar
```
<br>
<h2>Run without installation:</h2>
```
# Dwonload:
❯ git clone https://github.com/yasserbdj96/ashar.git
❯ cd ashar
# default run on any os:
❯ python3 run.py <CONDITION*> <PASSWORD*> <TEXT*>
# Run with Makefile:
❯ make run con="<CONDITION*>" pass="<PASSWORD*>" text="<TEXT*>"
# * = All inputs must be entered.
# PASSWORD = The password used for encrypt your text.
# TEXT = The text to be encrypted.
# CONDITION = The nature of the process is encryption or decryption "encode/decode".
```
<br>
<h2>Script Usage:</h2>
```python
from ashar import ashar
#For encryption
p1=ashar("<PASSWORD*>","<TEXT*>").encode()
# p1=ashar("<PASSWORD*>","<TEXT*>",chars='abcdefghijklmnopqrstuvwxyz',upchars='ABCDEFGHIJKLMNOPQRSTUVWXYZ',smbls=')(}{][><!?$%&-_=+;',numb='1234567890').encode()
print(p1)
#To decrypt
p2=ashar("<PASSWORD*>","<ENCRYPTED_TEXT*>").decode()
print(p2)
# * = All inputs must be entered.
```
<br>
<h2>Script Examples:</h2>
```python
from ashar import ashar
# Example:1
#For encryption
p1=ashar("123","Example:1").encode()
print(p1)
#To decrypt
p2=ashar("123",p1).decode()
print(p2)
```
<br>
<h2>Changelog History:</h2>
<a href="https://raw.githubusercontent.com/yasserbdj96/ashar/main/CHANGELOG">Click to See changelog History</a>
<br>
<h2>Development By:</h2>
Developer / Author: [yasserbdj96](https://github.com/yasserbdj96)
<br>
<h2>License:</h2>
<p>The content of this repository is bound by the following <a href="https://raw.githubusercontent.com/yasserbdj96/ashar/main/LICENSE">LICENSE</a>.</p>
<br>
<h2>Support:</h2>
<p>If you like `ashar` and want to see it improve furthur or want me to create intresting projects , You can buy me a coffee </p>
<div align="center">
<a href="https://ko-fi.com/yasserbdj96">
<img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="ashar by yasserbdj96">
</a><br>
BTC: bc1q2dks8w8uurca5xmfwv4jwl7upehyjjakr3xga9<br>
</div>
<br><br>
<p align="center">
<samp>
<a href="https://yasserbdj96.github.io/">website</a> .
<a href="https://github.com/yasserbdj96">github</a> .
<a href="https://gitlab.com/yasserbdj96">gitlab</a> .
<a href="https://www.linkedin.com/in/yasserbdj96">linkedin</a> .
<a href="https://twitter.com/yasserbdj96">twitter</a> .
<a href="https://instagram.com/yasserbdj96">instagram</a> .
<a href="https://www.facebook.com/yasserbdj96">facebook</a> .
<a href="https://www.youtube.com/@yasserbdj96">youtube</a> .
<a href="https://pypi.org/user/yasserbdj96">pypi</a> .
<a href="https://hub.docker.com/u/yasserbdj96">docker</a> .
<a href="https://t.me/yasserbdj96">telegram</a> .
<a href="https://gitter.im/yasserbdj96/yasserbdj96">gitter</a> .
<a href="mailto:yasser.bdj96@gmail.com">e-mail</a> .
<a href="https://ko-fi.com/yasserbdj96">sponsor</a>
</samp>
</p>
Raw data
{
"_id": null,
"home_page": "",
"name": "ashar",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.x.x",
"maintainer_email": "",
"keywords": "python,encoding,protection,encryption,text,decoder,decoding,password,python3,coding,encode,decryption,yasserbdj96",
"author": "yasserbdj96",
"author_email": "yasser.bdj96@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4d/52/4dfd5ff6a9637a6d5590920537389fcf56710a0b27a49ac53c98532f2b19/ashar-1.1.8.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <h1>Ashar</h1>\n <strong>ashar - free & open source project for text encryption with password protection.</strong>\n <br><br>\n</div>\n\n[![Test on Ubuntu latest](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-linux.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-linux.yml)\n[![Test on Windows latest](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-win.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-win.yml)\n[![Test on MacOS latest](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-mac.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/python-app-on-mac.yml)\n[![pypi-setup](https://github.com/yasserbdj96/ashar/actions/workflows/pypi-setup.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/pypi-setup.yml)\n![Upload to PYPI](https://github.com/yasserbdj96/ashar/actions/workflows/pipup.yml/badge.svg)\n[![Deploy static content to Pages](https://github.com/yasserbdj96/ashar/actions/workflows/pages.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/pages.yml)\n[![CodeQL](https://github.com/yasserbdj96/ashar/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/yasserbdj96/ashar/actions/workflows/codeql-analysis.yml)\n[![CodeFactor](https://www.codefactor.io/repository/github/yasserbdj96/ashar/badge)](https://www.codefactor.io/repository/github/yasserbdj96/ashar)\n[![Supported Versions](https://img.shields.io/pypi/pyversions/ashar.svg)](https://pypi.org/project/ashar) \n[![Visitors](https://visitor-badge.laobi.icu/badge?page_id=yasserbdj96.ashar&format=true)](https://github.com/yasserbdj96/ashar)\n[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%99%A5-red)](https://github.com/yasserbdj96/ashar)\n[![Stars](https://img.shields.io/github/stars/yasserbdj96/ashar?color=red)](https://github.com/yasserbdj96/ashar)\n[![Forks](https://img.shields.io/github/forks/yasserbdj96/ashar?color=red)](https://github.com/yasserbdj96/ashar)\n[![Watching](https://img.shields.io/github/watchers/yasserbdj96/ashar?label=Watchers&color=red&style=flat-square)](https://github.com/yasserbdj96/ashar)\n![GitHub contributors](https://img.shields.io/github/contributors/yasserbdj96/ashar)\n![GitHub closed issues](https://img.shields.io/github/issues-closed/yasserbdj96/ashar)\n![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/yasserbdj96/ashar)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/yasserbdj96/ashar)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/yasserbdj96/ashar)\n[![GitHub license](https://img.shields.io/github/license/yasserbdj96/ashar)](https://github.com/yasserbdj96/ashar)\n[![Join the chat at https://gitter.im/yasserbdj96/ashar](https://badges.gitter.im/yasserbdj96/ashar.svg)](https://gitter.im/yasserbdj96/ashar?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\n<br>\n<h2>Python Package Installation:</h2>\n\n```\n# install from pypi:\n\u276f pip install ashar\n\n# local install:\n\u276f git clone https://github.com/yasserbdj96/ashar.git\n\u276f cd ashar\n\u276f sudo python setup.py install\n\n# uninstall:\n\u276f pip uninstall ashar\n```\n\n<br>\n<h2>Run without installation:</h2>\n\n```\n# Dwonload:\n\u276f git clone https://github.com/yasserbdj96/ashar.git\n\u276f cd ashar\n\n# default run on any os:\n\u276f python3 run.py <CONDITION*> <PASSWORD*> <TEXT*>\n\n# Run with Makefile:\n\u276f make run con=\"<CONDITION*>\" pass=\"<PASSWORD*>\" text=\"<TEXT*>\"\n\n# * = All inputs must be entered.\n# PASSWORD = The password used for encrypt your text.\n# TEXT = The text to be encrypted.\n# CONDITION = The nature of the process is encryption or decryption \"encode/decode\".\n```\n\n<br>\n<h2>Script Usage:</h2>\n\n```python\nfrom ashar import ashar\n#For encryption\np1=ashar(\"<PASSWORD*>\",\"<TEXT*>\").encode()\n# p1=ashar(\"<PASSWORD*>\",\"<TEXT*>\",chars='abcdefghijklmnopqrstuvwxyz',upchars='ABCDEFGHIJKLMNOPQRSTUVWXYZ',smbls=')(}{][><!?$%&-_=+;',numb='1234567890').encode()\nprint(p1)\n \n#To decrypt\np2=ashar(\"<PASSWORD*>\",\"<ENCRYPTED_TEXT*>\").decode()\nprint(p2)\n\n# * = All inputs must be entered.\n\n```\n\n<br>\n<h2>Script Examples:</h2>\n\n```python\nfrom ashar import ashar\n# Example:1\n#For encryption\np1=ashar(\"123\",\"Example:1\").encode()\nprint(p1)\n \n#To decrypt\np2=ashar(\"123\",p1).decode()\nprint(p2)\n\n```\n\n<br>\n<h2>Changelog History:</h2>\n<a href=\"https://raw.githubusercontent.com/yasserbdj96/ashar/main/CHANGELOG\">Click to See changelog History</a>\n\n\n<br>\n<h2>Development By:</h2>\n\nDeveloper / Author: [yasserbdj96](https://github.com/yasserbdj96)\n\n<br>\n<h2>License:</h2>\n<p>The content of this repository is bound by the following <a href=\"https://raw.githubusercontent.com/yasserbdj96/ashar/main/LICENSE\">LICENSE</a>.</p>\n\n<br>\n<h2>Support:</h2>\n<p>If you like `ashar` and want to see it improve furthur or want me to create intresting projects , You can buy me a coffee </p>\n<div align=\"center\">\n <a href=\"https://ko-fi.com/yasserbdj96\">\n <img src=\"https://ko-fi.com/img/githubbutton_sm.svg\" alt=\"ashar by yasserbdj96\">\n </a><br>\n BTC: bc1q2dks8w8uurca5xmfwv4jwl7upehyjjakr3xga9<br>\n</div>\n\n<br><br>\n\n<p align=\"center\">\n <samp>\n <a href=\"https://yasserbdj96.github.io/\">website</a> .\n <a href=\"https://github.com/yasserbdj96\">github</a> .\n <a href=\"https://gitlab.com/yasserbdj96\">gitlab</a> .\n <a href=\"https://www.linkedin.com/in/yasserbdj96\">linkedin</a> .\n <a href=\"https://twitter.com/yasserbdj96\">twitter</a> .\n <a href=\"https://instagram.com/yasserbdj96\">instagram</a> .\n <a href=\"https://www.facebook.com/yasserbdj96\">facebook</a> .\n <a href=\"https://www.youtube.com/@yasserbdj96\">youtube</a> .\n <a href=\"https://pypi.org/user/yasserbdj96\">pypi</a> .\n <a href=\"https://hub.docker.com/u/yasserbdj96\">docker</a> .\n <a href=\"https://t.me/yasserbdj96\">telegram</a> .\n <a href=\"https://gitter.im/yasserbdj96/yasserbdj96\">gitter</a> .\n <a href=\"mailto:yasser.bdj96@gmail.com\">e-mail</a> .\n <a href=\"https://ko-fi.com/yasserbdj96\">sponsor</a>\n </samp>\n</p>\n\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "ashar - free & open source project for text encryption with password protection.",
"version": "1.1.8",
"split_keywords": [
"python",
"encoding",
"protection",
"encryption",
"text",
"decoder",
"decoding",
"password",
"python3",
"coding",
"encode",
"decryption",
"yasserbdj96"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "e6d0d8090964091c6b39ac553aff7034",
"sha256": "662eeb17877287deb995187706a005f20d910d151b2d2b1e1ddf0aec2088839c"
},
"downloads": -1,
"filename": "ashar-1.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e6d0d8090964091c6b39ac553aff7034",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.x.x",
"size": 9132,
"upload_time": "2022-12-09T23:24:46",
"upload_time_iso_8601": "2022-12-09T23:24:46.510822Z",
"url": "https://files.pythonhosted.org/packages/33/ba/cbb8229f732008c71040f957ce3a8692b78a145bcb75c7435d439ec9c3e8/ashar-1.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "280d624bf073506b9875f296b8aa7185",
"sha256": "0f2925d4659a612721e513b74dc792740db9e9b3b30d91d9d7c298062760df94"
},
"downloads": -1,
"filename": "ashar-1.1.8.tar.gz",
"has_sig": false,
"md5_digest": "280d624bf073506b9875f296b8aa7185",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.x.x",
"size": 9133,
"upload_time": "2022-12-09T23:24:48",
"upload_time_iso_8601": "2022-12-09T23:24:48.007527Z",
"url": "https://files.pythonhosted.org/packages/4d/52/4dfd5ff6a9637a6d5590920537389fcf56710a0b27a49ac53c98532f2b19/ashar-1.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-09 23:24:48",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "ashar"
}