<div align="center">
<h1>imbot</h1>
<strong>imbot - create a bot to control any website.</strong>
</div>
<br>
[](https://github.com/yasserbdj96/imbot/actions/workflows/python-app-on-linux.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/pypi-setup.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/docker-image.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/gcr.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/pipup.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/push-gitLab.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/pages.yml)
[](https://github.com/yasserbdj96/imbot/actions/workflows/codeql-analysis.yml)
[](https://www.codefactor.io/repository/github/yasserbdj96/imbot)
[](https://pypi.org/project/imbot)
[](https://github.com/yasserbdj96/imbot)
[](https://hub.docker.com/r/yasserbdj96/imbot/)
[](https://github.com/yasserbdj96/imbot)
[](https://github.com/yasserbdj96/imbot)
[](https://github.com/yasserbdj96/imbot)
[](https://github.com/yasserbdj96/imbot)
[](https://github.com/yasserbdj96/imbot)
[](https://gitter.im/yasserbdj96/imbot?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
<h2>Languages:</h2>
* python3
<h2>Requirements</h2>
[✓] hexor<br>
[✓] asciitext<br>
[✓] selenium
<h2>Docker pull,build & run:</h2>
```bash
# pull:
❯ docker pull yasserbdj96/imbot:latest
# build:
❯ docker build -t docker.io/yasserbdj96/imbot:latest .
# run:
❯ docker run -e headless=<True/False>* -e json_data='<PATH_TO_YOUR_JSON_FILE>*' -e opiration_title='<TITLE_OF_OPIRATION>*' -e argvs='<ARGV_DATA_ID>="<DATA_TO_INPUT>"' -i -t imbot:latest
# EX:
# docker run -e headless=True -e json_data="google.json" -e opiration_title="search" -e argvs='search_for="yasserbdj96 on github"' -i -t imbot:latest
# * = All inputs must be entered.
```
<h2>Github Packages pull,build & run:</h2>
```bash
# pull:
❯ docker pull ghcr.io/yasserbdj96/imbot:latest
# build:
❯ docker build -t ghcr.io/yasserbdj96/imbot:latest .
# run:
❯ docker run -e headless=<True/False>* -e json_data='<PATH_TO_YOUR_JSON_FILE>*' -e opiration_title='<TITLE_OF_OPIRATION>*' -e argvs='<ARGV_DATA_ID>="<DATA_TO_INPUT>"' -i -t ghcr.io/yasserbdj96/imbot:latest
# EX:
# docker run -e headless=True -e json_data="google.json" -e opiration_title="search" -e argvs='search_for="yasserbdj96 on github"' -i -t ghcr.io/yasserbdj96/imbot:latest
# * = All inputs must be entered.
```
<h2>Python Package Installation:</h2>
```
# Install from pypi:
❯ pip install imbot
# OR
❯ python -m pip install imbot
# Local install:
❯ git clone https://github.com/yasserbdj96/imbot.git
❯ cd imbot
❯ pip install -r requirements-pypi.txt
❯ sudo python setup.py install
# Uninstall:
❯ pip uninstall imbot
```
<h2>Run without installation:</h2>
```
❯ git clone https://github.com/yasserbdj96/imbot.git
❯ cd imbot
❯ pip install -r requirements.txt
❯ python run.py --headless <True/False> --json_data '<PATH_TO_YOUR_JSON_FILE>*' --opiration_title '<TITLE_OF_OPIRATION>*' --argvs '{"<ARGV_DATA_ID>":"<DATA_TO_INPUT>"}' --exec_path '<CHROMEDRIVER_PATH>'
# EX:
# python run.py --headless False --json_data './imbot-examples/google.json' --opiration_title 'search' --argvs '{"search_for":"yasserbdj96 github"}' --exec_path './chromedriver'
# * = All inputs must be entered.
# Run with Makefile:
❯ make run headless=<True/False> json_data='<PATH_TO_YOUR_JSON_FILE>*' opiration_title='<TITLE_OF_OPIRATION>*' argvs='{"<ARGV_DATA_ID>":"<DATA_TO_INPUT>"}' exec_path='<CHROMEDRIVER_PATH>'
```
<h2>Usage:</h2>
```python
from imbot import *
p1=imbot(json_data="<PATH_TO_JSON_FILE>*",sleep_time=2,url="<URL_TO_JSON_FILE>*",headless=True,exec_path="<CHROMEDRIVER_PATH>")
p1.run(<OPIRATION_TITLE>*,<VARIABLE_NAME>)
# * = All inputs must be entered.
p1.end()
"""
Default json code:
{
"url":"<WEBSITE_URL>",
"<OPIRATION_TITLE>":{
"operations":[
{"element_by":"<xpath/link_text/id/name/tag_name>","element_code":"<ELEMENT_CODE>","element_arg":"<VARIABLE_NAME>","opt":"<click/put/get>","arg_data":"<VARIABLE_NAME>","data":"<YOUR_DATA>","sleep":<Seconds>}
]
}
}
Help:
# Types of finding elements : "element_by"=[id,name,xpath,link_text,partial_link_text,tag_name,class_name,css_selector]
# If you don't use the 'code' key, you must use the 'element_arg' key to enter data from your script.
# If you don't use the 'data' key, you must use the 'arg_data' key to enter data from your script.
# When using the 'put' option you must use 'data' or 'arg_data', Unlike the "click" option.
# When using the 'get' option you must use 'data' or 'arg_data', Unlike the "click" option, data=get_attribute("<src/herf/name/id>").
# 'arg_data' and 'element_arg' are 'variable name'.
# 'arg_data' and 'element_arg' are the variable name of the element to be inserted from the list. //Example: p1.run(<OPIRATION_TITLE>,password="123456789")
# 'data' and 'element_code' for entering data like password or username from json file (this is a common option if the variables you want to use are static).
# 'sleep' To wait for a certain period before starting an operation.
"""
```
<h2>Examples:</h2>
```python
from imbot import *
# Examples
# Example 1:
# Open the website link:
p1=imbot("google.json")#,headless=False
# Here, search for a movie poster in Google Images and get the link:
print(p1.run("search",search_for="yasserbdj96 on github"))
print(p1.run("search",search_for="luffy one piece"))
# end
p1.end()
```
<h2>Screenshot:</h2>
<div align="center">
<a href="https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot.png">
<img alt="yasserbdj96" height="100" src="https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot.png">
</a>
<a href="https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot_1.png">
<img alt="yasserbdj96" height="100" src="https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot_1.png">
</a>
</div>
<br>
<h2>Changelog History:</h2>
<a href="https://raw.githubusercontent.com/yasserbdj96/imbot/main/CHANGELOG">Click to See changelog History</a>
<br>
<h2>Limitations:</h2>
# Types of finding elements : "element_by"=[id,name,xpath,link_text,partial_link_text,tag_name,class_name,css_selector]<br>
# If you don't use the 'code' key, you must use the 'element_arg' key to enter data from your script.<br>
# If you don't use the 'data' key, you must use the 'arg_data' key to enter data from your script.<br>
# When using the 'put' option you must use 'data' or 'arg_data', Unlike the "click" option.<br>
# When using the 'get' option you must use 'data' or 'arg_data', Unlike the "click" option, data=get_attribute("<src/herf/name/id>").<br>
# 'arg_data' and 'element_arg' are 'variable name'.<br>
# 'arg_data' and 'element_arg' are the variable name of the element to be inserted from the list. //Example: p1.run(<OPIRATION_TITLE>,password="123456789")<br>
# 'data' and 'element_code' for entering data like password or username from json file (this is a common option if the variables you want to use are static).<br>
# 'sleep' To wait for a certain period before starting an operation.
<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/imbot/main/LICENSE">LICENSE</a>.</p>
<br>
<h2>Support:</h2>
<p>If you like `imbot` 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="imbot 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": "imbot",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.x.x",
"maintainer_email": "",
"keywords": "yasserbdj96,python,bot,website bot,robot",
"author": "yasserbdj96",
"author_email": "yasser.bdj96@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/27/3a/34b998aabbfe1f7ed0a9ca3ed4f6b5df9f7afe00d55e2a278120dc69e0d7/imbot-0.1.8.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <h1>imbot</h1>\n <strong>imbot - create a bot to control any website.</strong>\n</div>\n<br>\n\n\n[](https://github.com/yasserbdj96/imbot/actions/workflows/python-app-on-linux.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/pypi-setup.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/docker-image.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/gcr.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/pipup.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/push-gitLab.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/pages.yml)\n[](https://github.com/yasserbdj96/imbot/actions/workflows/codeql-analysis.yml)\n[](https://www.codefactor.io/repository/github/yasserbdj96/imbot)\n[](https://pypi.org/project/imbot) \n[](https://github.com/yasserbdj96/imbot)\n[](https://hub.docker.com/r/yasserbdj96/imbot/)\n[](https://github.com/yasserbdj96/imbot)\n[](https://github.com/yasserbdj96/imbot)\n[](https://github.com/yasserbdj96/imbot)\n[](https://github.com/yasserbdj96/imbot)\n\n\n\n\n\n\n[](https://github.com/yasserbdj96/imbot)\n[](https://gitter.im/yasserbdj96/imbot?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\n\n<h2>Languages:</h2>\n* python3\n\n<h2>Requirements</h2>\n[\u2713] hexor<br>\n[\u2713] asciitext<br>\n[\u2713] selenium\n\n\n<h2>Docker pull,build & run:</h2>\n\n```bash\n# pull:\n\u276f docker pull yasserbdj96/imbot:latest\n\n# build:\n\u276f docker build -t docker.io/yasserbdj96/imbot:latest .\n\n# run:\n\u276f docker run -e headless=<True/False>* -e json_data='<PATH_TO_YOUR_JSON_FILE>*' -e opiration_title='<TITLE_OF_OPIRATION>*' -e argvs='<ARGV_DATA_ID>=\"<DATA_TO_INPUT>\"' -i -t imbot:latest\n# EX:\n# docker run -e headless=True -e json_data=\"google.json\" -e opiration_title=\"search\" -e argvs='search_for=\"yasserbdj96 on github\"' -i -t imbot:latest\n# * = All inputs must be entered.\n```\n\n<h2>Github Packages pull,build & run:</h2>\n\n```bash\n# pull:\n\u276f docker pull ghcr.io/yasserbdj96/imbot:latest\n\n# build:\n\u276f docker build -t ghcr.io/yasserbdj96/imbot:latest .\n\n# run:\n\u276f docker run -e headless=<True/False>* -e json_data='<PATH_TO_YOUR_JSON_FILE>*' -e opiration_title='<TITLE_OF_OPIRATION>*' -e argvs='<ARGV_DATA_ID>=\"<DATA_TO_INPUT>\"' -i -t ghcr.io/yasserbdj96/imbot:latest\n# EX:\n# docker run -e headless=True -e json_data=\"google.json\" -e opiration_title=\"search\" -e argvs='search_for=\"yasserbdj96 on github\"' -i -t ghcr.io/yasserbdj96/imbot:latest\n# * = All inputs must be entered.\n```\n\n<h2>Python Package Installation:</h2>\n\n```\n# Install from pypi:\n\u276f pip install imbot\n# OR\n\u276f python -m pip install imbot\n\n# Local install:\n\u276f git clone https://github.com/yasserbdj96/imbot.git\n\u276f cd imbot\n\u276f pip install -r requirements-pypi.txt\n\u276f sudo python setup.py install\n\n# Uninstall:\n\u276f pip uninstall imbot\n```\n\n<h2>Run without installation:</h2>\n\n```\n\u276f git clone https://github.com/yasserbdj96/imbot.git\n\u276f cd imbot\n\u276f pip install -r requirements.txt\n\u276f python run.py --headless <True/False> --json_data '<PATH_TO_YOUR_JSON_FILE>*' --opiration_title '<TITLE_OF_OPIRATION>*' --argvs '{\"<ARGV_DATA_ID>\":\"<DATA_TO_INPUT>\"}' --exec_path '<CHROMEDRIVER_PATH>'\n# EX:\n# python run.py --headless False --json_data './imbot-examples/google.json' --opiration_title 'search' --argvs '{\"search_for\":\"yasserbdj96 github\"}' --exec_path './chromedriver'\n# * = All inputs must be entered.\n\n# Run with Makefile:\n\u276f make run headless=<True/False> json_data='<PATH_TO_YOUR_JSON_FILE>*' opiration_title='<TITLE_OF_OPIRATION>*' argvs='{\"<ARGV_DATA_ID>\":\"<DATA_TO_INPUT>\"}' exec_path='<CHROMEDRIVER_PATH>'\n```\n\n<h2>Usage:</h2>\n\n```python\nfrom imbot import *\n\np1=imbot(json_data=\"<PATH_TO_JSON_FILE>*\",sleep_time=2,url=\"<URL_TO_JSON_FILE>*\",headless=True,exec_path=\"<CHROMEDRIVER_PATH>\")\n\np1.run(<OPIRATION_TITLE>*,<VARIABLE_NAME>)\n# * = All inputs must be entered.\n\np1.end()\n\n\"\"\"\nDefault json code:\n{\n \"url\":\"<WEBSITE_URL>\",\n \"<OPIRATION_TITLE>\":{\n \"operations\":[\n {\"element_by\":\"<xpath/link_text/id/name/tag_name>\",\"element_code\":\"<ELEMENT_CODE>\",\"element_arg\":\"<VARIABLE_NAME>\",\"opt\":\"<click/put/get>\",\"arg_data\":\"<VARIABLE_NAME>\",\"data\":\"<YOUR_DATA>\",\"sleep\":<Seconds>}\n ]\n }\n}\n\nHelp:\n# Types of finding elements : \"element_by\"=[id,name,xpath,link_text,partial_link_text,tag_name,class_name,css_selector]\n# If you don't use the 'code' key, you must use the 'element_arg' key to enter data from your script.\n# If you don't use the 'data' key, you must use the 'arg_data' key to enter data from your script.\n# When using the 'put' option you must use 'data' or 'arg_data', Unlike the \"click\" option.\n# When using the 'get' option you must use 'data' or 'arg_data', Unlike the \"click\" option, data=get_attribute(\"<src/herf/name/id>\").\n# 'arg_data' and 'element_arg' are 'variable name'.\n# 'arg_data' and 'element_arg' are the variable name of the element to be inserted from the list. //Example: p1.run(<OPIRATION_TITLE>,password=\"123456789\")\n# 'data' and 'element_code' for entering data like password or username from json file (this is a common option if the variables you want to use are static).\n# 'sleep' To wait for a certain period before starting an operation.\n\"\"\"\n```\n\n<h2>Examples:</h2>\n\n```python\nfrom imbot import *\n\n# Examples\n# Example 1:\n# Open the website link:\np1=imbot(\"google.json\")#,headless=False\n\n# Here, search for a movie poster in Google Images and get the link:\nprint(p1.run(\"search\",search_for=\"yasserbdj96 on github\"))\nprint(p1.run(\"search\",search_for=\"luffy one piece\"))\n\n# end\np1.end()\n```\n\n<h2>Screenshot:</h2>\n\n<div align=\"center\">\n <a href=\"https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot.png\">\n <img alt=\"yasserbdj96\" height=\"100\" src=\"https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot.png\">\n </a>\n <a href=\"https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot_1.png\">\n <img alt=\"yasserbdj96\" height=\"100\" src=\"https://raw.githubusercontent.com/yasserbdj96/imbot/main/screenshot/screenshot_1.png\">\n </a>\n</div>\n\n<br>\n<h2>Changelog History:</h2>\n<a href=\"https://raw.githubusercontent.com/yasserbdj96/imbot/main/CHANGELOG\">Click to See changelog History</a>\n\n<br>\n<h2>Limitations:</h2>\n# Types of finding elements : \"element_by\"=[id,name,xpath,link_text,partial_link_text,tag_name,class_name,css_selector]<br>\n# If you don't use the 'code' key, you must use the 'element_arg' key to enter data from your script.<br>\n# If you don't use the 'data' key, you must use the 'arg_data' key to enter data from your script.<br>\n# When using the 'put' option you must use 'data' or 'arg_data', Unlike the \"click\" option.<br>\n# When using the 'get' option you must use 'data' or 'arg_data', Unlike the \"click\" option, data=get_attribute(\"<src/herf/name/id>\").<br>\n# 'arg_data' and 'element_arg' are 'variable name'.<br>\n# 'arg_data' and 'element_arg' are the variable name of the element to be inserted from the list. //Example: p1.run(<OPIRATION_TITLE>,password=\"123456789\")<br>\n# 'data' and 'element_code' for entering data like password or username from json file (this is a common option if the variables you want to use are static).<br>\n# 'sleep' To wait for a certain period before starting an operation.\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/imbot/main/LICENSE\">LICENSE</a>.</p>\n\n<br>\n<h2>Support:</h2>\n<p>If you like `imbot` 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=\"imbot 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\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "imbot - create a bot to control any website.",
"version": "0.1.8",
"split_keywords": [
"yasserbdj96",
"python",
"bot",
"website bot",
"robot"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "1fb17a227be6a948dc5dea9adcdc83ec",
"sha256": "db63c24e844ec546b02dc210cb0a821b2ef6de57211d24c782e3ddf23973beca"
},
"downloads": -1,
"filename": "imbot-0.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1fb17a227be6a948dc5dea9adcdc83ec",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.x.x",
"size": 7694,
"upload_time": "2022-12-16T02:25:53",
"upload_time_iso_8601": "2022-12-16T02:25:53.680639Z",
"url": "https://files.pythonhosted.org/packages/d5/46/990e766aa8142ee35b877a268b483c2f617d2df2bc3c976edc6fdea337ff/imbot-0.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "23f26e232881bda3bba4d427ba96243a",
"sha256": "9d71adb047f4605a3d328240ab19a76c0a2d46de1f8f1f3adab616eccf3cb770"
},
"downloads": -1,
"filename": "imbot-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "23f26e232881bda3bba4d427ba96243a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.x.x",
"size": 7619,
"upload_time": "2022-12-16T02:25:55",
"upload_time_iso_8601": "2022-12-16T02:25:55.034953Z",
"url": "https://files.pythonhosted.org/packages/27/3a/34b998aabbfe1f7ed0a9ca3ed4f6b5df9f7afe00d55e2a278120dc69e0d7/imbot-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-16 02:25:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "imbot"
}
JSON