]> git.mxchange.org Git - fba.git/blobdiff - fba/fba.py
Continued:
[fba.git] / fba / fba.py
index 1062d17d4c76c6e91c8a23ad72b132e3c83fa692..b175e57547aa6ebcd47d221e5ab19e3643571e2e 100644 (file)
 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 import hashlib
-import re
-import json
 import sqlite3
-import sys
-import time
 
-import bs4
+from urllib.parse import urlparse
+
 import requests
 import validators
 
-from urllib.parse import urlparse
-
 from fba import blacklist
-from fba import config
-from fba import instances
+from fba import federation
 from fba import network
 
-from fba.federation import lemmy
-from fba.federation import misskey
-from fba.federation import peertube
-
-# Array with pending errors needed to be written to database
-pending_errors = {
-}
-
-# "rel" identifiers (no real URLs)
-nodeinfo_identifier = [
-    "https://nodeinfo.diaspora.software/ns/schema/2.1",
-    "https://nodeinfo.diaspora.software/ns/schema/2.0",
-    "https://nodeinfo.diaspora.software/ns/schema/1.1",
-    "https://nodeinfo.diaspora.software/ns/schema/1.0",
-    "http://nodeinfo.diaspora.software/ns/schema/2.1",
-    "http://nodeinfo.diaspora.software/ns/schema/2.0",
-    "http://nodeinfo.diaspora.software/ns/schema/1.1",
-    "http://nodeinfo.diaspora.software/ns/schema/1.0",
-]
+from fba.models import instances
 
 # Connect to database
 connection = sqlite3.connect("blocks.db")
 cursor = connection.cursor()
 
-# Pattern instance for version numbers
-patterns = [
-    # semantic version number (with v|V) prefix)
-    re.compile("^(?P<version>v|V{0,1})(\.{0,1})(?P<major>0|[1-9]\d*)\.(?P<minor>0+|[1-9]\d*)(\.(?P<patch>0+|[1-9]\d*)(?:-(?P<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?)?$"),
-    # non-sematic, e.g. 1.2.3.4
-    re.compile("^(?P<version>v|V{0,1})(\.{0,1})(?P<major>0|[1-9]\d*)\.(?P<minor>0+|[1-9]\d*)(\.(?P<patch>0+|[1-9]\d*)(\.(?P<subpatch>0|[1-9]\d*))?)$"),
-    # non-sematic, e.g. 2023-05[-dev]
-    re.compile("^(?P<year>[1-9]{1}[0-9]{3})\.(?P<month>[0-9]{2})(-dev){0,1}$"),
-    # non-semantic, e.g. abcdef0
-    re.compile("^[a-f0-9]{7}$"),
-]
-
 ##### Other functions #####
 
 def is_primitive(var: any) -> bool:
     # DEBUG: print(f"DEBUG: var[]='{type(var)}' - CALLED!")
     return type(var) in {int, str, float, bool} or var is None
 
