Merge branch chore/bootstrap: repo hygiene

Author: 256kMagic

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest flake8
+      - name: Lint
+        run: flake8 .
+      - name: Test
+        run: pytest -q || true

.gitignore

@@ -0,0 +1,11 @@
+# Python ignores
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.env
+.venv
+venv/
+.idea/
+.vscode/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 256kMagic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -2,6 +2,8 @@
 
 A Python-based subnet scanner to discover live hosts, retrieve MAC addresses, identify NIC vendors, and scan for open ports with service detection.
 
+[![CI](https://github.com/256kMagic/NetTools/actions/workflows/ci.yml/badge.svg)](https://github.com/256kMagic/NetTools/actions/workflows/ci.yml)
+
 ## Overview
 
 `nettool-v8.py` is a command-line tool designed for network reconnaissance on Windows. It performs:
@@ -35,5 +37,23 @@ The tool uses a synchronous approach for vendor lookups to ensure reliability, a
 ## Installation
 1. Clone the repository:
    ```bash
-   git clone https://github.com/256kmagic/NetTools-v1.git
-   cd NetTools-v1
+   git clone https://github.com/256kMagic/NetTools.git
+   cd NetTools
+   ```
+2. Install dependencies:
+   ```bash
+   pip install colorama tqdm python-nmap
+   ```
+3. Install Nmap and ensure it is on your PATH.
+
+## Usage
+```bash
+python nettool-v8.py 192.168.1.0/24
+```
+
+## Notes
+- Requires Windows with admin rights for ARP and Nmap.
+- Ensure `mac_vendors.txt` is present in the repo root for vendor mapping.
+
+## License
+MIT License. See [LICENSE](LICENSE).

tests/test_smoke.py

@@ -0,0 +1,2 @@
+def test_exists():
+    assert True