scopeverifier 0.1.1__tar.gz

scopeverifier-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jan Keuchel
+
+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.

scopeverifier-0.1.1/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: scopeverifier
+Version: 0.1.1
+Summary: scopeverifier checks if a list of domains is inside a scope which is defined by a list of IP addresses.
+Author: Jan Keuchel
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ScopeVerifier
+
+`scopeverifier` resolves a list of domains to IPv4 addresses and checks whether the resolved addresses are contained in a provided list of in-scope IPs.
+
+## Installation
+```bash
+pip install scopeverifier
+```
+
+## Usage
+```bash
+scopeverifier --domains domains.txt --ips ip-scope.txt -o results.csv
+```

scopeverifier-0.1.1/README.md

@@ -0,0 +1,13 @@
+# ScopeVerifier
+
+`scopeverifier` resolves a list of domains to IPv4 addresses and checks whether the resolved addresses are contained in a provided list of in-scope IPs.
+
+## Installation
+```bash
+pip install scopeverifier
+```
+
+## Usage
+```bash
+scopeverifier --domains domains.txt --ips ip-scope.txt -o results.csv
+```

scopeverifier-0.1.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "scopeverifier"
+version = "0.1.1"
+description = "scopeverifier checks if a list of domains is inside a scope which is defined by a list of IP addresses."
+readme = "README.md"
+requires-python = ">=3.9"
+
+authors = [
+    { name = "Jan Keuchel" }
+]
+
+[project.scripts]
+scopeverifier = "scopeverifier:main"
+
+[tool.setuptools]
+py-modules = ["scopeverifier"]

scopeverifier-0.1.1/scopeverifier.egg-info/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: scopeverifier
+Version: 0.1.1
+Summary: scopeverifier checks if a list of domains is inside a scope which is defined by a list of IP addresses.
+Author: Jan Keuchel
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ScopeVerifier
+
+`scopeverifier` resolves a list of domains to IPv4 addresses and checks whether the resolved addresses are contained in a provided list of in-scope IPs.
+
+## Installation
+```bash
+pip install scopeverifier
+```
+
+## Usage
+```bash
+scopeverifier --domains domains.txt --ips ip-scope.txt -o results.csv
+```

scopeverifier-0.1.1/scopeverifier.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+scopeverifier.py
+scopeverifier.egg-info/PKG-INFO
+scopeverifier.egg-info/SOURCES.txt
+scopeverifier.egg-info/dependency_links.txt
+scopeverifier.egg-info/entry_points.txt
+scopeverifier.egg-info/top_level.txt

scopeverifier-0.1.1/scopeverifier.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

scopeverifier-0.1.1/scopeverifier.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+scopeverifier = scopeverifier:main

scopeverifier-0.1.1/scopeverifier.egg-info/top_level.txt

@@ -0,0 +1 @@
+scopeverifier

scopeverifier-0.1.1/scopeverifier.py

@@ -0,0 +1,120 @@
+import subprocess
+import argparse
+import csv
+import ipaddress
+import sys
+import shutil
+import time
+
+def read_file_into_list(file_path):
+    res_list = []
+    try:
+        with open(file_path, encoding="utf-8") as f:
+            for line in f:
+                res_list.append(line.strip())
+    except Exception as e:
+        print(f"Error opening file: '{file_path}': {e}")
+        sys.exit(1)
+
+    return res_list
+
+
+def get_domain_ips(domain):
+    if len(domain) == 0:
+        return []
+
+    try:
+        ip = subprocess.run(["dig", "A", f"{domain}", "+short"],
+                            capture_output=True,
+                            text=True,
+                            timeout=10
+                            )
+    except subprocess.TimeoutExpired:
+        print(f"Lookup for '{domain}' timed out.")
+        return []
+
+    if ip.returncode != 0:
+        print(f"Error when looking up domain '{domain}'.")
+        return []
+    if len(ip.stdout.strip()) == 0:
+        print(f"The domain '{domain}' didn't resolve to any IP.")
+        return []
+
+    # Convert string which might contain multiple IP addresses
+    # and CNAME values separated by '\n' into a list of IP addresses 
+    ip_list_raw = ip.stdout.strip().split('\n')
+
+    # Filter out CNAME values
+    ip_list = []
+    for v in ip_list_raw:
+        try:
+            ipaddress.ip_address(v)
+            ip_list.append(v)
+        except Exception:
+            pass
+    
+    return ip_list
+
+def write_data_to_csv(data, out_file):
+    print(f"Writing results to {out_file}")
+    try:
+        with open(out_file, "w", newline="", encoding="utf-8") as csv_file:
+            fieldnames = ["domain", "ip", "in_scope"]
+            writer = csv.DictWriter(csv_file, fieldnames=fieldnames)
+            writer.writeheader()
+            writer.writerows(data)
+    except Exception as _:
+        print(f"Writing to '{out_file}' failed.")
+        sys.exit(1)
+
+def check_requirements():
+    if shutil.which("dig") is None:
+        print("Error: 'dig' is not installed.")
+        sys.exit(1)
+
+def main():
+
+    # --- Configure command line argument parser ---
+    parser = argparse.ArgumentParser(description="Verify if a list of domains is inside a scope, defined by a list of IPv4 addresses.")
+    parser.add_argument("-d", "--domains",
+                        type=str,
+                        required=True,
+                        help="Path to file with a list of domains to check.")
+
+    parser.add_argument("-i", "--ips",
+                        type=str,
+                        required=True,
+                        help="Path to file with a list of in-scope IP addresses.")
+
+    parser.add_argument("-o", "--outfile",
+                        type=str,
+                        required=True,
+                        help="Specify the CSV file to write the data to.")
+
+    args = parser.parse_args()
+
+    check_requirements()
+
+    domains_input = read_file_into_list(args.domains)
+    ips_input     = set(read_file_into_list(args.ips))
+
+    data = []
+
+    print(f"Resolving {len(domains_input)} domains...")
+    print("(Delay between requests: 0.5 seconds.)")
+    for d in domains_input:
+        ips = get_domain_ips(d)
+        time.sleep(0.5)
+        for ip in ips:
+            data.append({
+                "domain": d, 
+                "ip": ip,
+                "in_scope": ip in ips_input
+            })
+
+    write_data_to_csv(data, args.outfile)
+    print("Finished.")
+
+
+if __name__ == '__main__':
+    main()

scopeverifier-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+