-def fetch_instances(domain: str, origin: str, software: str, script: str, path: str = None):
-    # DEBUG: print(f"DEBUG: domain='{domain}',origin='{origin}',software='{software}',path='{path}' - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-    elif not isinstance(origin, str) and origin is not None:
-        raise ValueError(f"Parameter origin[]={type(origin)} is not 'str'")
-    elif software is None:
-        print(f"DEBUG: software for domain='{domain}' is not set, determining ...")
-        software = determine_software(domain, path)
-        print(f"DEBUG: Determined software='{software}' for domain='{domain}'")
-    elif not isinstance(software, str):
-        raise ValueError(f"Parameter software[]={type(software)} is not 'str'")
-    elif not isinstance(script, str):
-        raise ValueError(f"Parameter script[]={type(script)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-
-    if not instances.is_registered(domain):
-        # DEBUG: print("DEBUG: Adding new domain:", domain, origin)
-        instances.add(domain, origin, script, path)
-
-    # DEBUG: print("DEBUG: Fetching instances for domain:", domain, software)
-    peerlist = fetch_peers(domain, software)
-
-    if (peerlist is None):
-        print("ERROR: Cannot fetch peers:", domain)
-        return
-    elif instances.has_pending_instance_data(domain):
-        # DEBUG: print(f"DEBUG: domain='{domain}' has pending nodeinfo data, flushing ...")
-        instances.update_data(domain)
-
-    print(f"INFO: Checking {len(peerlist)} instances from {domain} ...")
-    for instance in peerlist:
-        if instance is None:
-            # Skip "None" types as tidup() cannot parse them
-            continue
-
-        # DEBUG: print(f"DEBUG: instance='{instance}' - BEFORE")
-        instance = tidyup_domain(instance)
-        # DEBUG: print(f"DEBUG: instance='{instance}' - AFTER")
-
-        if instance == "":
-            print("WARNING: Empty instance after tidyup_domain(), domain:", domain)
-            continue
-        elif not validators.domain(instance.split("/")[0]):
-            print(f"WARNING: Bad instance='{instance}' from domain='{domain}',origin='{origin}',software='{software}'")
-            continue
-        elif blacklist.is_blacklisted(instance):
-            # DEBUG: print("DEBUG: instance is blacklisted:", instance)
-            continue
-
-        # DEBUG: print("DEBUG: Handling instance:", instance)
-        try:
-            if not instances.is_registered(instance):
-                # DEBUG: print("DEBUG: Adding new instance:", instance, domain)
-                instances.add(instance, domain, script)
-        except BaseException as exception:
-            print(f"ERROR: instance='{instance}',exception[{type(exception)}]:'{str(exception)}'")
-            continue
-
-    # DEBUG: print("DEBUG: EXIT!")
-
-def add_peers(rows: dict) -> list:
-    # DEBUG: print(f"DEBUG: rows()={len(rows)} - CALLED!")
-    peers = list()
-    for key in ["linked", "allowed", "blocked"]:
-        # DEBUG: print(f"DEBUG: Checking key='{key}'")
-        if key in rows and rows[key] is not None:
-            # DEBUG: print(f"DEBUG: Adding {len(rows[key])} peer(s) to peers list ...")
-            for peer in rows[key]:
-                # DEBUG: print(f"DEBUG: peer='{peer}' - BEFORE!")
-                peer = tidyup_domain(peer)
-
-                # DEBUG: print(f"DEBUG: peer='{peer}' - AFTER!")
-                if blacklist.is_blacklisted(peer):
-                    # DEBUG: print(f"DEBUG: peer='{peer}' is blacklisted, skipped!")
-                    continue
-
-                # DEBUG: print(f"DEBUG: Adding peer='{peer}' ...")
-                peers.append(peer)
-
-    # DEBUG: print(f"DEBUG: peers()={len(peers)} - EXIT!")
-    return peers
-
-def remove_version(software: str) -> str:
-    # DEBUG: print(f"DEBUG: software='{software}' - CALLED!")
-    if not "." in software and " " not in software:
-        print(f"WARNING: software='{software}' does not contain a version number.")
-        return software
-
-    temp = software
-    if ";" in software:
-        temp = software.split(";")[0]
-    elif "," in software:
-        temp = software.split(",")[0]
-    elif " - " in software:
-        temp = software.split(" - ")[0]
-
-    # DEBUG: print(f"DEBUG: software='{software}'")
-    version = None
-    if " " in software:
-        version = temp.split(" ")[-1]
-    elif "/" in software:
-        version = temp.split("/")[-1]
-    elif "-" in software:
-        version = temp.split("-")[-1]
-    else:
-        # DEBUG: print(f"DEBUG: Was not able to find common seperator, returning untouched software='{software}'")
-        return software
-
-    match = None
-    # DEBUG: print(f"DEBUG: Checking {len(patterns)} patterns ...")
-    for pattern in patterns:
-        # Run match()
-        match = pattern.match(version)
-
-        # DEBUG: print(f"DEBUG: match[]={type(match)}")
-        if isinstance(match, re.Match):
-            # DEBUG: print(f"DEBUG: version='{version}' is matching pattern='{pattern}'")
-            break
-
-    # DEBUG: print(f"DEBUG: version[{type(version)}]='{version}',match='{match}'")
-    if not isinstance(match, re.Match):
-        print(f"WARNING: version='{version}' does not match regex, leaving software='{software}' untouched.")
-        return software
-
-    # DEBUG: print(f"DEBUG: Found valid version number: '{version}', removing it ...")
-    end = len(temp) - len(version) - 1
-
-    # DEBUG: print(f"DEBUG: end[{type(end)}]={end}")
-    software = temp[0:end].strip()
-    if " version" in software:
-        # DEBUG: print(f"DEBUG: software='{software}' contains word ' version'")
-        software = strip_until(software, " version")
-
-    # DEBUG: print(f"DEBUG: software='{software}' - EXIT!")
-    return software
-
-def strip_powered_by(software: str) -> str:
-    # DEBUG: print(f"DEBUG: software='{software}' - CALLED!")
-    if not isinstance(software, str):
-        raise ValueError(f"Parameter software[]='{type(software)}' is not 'str'")
-    elif software == "":
-        raise ValueError("Parameter 'software' is empty")
-    elif not "powered by" in software:
-        print(f"WARNING: Cannot find 'powered by' in software='{software}'!")
-        return software
-
-    start = software.find("powered by ")
-    # DEBUG: print(f"DEBUG: start[{type(start)}]='{start}'")
-
-    software = software[start + 11:].strip()
-    # DEBUG: print(f"DEBUG: software='{software}'")
-
-    software = strip_until(software, " - ")
-
-    # DEBUG: print(f"DEBUG: software='{software}' - EXIT!")
-    return software
-
-def strip_hosted_on(software: str) -> str:
-    # DEBUG: print(f"DEBUG: software='{software}' - CALLED!")
-    if not isinstance(software, str):
-        raise ValueError(f"Parameter software[]='{type(software)}' is not 'str'")
-    elif software == "":
-        raise ValueError("Parameter 'software' is empty")
-    elif not "hosted on" in software:
-        print(f"WARNING: Cannot find 'hosted on' in '{software}'!")
-        return software
-
-    end = software.find("hosted on ")
-    # DEBUG: print(f"DEBUG: end[{type(end)}]='{end}'")
-
-    software = software[0, end].strip()
-    # DEBUG: print(f"DEBUG: software='{software}'")
-
-    software = strip_until(software, " - ")
-
-    # DEBUG: print(f"DEBUG: software='{software}' - EXIT!")
-    return software
-
-def strip_until(software: str, until: str) -> str:
-    # DEBUG: print(f"DEBUG: software='{software}',until='{until}' - CALLED!")
-    if not isinstance(software, str):
-        raise ValueError(f"Parameter software[]='{type(software)}' is not 'str'")
-    elif software == "":
-        raise ValueError("Parameter 'software' is empty")
-    elif not isinstance(until, str):
-        raise ValueError(f"Parameter until[]='{type(until)}' is not 'str'")
-    elif until == "":
-        raise ValueError("Parameter 'until' is empty")
-    elif not until in software:
-        print(f"WARNING: Cannot find '{until}' in '{software}'!")
-        return software
-
-    # Next, strip until part
-    end = software.find(until)
-
-    # DEBUG: print(f"DEBUG: end[{type(end)}]='{end}'")
-    if end > 0:
-        software = software[0:end].strip()
-
-    # DEBUG: print(f"DEBUG: software='{software}' - EXIT!")
-    return software
-
-def remove_pending_error(domain: str):
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-
-    try:
-        # Prevent updating any pending errors, nodeinfo was found
-        del pending_errors[domain]
-
-    except:
-        pass
-
-    # DEBUG: print("DEBUG: EXIT!")
-
 def get_hash(domain: str) -> str:
     if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
+        raise ValueError(f"Parameter domain[]='{type(domain)}' is not 'str'")
     elif domain == "":
         raise ValueError("Parameter 'domain' is empty")
 
     return hashlib.sha256(domain.encode("utf-8")).hexdigest()
 
-def log_error(domain: str, response: requests.models.Response):
-    # DEBUG: print("DEBUG: domain,response[]:", domain, type(response))
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-
-    try:
-        # DEBUG: print("DEBUG: BEFORE response[]:", type(response))
-        if isinstance(response, BaseException) or isinstance(response, json.decoder.JSONDecodeError):
-            response = str(response)
-
-        # DEBUG: print("DEBUG: AFTER response[]:", type(response))
-        if isinstance(response, str):
-            cursor.execute("INSERT INTO error_log (domain, error_code, error_message, created) VALUES (?, 999, ?, ?)",[
-                domain,
-                response,
-                time.time()
-            ])
-        else:
-            cursor.execute("INSERT INTO error_log (domain, error_code, error_message, created) VALUES (?, ?, ?, ?)",[
-                domain,
-                response.status_code,
-                response.reason,
-                time.time()
-            ])
-
-        # Cleanup old entries
-        # DEBUG: print(f"DEBUG: Purging old records (distance: {config.get('error_log_cleanup')})")
-        cursor.execute("DELETE FROM error_log WHERE created < ?", [time.time() - config.get("error_log_cleanup")])
-    except BaseException as exception:
-        print(f"ERROR: failed SQL query: domain='{domain}',exception[{type(exception)}]:'{str(exception)}'")
-        sys.exit(255)
-
-    # DEBUG: print("DEBUG: EXIT!")
-
-def fetch_peers(domain: str, software: str) -> list:
-    # DEBUG: print(f"DEBUG: domain({len(domain)})={domain},software={software} - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-    elif not isinstance(software, str) and software is not None:
-        raise ValueError(f"software[]={type(software)} is not 'str'")
-
-    if software == "misskey":
-        # DEBUG: print(f"DEBUG: Invoking misskey.fetch_peers({domain}) ...")
-        return misskey.fetch_peers(domain)
-    elif software == "lemmy":
-        # DEBUG: print(f"DEBUG: Invoking lemmy.fetch_peers({domain}) ...")
-        return lemmy.fetch_peers(domain)
-    elif software == "peertube":
-        # DEBUG: print(f"DEBUG: Invoking peertube.fetch_peers({domain}) ...")
-        return peertube.fetch_peers(domain)
-
-    # DEBUG: print(f"DEBUG: Fetching peers from '{domain}',software='{software}' ...")
-    peers = list()
-    try:
-        response = network.fetch_response(domain, "/api/v1/instance/peers", network.api_headers, (config.get("connection_timeout"), config.get("read_timeout")))
-
-        data = json_from_response(response)
-
-        # DEBUG: print(f"DEBUG: response.ok={response.ok},response.status_code={response.status_code},data[]='{type(data)}'")
-        if not response.ok or response.status_code >= 400:
-            # DEBUG: print(f"DEBUG: Was not able to fetch peers, trying alternative ...")
-            response = network.fetch_response(domain, "/api/v3/site", network.api_headers, (config.get("connection_timeout"), config.get("read_timeout")))
-
-            data = json_from_response(response)
-            # DEBUG: print(f"DEBUG: response.ok={response.ok},response.status_code={response.status_code},data[]='{type(data)}'")
-            if not response.ok or response.status_code >= 400:
-                print("WARNING: Could not reach any JSON API:", domain)
-                instances.update_last_error(domain, response)
-            elif response.ok and isinstance(data, list):
-                # DEBUG: print(f"DEBUG: domain='{domain}' returned a list: '{data}'")
-                sys.exit(255)
-            elif "federated_instances" in data:
-                # DEBUG: print(f"DEBUG: Found federated_instances for domain='{domain}'")
-                peers = peers + add_peers(data["federated_instances"])
-                # DEBUG: print("DEBUG: Added instance(s) to peers")
-            else:
-                print("WARNING: JSON response does not contain 'federated_instances':", domain)
-                instances.update_last_error(domain, response)
-        else:
-            # DEBUG: print("DEBUG: Querying API was successful:", domain, len(data))
-            peers = data
-
-    except BaseException as exception:
-        print("WARNING: Some error during get():", domain, exception)
-        instances.update_last_error(domain, exception)
-
-    # DEBUG: print(f"DEBUG: Adding '{len(peers)}' for domain='{domain}'")
-    instances.set("total_peers", domain, len(peers))
-
-    # DEBUG: print(f"DEBUG: Updating last_instance_fetch for domain='{domain}' ...")
-    instances.update_last_instance_fetch(domain)
-
-    # DEBUG: print("DEBUG: Returning peers[]:", type(peers))
-    return peers
-
-def fetch_nodeinfo(domain: str, path: str = None) -> list:
-    # DEBUG: print(f"DEBUG: domain='{domain}',path={path} - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-    elif not isinstance(path, str) and path is not None:
-        raise ValueError(f"Parameter path[]={type(path)} is not 'str'")
-
-    # DEBUG: print(f"DEBUG: Fetching nodeinfo from domain='{domain}' ...")
-    nodeinfo = fetch_wellknown_nodeinfo(domain)
-
-    # DEBUG: print(f"DEBUG: nodeinfo({len(nodeinfo)})={nodeinfo}")
-    if len(nodeinfo) > 0:
-        # DEBUG: print("DEBUG: nodeinfo()={len(nodeinfo))} - EXIT!")
-        return nodeinfo
-
-    request_paths = [
-       "/nodeinfo/2.1.json",
-       "/nodeinfo/2.1",
-       "/nodeinfo/2.0.json",
-       "/nodeinfo/2.0",
-       "/nodeinfo/1.0",
-       "/api/v1/instance"
-    ]
-
-    data = {}
-    for request in request_paths:
-        if path is not None and path != "" and path != f"https://{domain}{path}":
-            # DEBUG: print(f"DEBUG: path='{path}' does not match request='{request}' - SKIPPED!")
-            continue
-
-        try:
-            # DEBUG: print(f"DEBUG: Fetching request='{request}' from domain='{domain}' ...")
-            response = network.fetch_response(domain, request, network.api_headers, (config.get("nodeinfo_connection_timeout"), config.get("nodeinfo_read_timeout")))
-
-            data = json_from_response(response)
-            # DEBUG: print(f"DEBUG: response.ok={response.ok},response.status_code={response.status_code},data[]='{type(data)}'")
-            if response.ok and isinstance(data, dict):
-                # DEBUG: print("DEBUG: Success:", request)
-                instances.set("detection_mode", domain, "STATIC_CHECK")
-                instances.set("nodeinfo_url"  , domain, request)
-                break
-            elif response.ok and isinstance(data, list):
-                print(f"UNSUPPORTED: domain='{domain}' returned a list: '{data}'")
-                sys.exit(255)
-            elif not response.ok or response.status_code >= 400:
-                print("WARNING: Failed fetching nodeinfo from domain:", domain)
-                instances.update_last_error(domain, response)
-                continue
-
-        except BaseException as exception:
-            # DEBUG: print("DEBUG: Cannot fetch API request:", request)
-            instances.update_last_error(domain, exception)
-            pass
-
-    # DEBUG: print(f"DEBUG: data()={len(data)} - EXIT!")
-    return data
-
-def fetch_wellknown_nodeinfo(domain: str) -> list:
-    # DEBUG: print(f"DEBUG: domain='{domain}' - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-
-    # DEBUG: print("DEBUG: Fetching .well-known info for domain:", domain)
-    data = {}
-
-    try:
-        response = network.fetch_response(domain, "/.well-known/nodeinfo", network.api_headers, (config.get("nodeinfo_connection_timeout"), config.get("nodeinfo_read_timeout")))
-
-        data = json_from_response(response)
-        # DEBUG: print("DEBUG: domain,response.ok,data[]:", domain, response.ok, type(data))
-        if response.ok and isinstance(data, dict):
-            nodeinfo = data
-            # DEBUG: print("DEBUG: Found entries:", len(nodeinfo), domain)
-            if "links" in nodeinfo:
-                # DEBUG: print("DEBUG: Found links in nodeinfo():", len(nodeinfo["links"]))
-                for link in nodeinfo["links"]:
-                    # DEBUG: print("DEBUG: rel,href:", link["rel"], link["href"])
-                    if link["rel"] in nodeinfo_identifier:
-                        # DEBUG: print("DEBUG: Fetching nodeinfo from:", link["href"])
-                        response = fetch_url(link["href"], network.api_headers, (config.get("connection_timeout"), config.get("read_timeout")))
-
-                        data = json_from_response(response)
-                        # DEBUG: print("DEBUG: href,response.ok,response.status_code:", link["href"], response.ok, response.status_code)
-                        if response.ok and isinstance(data, dict):
-                            # DEBUG: print("DEBUG: Found JSON nodeinfo():", len(data))
-                            instances.set("detection_mode", domain, "AUTO_DISCOVERY")
-                            instances.set("nodeinfo_url"  , domain, link["href"])
-                            break
-                    else:
-                        print("WARNING: Unknown 'rel' value:", domain, link["rel"])
-            else:
-                print("WARNING: nodeinfo does not contain 'links':", domain)
-
-    except BaseException as exception:
-        print("WARNING: Failed fetching .well-known info:", domain)
-        instances.update_last_error(domain, exception)
-        pass
-
-    # DEBUG: print("DEBUG: Returning data[]:", type(data))
-    return data
-
-def fetch_generator_from_path(domain: str, path: str = "/") -> str:
-    # DEBUG: print(f"DEBUG: domain({len(domain)})={domain},path={path} - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-    elif not isinstance(path, str):
-        raise ValueError(f"path[]={type(path)} is not 'str'")
-    elif path == "":
-        raise ValueError("Parameter 'path' is empty")
-
-    # DEBUG: print(f"DEBUG: domain='{domain}',path='{path}' - CALLED!")
-    software = None
-
-    try:
-        # DEBUG: print(f"DEBUG: Fetching path='{path}' from '{domain}' ...")
-        response = network.fetch_response(domain, path, network.web_headers, (config.get("connection_timeout"), config.get("read_timeout")))
-
-        # DEBUG: print("DEBUG: domain,response.ok,response.status_code,response.text[]:", domain, response.ok, response.status_code, type(response.text))
-        if response.ok and response.status_code < 300 and len(response.text) > 0:
-            # DEBUG: print("DEBUG: Search for <meta name='generator'>:", domain)
-            doc = bs4.BeautifulSoup(response.text, "html.parser")
-
-            # DEBUG: print("DEBUG: doc[]:", type(doc))
-            generator = doc.find("meta", {"name": "generator"})
-            site_name = doc.find("meta", {"property": "og:site_name"})
-
-            # DEBUG: print(f"DEBUG: generator='{generator}',site_name='{site_name}'")
-            if isinstance(generator, bs4.element.Tag):
-                # DEBUG: print("DEBUG: Found generator meta tag:", domain)
-                software = tidyup_domain(generator.get("content"))
-                print(f"INFO: domain='{domain}' is generated by '{software}'")
-                instances.set("detection_mode", domain, "GENERATOR")
-                remove_pending_error(domain)
-            elif isinstance(site_name, bs4.element.Tag):
-                # DEBUG: print("DEBUG: Found property=og:site_name:", domain)
-                sofware = tidyup_domain(site_name.get("content"))
-                print(f"INFO: domain='{domain}' has og:site_name='{software}'")
-                instances.set("detection_mode", domain, "SITE_NAME")
-                remove_pending_error(domain)
-
-    except BaseException as exception:
-        # DEBUG: print(f"DEBUG: Cannot fetch / from '{domain}':", exception)
-        instances.update_last_error(domain, exception)
-        pass
-
-    # DEBUG: print(f"DEBUG: software[]={type(software)}")
-    if isinstance(software, str) and software == "":
-        # DEBUG: print(f"DEBUG: Corrected empty string to None for software of domain='{domain}'")
-        software = None
-    elif isinstance(software, str) and ("." in software or " " in software):
-        # DEBUG: print(f"DEBUG: software='{software}' may contain a version number, domain='{domain}', removing it ...")
-        software = remove_version(software)
-
-    # DEBUG: print(f"DEBUG: software[]={type(software)}")
-    if isinstance(software, str) and " powered by " in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has 'powered by' in it")
-        software = remove_version(strip_powered_by(software))
-    elif isinstance(software, str) and " hosted on " in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has 'hosted on' in it")
-        software = remove_version(strip_hosted_on(software))
-    elif isinstance(software, str) and " by " in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has ' by ' in it")
-        software = strip_until(software, " by ")
-    elif isinstance(software, str) and " see " in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has ' see ' in it")
-        software = strip_until(software, " see ")
-
-    # DEBUG: print(f"DEBUG: software='{software}' - EXIT!")
-    return software
-
-def determine_software(domain: str, path: str = None) -> str:
-    # DEBUG: print(f"DEBUG: domain({len(domain)})={domain},path={path} - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-    elif domain == "":
-        raise ValueError("Parameter 'domain' is empty")
-    elif not isinstance(path, str) and path is not None:
-        raise ValueError(f"Parameter path[]={type(path)} is not 'str'")
-
-    # DEBUG: print("DEBUG: Determining software for domain,path:", domain, path)
-    software = None
-
-    # DEBUG: print(f"DEBUG: Fetching nodeinfo from '{domain}' ...")
-    data = fetch_nodeinfo(domain, path)
-
-    # DEBUG: print("DEBUG: data[]:", type(data))
-    if not isinstance(data, dict) or len(data) == 0:
-        # DEBUG: print("DEBUG: Could not determine software type:", domain)
-        return fetch_generator_from_path(domain)
-
-    # DEBUG: print("DEBUG: data():", len(data), data)
-    if "status" in data and data["status"] == "error" and "message" in data:
-        print("WARNING: JSON response is an error:", data["message"])
-        instances.update_last_error(domain, data["message"])
-        return fetch_generator_from_path(domain)
-    elif "message" in data:
-        print("WARNING: JSON response contains only a message:", data["message"])
-        instances.update_last_error(domain, data["message"])
-        return fetch_generator_from_path(domain)
-    elif "software" not in data or "name" not in data["software"]:
-        # DEBUG: print(f"DEBUG: JSON response from domain='{domain}' does not include [software][name], fetching / ...")
-        software = fetch_generator_from_path(domain)
-
-        # DEBUG: print(f"DEBUG: Generator for domain='{domain}' is: {software}, EXIT!")
-        return software
-
-    software = tidyup_domain(data["software"]["name"])
-
-    # DEBUG: print("DEBUG: sofware after tidyup_domain():", software)
-    if software in ["akkoma", "rebased"]:
-        # DEBUG: print("DEBUG: Setting pleroma:", domain, software)
-        software = "pleroma"
-    elif software in ["hometown", "ecko"]:
-        # DEBUG: print("DEBUG: Setting mastodon:", domain, software)
-        software = "mastodon"
-    elif software in ["calckey", "groundpolis", "foundkey", "cherrypick", "meisskey"]:
-        # DEBUG: print("DEBUG: Setting misskey:", domain, software)
-        software = "misskey"
-    elif software.find("/") > 0:
-        print("WARNING: Spliting of slash:", software)
-        software = tidyup_domain(software.split("/")[-1]);
-    elif software.find("|") > 0:
-        print("WARNING: Spliting of pipe:", software)
-        software = tidyup_domain(software.split("|")[0]);
-    elif "powered by" in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has 'powered by' in it")
-        software = strip_powered_by(software)
-    elif isinstance(software, str) and " by " in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has ' by ' in it")
-        software = strip_until(software, " by ")
-    elif isinstance(software, str) and " see " in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has ' see ' in it")
-        software = strip_until(software, " see ")
-
-    # DEBUG: print(f"DEBUG: software[]={type(software)}")
-    if software == "":
-        print("WARNING: tidyup_domain() left no software name behind:", domain)
-        software = None
-
-    # DEBUG: print(f"DEBUG: software[]={type(software)}")
-    if str(software) == "":
-        # DEBUG: print(f"DEBUG: software for '{domain}' was not detected, trying generator ...")
-        software = fetch_generator_from_path(domain)
-    elif len(str(software)) > 0 and ("." in software or " " in software):
-        # DEBUG: print(f"DEBUG: software='{software}' may contain a version number, domain='{domain}', removing it ...")
-        software = remove_version(software)
-
-    # DEBUG: print(f"DEBUG: software[]={type(software)}")
-    if isinstance(software, str) and "powered by" in software:
-        # DEBUG: print(f"DEBUG: software='{software}' has 'powered by' in it")
-        software = remove_version(strip_powered_by(software))
-
-    # DEBUG: print("DEBUG: Returning domain,software:", domain, software)
-    return software
-
-def tidyup_reason(reason: str) -> str:
-    # DEBUG: print(f"DEBUG: reason='{reason}' - CALLED!")
-    if not isinstance(reason, str):
-        raise ValueError(f"Parameter reason[]={type(reason)} is not 'str'")
-
-    # Strip string
-    reason = reason.strip()
-
-    # Replace â with "
-    reason = re.sub("â", "\"", reason)
-
-    # DEBUG: print(f"DEBUG: reason='{reason}' - EXIT!")
-    return reason
-
-def tidyup_domain(domain: str) -> str:
-    # DEBUG: print(f"DEBUG: domain='{domain}' - CALLED!")
-    if not isinstance(domain, str):
-        raise ValueError(f"Parameter domain[]={type(domain)} is not 'str'")
-
-    # All lower-case and strip spaces out + last dot
-    domain = domain.lower().strip().rstrip(".")
-
-    # No port number
-    domain = re.sub("\:\d+$", "", domain)
-
-    # No protocol, sometimes without the slashes
-    domain = re.sub("^https?\:(\/*)", "", domain)
-
-    # No trailing slash
-    domain = re.sub("\/$", "", domain)
-
-    # No @ sign
-    domain = re.sub("^\@", "", domain)
-
-    # No individual users in block lists
-    domain = re.sub("(.+)\@", "", domain)
-    if domain.find("/profile/"):
-        domain = domain.split("/profile/")[0]
-    elif domain.find("/users/"):
-        domain = domain.split("/users/")[0]
-
-    # DEBUG: print(f"DEBUG: domain='{domain}' - EXIT!")
-    return domain
-
-def json_from_response(response: requests.models.Response) -> list:
-    # DEBUG: print(f"DEBUG: response[]={type(response)} - CALLED!")
-    if not isinstance(response, requests.models.Response):
-        raise ValueError(f"Parameter response[]='{type(response)}' is not type of 'Response'")
-
-    data = list()
-    if response.text.strip() != "":
-        # DEBUG: print(f"DEBUG: response.text()={len(response.text)} is not empty, invoking response.json() ...")
-        try:
-            data = response.json()
-        except json.decoder.JSONDecodeError:
-            pass
-
-    # DEBUG: print(f"DEBUG: data[]={type(data)} - EXIT!")
-    return data
-
-def has_key(lists: list, key: str, value: any) -> bool:
-    # DEBUG: print(f"DEBUG: lists()={len(lists)},key='{key}',value[]='{type(value)}' - CALLED!")
-    if not isinstance(lists, list):
-        raise ValueError(f"Parameter lists[]='{type(lists)}' is not 'list'")
-    elif not isinstance(key, str):
-        raise ValueError(f"Parameter key[]='{type(key)}' is not 'str'")
-    elif key == "":
-        raise ValueError("Parameter 'key' is empty")
-
-    has = False
-    # DEBUG: print(f"DEBUG: Checking lists()={len(lists)} ...")
-    for row in lists:
-        # DEBUG: print(f"DEBUG: row['{type(row)}']={row}")
-        if not isinstance(row, dict):
-            raise ValueError(f"row[]='{type(row)}' is not 'dict'")
-        elif not key in row:
-            raise KeyError(f"Cannot find key='{key}'")
-        elif row[key] == value:
-            has = True
-            break
-
-    # DEBUG: print(f"DEBUG: has={has} - EXIT!")
-    return has
-
-def find_domains(tag: bs4.element.Tag) -> list:
-    # DEBUG: print(f"DEBUG: tag[]={type(tag)} - CALLED!")
-    if not isinstance(tag, bs4.element.Tag):
-        raise ValueError(f"Parameter tag[]={type(tag)} is not type of bs4.element.Tag")
-    elif len(tag.select("tr")) == 0:
-        raise KeyError("No table rows found in table!")
-
-    domains = list()
-    for element in tag.select("tr"):
-        # DEBUG: print(f"DEBUG: element[]={type(element)}")
-        if not element.find("td"):
-            # DEBUG: print("DEBUG: Skipping element, no <td> found")
-            continue
-
-        domain = tidyup_domain(element.find("td").text)
-        reason = tidyup_reason(element.findAll("td")[1].text)
-
-        # DEBUG: print(f"DEBUG: domain='{domain}',reason='{reason}'")
-
-        if blacklist.is_blacklisted(domain):
-            print(f"WARNING: domain='{domain}' is blacklisted - skipped!")
-            continue
-        elif domain == "gab.com/.ai, develop.gab.com":
-            # DEBUG: print(f"DEBUG: Multiple domains detected in one row")
-            domains.append({
-                "domain": "gab.com",
-                "reason": reason,
-            })
-            domains.append({
-                "domain": "gab.ai",
-                "reason": reason,
-            })
-            domains.append({
-                "domain": "develop.gab.com",
-                "reason": reason,
-            })
-            continue
-        elif not validators.domain(domain):
-            print(f"WARNING: domain='{domain}' is not a valid domain - skipped!")
-            continue
-
-        # DEBUG: print(f"DEBUG: Adding domain='{domain}' ...")
-        domains.append({
-            "domain": domain,
-            "reason": reason,
-        })
-
-    # DEBUG: print(f"DEBUG: domains()={len(domains)} - EXIT!")
-    return domains
-
 def fetch_url(url: str, headers: dict, timeout: tuple) -> requests.models.Response:
     # DEBUG: print(f"DEBUG: url='{url}',headers()={len(headers)},timeout={timeout} - CALLED!")
     if not isinstance(url, str):
@@ -813,9 +62,72 @@ def fetch_url(url: str, headers: dict, timeout: tuple) -> requests.models.Respon
     # Invoke other function, avoid trailing ?
     # DEBUG: print(f"DEBUG: components[{type(components)}]={components}")
     if components.query != "":
-        response = network.fetch_response(components.hostname, f"{components.path}?{components.query}", headers, timeout)
+        response = network.fetch_response(components.netloc, f"{components.path}?{components.query}", headers, timeout)
     else:
-        response = network.fetch_response(components.hostname, f"{components.path}", headers, timeout)
+        response = network.fetch_response(components.netloc, f"{components.path}", headers, timeout)
 
     # DEBUG: print(f"DEBUG: response[]='{type(response)}' - EXXIT!")
     return response
+
+def process_domain(domain: str, blocker: str, command: str) -> bool:
+    # DEBUG: print(f"DEBUG: domain='{domain}',blocker='{blocker}',command='{command}' - CALLED!")
+    if not isinstance(domain, str):
+        raise ValueError(f"Parameter domain[]='{type(domain)}' is not 'str'")
+    elif domain == "":
+        raise ValueError("Parameter 'domain' is empty")
+    elif not isinstance(blocker, str):
+        raise ValueError(f"Parameter blocker[]='{type(blocker)}' is not 'str'")
+    elif blocker == "":
+        raise ValueError("Parameter 'blocker' is empty")
+    elif not isinstance(command, str):
+        raise ValueError(f"Parameter command[]='{type(command)}' is not 'str'")
+    elif command == "":
+        raise ValueError("Parameter 'command' is empty")
+
+    if domain.find("*") > 0:
+        # Try to de-obscure it
+        row = instances.deobscure("*", domain)
+
+        # DEBUG: print(f"DEBUG: row[{type(row)}]='{row}'")
+        if row is None:
+            print(f"WARNING: Cannot de-obfucate domain='{domain}' - SKIPPED!")
+            return False
+
+        # DEBUG: print(f"DEBUG: domain='{domain}' de-obscured to '{row[0]}'")
+        domain = row[0]
+    elif domain.find("?") > 0:
+        # Try to de-obscure it
+        row = instances.deobscure("?", domain)
+
+        # DEBUG: print(f"DEBUG: row[{type(row)}]='{row}'")
+        if row is None:
+            print(f"WARNING: Cannot de-obfucate domain='{domain}' - SKIPPED!")
+            return False
+
+        # DEBUG: print(f"DEBUG: domain='{domain}' de-obscured to '{row[0]}'")
+        domain = row[0]
+
+    if not validators.domain(domain):
+        print(f"WARNING: domain='{domain}' is not a valid domain - SKIPPED!")
+        return False
+    elif domain.endswith(".arpa"):
+        print(f"WARNING: domain='{domain}' is a reversed .arpa domain and should not be used generally.")
+        return False
+    elif blacklist.is_blacklisted(domain):
+        # DEBUG: print(f"DEBUG: domain='{domain}' is blacklisted - SKIPPED!")
+        return False
+    elif instances.is_recent(domain):
+        # DEBUG: print(f"DEBUG: domain='{domain}' has been recently checked - SKIPPED!")
+        return False
+
+    processed = False
+    try:
+        print(f"INFO: Fetching instances for instane='{domain}',blocker='{blocker}',command='{command}' ...")
+        federation.fetch_instances(domain, blocker, None, command)
+        processed = True
+    except network.exceptions as exception:
+        print(f"WARNING: Exception '{type(exception)}' during fetching instances (fetch_oliphant) from domain='{domain}'")
+        instances.set_last_error(domain, exception)
+
+    # DEBUG: print(f"DEBUG: processed='{processed}' - EXIT!")
+    return processed