Merge pull request #11 from flashnuke/new/add_setup

New/add `setup.py`

Author: flashnuke

README.md

@@ -14,7 +14,7 @@ In order to truly bring the AP down, I usually run simultaneously two de-authers
 | 5 GHz     | 35 <--> 165   |
 
 ## How it works
-<img src="https://github.com/flashnuke/wifi-deauth/assets/59119926/7f9efac1-bb33-4bee-8b75-2aadd376d065" width="480">
+<img src="https://github.com/flashnuke/wifi-deauth/assets/59119926/26f75cce-0484-4949-840e-d23fa976ff9b" width="480">
 
 The program iterates over all possible channels, and by sniffing `802.11` packets it determines which access points are available. </br>
 After the attacker chooses a target access point to attack, the program:
@@ -23,8 +23,19 @@ After the attacker chooses a target access point to attack, the program:
 
 
 # Usage
+#### Installing on the system
 ```bash
-python3 wifi-deauth.py -i <iface>
+git clone https://github.com/flashnuke/wifi-deauth.git
+sudo pip3 install .
+sudo wifi-deauth -i <iface>
+```
+
+#### Running without installing 
+```bash
+git clone https://github.com/flashnuke/wifi-deauth.git
+pip3 install -r requirements.txt # install requirements manually
+cd wifi_deauth
+sudo python3 wifi_deauth.py -i <iface>
 ```
 
 ### Usage notes

setup.py

@@ -0,0 +1,30 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='wifi_deauth',
+    version='1.21',
+    description='WiFi deauthentication tool built with Python using the Scapy library',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
+    author='Flashnuke',
+    author_email='flashnuke@users.noreply.github.com',
+    url='https://github.com/flashnuke/wifi-deauth',
+    packages=find_packages(),
+    install_requires=[
+        'scapy>=2.4.3'
+    ],
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10'
+    ],
+    python_requires='>=3.6',
+    entry_points={
+        'console_scripts': [
+            'wifi-deauth=wifi_deauth.wifi_deauth:main',
+        ],
+    },
+)

wifi_deauth/__init__.py

@@ -1,17 +1,18 @@
 #!/usr/bin/env python3
 
-import copy
 import signal
 import logging
 import argparse
-import traceback
-import pkg_resources
 
 logging.getLogger("scapy.runtime").setLevel(logging.ERROR)  # suppress warnings
 
 from scapy.all import *
 from time import sleep
-from utils import *
+
+try:
+    from .utils import *
+except ImportError:
+    from utils import *
 
 conf.verb = 0
 
@@ -290,7 +291,7 @@ def user_abort(*args):
             exit(0)
 
 
-if __name__ == "__main__":
+def main():
     signal.signal(signal.SIGINT, Interceptor.user_abort)
 
     printf(f"\n{BANNER}\n"
@@ -304,8 +305,6 @@ def user_abort(*args):
 
     if "linux" not in platform:
         raise Exception(f"Unsupported operating system {platform}, only linux is supported...")
-    with open("requirements.txt", "r") as reqs:
-        pkg_resources.require(reqs.readlines())
 
     parser = argparse.ArgumentParser(description='A simple program to perform a deauth attack')
     parser.add_argument('-i', '--iface', help='a network interface with monitor mode enabled (i.e -> "eth0")',
@@ -327,3 +326,7 @@ def user_abort(*args):
                            bssid_name=pargs.custom_bssid,
                            custom_channels=pargs.custom_channels)
     attacker.run()
+
+
+if __name__ == "__main__":
+    main()