debug mode

.github/workflows/build-debian.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Install build dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y build-essential debhelper dh-python python3-all
+          sudo apt-get install -y build-essential debhelper dh-python python3-all, python3-poetry
 
       - name: Prepare orig.tar.gz
         run: |

.gitignore

@@ -120,6 +120,7 @@ debian/*.debhelper
 debian/*/*.debhelper
 debian/*.log
 debian/*.list
+debian/okadminfinder/
 
 # Compiled Python modules
 *.pybuild/

README.md

@@ -8,7 +8,7 @@
 
 ## OKadminFinder: Easy way to find [Admin panel - Directories - Subdomains] of website
 
-*OKadminFinder is an Apache2 Licensed utility, rewritten in **Python 3.x**, for admins/pentesters who want to find admin panel of a website. There are many other tools but not as effective and secure. Yeah, Okadminfinder has the the ability to use tor and hide your identity*
+*OKadminFinder is an Apache2 Licensed utility, rewritten in **Python 3.x**, for admins/pentesters who want to find [Admin panel - Directories - Subdomains] of a website. There are many other tools but not as effective and secure. Yeah, Okadminfinder has the the ability to use tor and hide your identity*
 
 * ## Requirements
     ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/Django.svg)
@@ -50,8 +50,9 @@
    * #### Git Clone
       ```bash
       # Download and Usage
-      ❯ git clone https://github.com/mIcHyAmRaNe/okadminfinder3.git
-      ❯ cd okadminfinder3
+      ❯ git clone https://github.com/mIcHyAmRaNe/okadminfinder.git
+      ❯ cd okadminfinder
+      ❯ pip3 install -r requirements.txt
       ❯ chmod +x okadminfinder.py
       ❯ ./okadminfinder.py -h
       ```
@@ -66,6 +67,46 @@
 - [x] Random-Agents
 - [x] HTTP/HTTPS Proxies
 - [x] Socks4/5 & Tor
+- [x] Debug mode
+
+## Developer section
+
+  * #### PyPi
+      ```bash
+      # Install Poetry
+      curl -sSL https://install.python-poetry.org | python3 -
+      # Clone the repo
+      git clone https://github.com/mIcHyAmRaNe/okadminfinder.git
+      # Build the project
+      poetry build
+      # Publish the package
+      poetry publish
+      ```
+
+  * #### Debian
+      ```bash
+      # Install buid requirements 
+      sudo apt install debhelper dh-python python3-setuptools python3-all
+      # Clone the repo
+      git clone https://github.com/mIcHyAmRaNe/okadminfinder.git
+      # Create the source tarball
+      tar czf okadminfinder_{version}.orig.tar.gz okadminfinder
+      # Get inside the project folder
+      cd okadminfinder
+      # Build the deb package
+      dpkg-buildpackage -rfakeroot -uc -us
+      
+      # Notes:
+      # Steps from Python to Debian.
+      # Install Stdeb
+      pip install stdeb
+      # Debianize Python package creating debian folder
+      python3 setup.py --command-packages=stdeb.command debianize
+      # we edit rules, control files, we create changelog, man pages...
+      # Build deb package
+      dpkg-buildpackage -rfakeroot -uc -us
+      # before building a new version, make sure to 
+   ```
 
 ## Youtube videos
 - [okadminfinder : PyPi version](https://youtu.be/5C9aOinwKAs/)

debian/changelog

@@ -1,3 +1,10 @@
+okadminfinder (1.1.1-1) stable; urgency=low
+
+  * Debug mode.
+  * build the deb package using pyproject.toml instead of setup.py
+
+ -- mIcHy AmRaNe <6m63er17c@mozmail.com>  Thu, 11 Jul 2024 17:29:05 +0200
+
 okadminfinder (1.1.0-1) stable; urgency=low
 
   * source package automatically created by stdeb 0.10.0

debian/control

@@ -2,8 +2,8 @@ Source: okadminfinder
 Maintainer: mIcHy AmRaNe <6m63er17c@mozmail.com>
 Section: utils
 Priority: optional
-Build-Depends: debhelper (>= 10), dh-python, python3-setuptools, python3-all
-Standards-Version: 4.1.1
+Build-Depends: debhelper (>= 13), dh-python, python3-setuptools, python3-all
+Standards-Version: 4.6.0.1
 X-Python3-Version: >= 3.7
 Homepage: https://michyamrane.github.io/tools/okadminfinder/
 

debian/okadminfinder/DEBIAN/control

@@ -1,8 +1,8 @@
 Package: okadminfinder
-Version: 1.1.0-1
+Version: 1.1.1-1
 Architecture: all
 Maintainer: mIcHy AmRaNe <6m63er17c@mozmail.com>
-Installed-Size: 188
+Installed-Size: 112
 Depends: python3 (>= 3.2), python3-colorama, python3-httpx, python3-tqdm, python3-trio, python3:any (>= 3.7~), python3-socksio, tor
 Section: utils
 Priority: optional

debian/okadminfinder/DEBIAN/md5sums

@@ -1,21 +1,18 @@
-a9390a1a69d8566051e049685c558312  usr/bin/okadminfinder
-1975ef5740d2ee7b4cf2ce7581396db9  usr/lib/python3/dist-packages/okadminfinder-1.1.0.egg-info/PKG-INFO
-68b329da9893e34099c7d8ad5cb9c940  usr/lib/python3/dist-packages/okadminfinder-1.1.0.egg-info/dependency_links.txt
-7846eb8a930849cafc89433ab617e594  usr/lib/python3/dist-packages/okadminfinder-1.1.0.egg-info/entry_points.txt
-39a0ed2ae4d1f226111504cbb0dd41aa  usr/lib/python3/dist-packages/okadminfinder-1.1.0.egg-info/requires.txt
-ae628eb78f2658b8102085e5a9290749  usr/lib/python3/dist-packages/okadminfinder-1.1.0.egg-info/top_level.txt
+db61f7eb41140cbf3916e383b4562a28  usr/bin/okadminfinder
+365c9bfeb7d89244f2ce01c1de44cb85  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/INSTALLER
+e68ec21af774723df47ab92b76685649  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/METADATA
+a13d9b3b44ff57bf45a5d3d23438e734  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/RECORD
+d41d8cd98f00b204e9800998ecf8427e  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/REQUESTED
+d518ef9394654cb7fddcb7f50fb10cea  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/WHEEL
+cd762fd5afe02586c514c79eb20a17a9  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/direct_url.json
+84e901d729b350d862475d827d529946  usr/lib/python3/dist-packages/okadminfinder-1.1.1.dist-info/entry_points.txt
 d41d8cd98f00b204e9800998ecf8427e  usr/lib/python3/dist-packages/okadminfinder/LinkFile/__init__.py
 91e793c1acdc326c1c00317cdd6ae9bb  usr/lib/python3/dist-packages/okadminfinder/LinkFile/adminpanellinks.txt
 cf6ef7d33c16de82be944885259757fc  usr/lib/python3/dist-packages/okadminfinder/LinkFile/subdomains-top1million-5000.txt
 8dd0405bdf385368919d182f8ff98648  usr/lib/python3/dist-packages/okadminfinder/LinkFile/user-agent.txt
-4bb1cad0a7c9247c061537d6df5269a5  usr/lib/python3/dist-packages/okadminfinder/__init__.py
-587e5df3ca99fb66097634be092f1db2  usr/lib/python3/dist-packages/okadminfinder/_classes.py
-6bcd9d922543fd68aebbc0c25148c720  usr/lib/python3/dist-packages/okadminfinder/okadminfinder.py
-f281c084b2cc9c546e5f86023d6272d8  usr/share/doc/okadminfinder/changelog.Debian.gz
+4a5b13947173ddc00aff1db8c5481909  usr/lib/python3/dist-packages/okadminfinder/__init__.py
+499cbbfba8a49577bee308dc9c7ecacc  usr/lib/python3/dist-packages/okadminfinder/_classes.py
+e8a8c42ccf52185eafc66a28f27c9fdd  usr/lib/python3/dist-packages/okadminfinder/okadminfinder.py
+09e72577062cbf3390807aca3ec284f4  usr/share/doc/okadminfinder/changelog.Debian.gz
 a40a4311b3dcf95d2c448ce3132d46c8  usr/share/doc/okadminfinder/copyright
-6c621e31b388991fa3abaf28d2d549d5  usr/share/man/man1/okadminfinder.1.gz
-ae2d927cd44bb4b4bddeb07d3fee0311  usr/share/okadminfinder/LICENSE
-91e793c1acdc326c1c00317cdd6ae9bb  usr/share/okadminfinder/LinkFile/adminpanellinks.txt
-cf6ef7d33c16de82be944885259757fc  usr/share/okadminfinder/LinkFile/subdomains-top1million-5000.txt
-8dd0405bdf385368919d182f8ff98648  usr/share/okadminfinder/LinkFile/user-agent.txt
-7c01d30e1b6e102dcb8cd2e38734c824  usr/share/okadminfinder/README.md
+2b02ddec02f4c17a13cae8df6d4854bc  usr/share/man/man1/okadminfinder.1.gz

debian/okadminfinder/usr/bin/okadminfinder

@@ -1,33 +1,8 @@
 #! /usr/bin/python3
-# EASY-INSTALL-ENTRY-SCRIPT: 'okadminfinder==1.1.0','console_scripts','okadminfinder'
+# -*- coding: utf-8 -*-
 import re
 import sys
-
-# for compatibility with easy_install; see #2198
-__requires__ = 'okadminfinder==1.1.0'
-
-try:
-    from importlib.metadata import distribution
-except ImportError:
-    try:
-        from importlib_metadata import distribution
-    except ImportError:
-        from pkg_resources import load_entry_point
-
-
-def importlib_load_entry_point(spec, group, name):
-    dist_name, _, _ = spec.partition('==')
-    matches = (
-        entry_point
-        for entry_point in distribution(dist_name).entry_points
-        if entry_point.group == group and entry_point.name == name
-    )
-    return next(matches).load()
-
-
-globals().setdefault('load_entry_point', importlib_load_entry_point)
-
-
+from okadminfinder.okadminfinder import main
 if __name__ == '__main__':
-    sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
-    sys.exit(load_entry_point('okadminfinder==1.1.0', 'console_scripts', 'okadminfinder')())
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())