dropcatch 0.1.0__tar.gz

dropcatch-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: dropcatch
+Version: 0.1.0
+Summary: NASK (.pl) domain lifecycle tracker and raw WHOIS parser for drop-catching automation.
+Author-email: Rylse Solutions <hello@rylse.com>
+License-Expression: MIT
+Keywords: dropcatch,nask,dns.pl,whois,domain-sniping,pl-domains,seo
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# 🎯 dropcatch (alpha) for (NASK / .pl Edition)
+
+A specialized, zero-dependency Python utility for monitoring the lifecycle of Polish `.pl` domains directly via the NASK WHOIS registry (`whois.dns.pl`). 
+
+Built for drop-catchers, SEO professionals, and domain investors who need raw socket connections without third-party API limits.
+
+## ⚡ Installation
+
+```bash
+pip install dropcatch
+```
+
+## 🚀 Usage
+dropcatch connects directly to port 43 of the Polish registry, parses the proprietary text format, and computes exact drop windows.
+
+```bash
+import dropcatch
+
+# Query a .pl domain directly from NASK registry
+domain = dropcatch.query_nask("nask.pl")
+
+print(f"Domain: {domain.name}")
+print(f"Status: {domain.status}")
+print(f"Expiration Date: {domain.expiration_date}")
+
+# Check if it's currently in the 30-day blind period before deletion
+if domain.is_blocked:
+    print(f"Domain is BLOCKED. Will drop around: {domain.estimated_drop_date}")
+```
+
+## Additional domain registries
+Support for additional domain registries will be added over time. If you'd like to support the development of this dropcatch library, feel free to reach out to us via email.
+
+## ⚠️ Disclaimer
+This package is provided for informational and monitoring purposes only. Excessive querying may result in your IP being temporarily blocked by the NASK registry rate limiters. Use responsibly and do not hammer the WHOIS servers.

dropcatch-0.1.0/README.md

@@ -0,0 +1,35 @@
+# 🎯 dropcatch (alpha) for (NASK / .pl Edition)
+
+A specialized, zero-dependency Python utility for monitoring the lifecycle of Polish `.pl` domains directly via the NASK WHOIS registry (`whois.dns.pl`). 
+
+Built for drop-catchers, SEO professionals, and domain investors who need raw socket connections without third-party API limits.
+
+## ⚡ Installation
+
+```bash
+pip install dropcatch
+```
+
+## 🚀 Usage
+dropcatch connects directly to port 43 of the Polish registry, parses the proprietary text format, and computes exact drop windows.
+
+```bash
+import dropcatch
+
+# Query a .pl domain directly from NASK registry
+domain = dropcatch.query_nask("nask.pl")
+
+print(f"Domain: {domain.name}")
+print(f"Status: {domain.status}")
+print(f"Expiration Date: {domain.expiration_date}")
+
+# Check if it's currently in the 30-day blind period before deletion
+if domain.is_blocked:
+    print(f"Domain is BLOCKED. Will drop around: {domain.estimated_drop_date}")
+```
+
+## Additional domain registries
+Support for additional domain registries will be added over time. If you'd like to support the development of this dropcatch library, feel free to reach out to us via email.
+
+## ⚠️ Disclaimer
+This package is provided for informational and monitoring purposes only. Excessive querying may result in your IP being temporarily blocked by the NASK registry rate limiters. Use responsibly and do not hammer the WHOIS servers.

dropcatch-0.1.0/dropcatch/__init__.py

@@ -0,0 +1,4 @@
+from .nask import PLDomain, query_nask, LEGAL_DISCLAIMER
+
+__version__ = "0.2.0"
+__all__ = ["PLDomain", "query_nask", "LEGAL_DISCLAIMER"]

dropcatch-0.1.0/dropcatch/nask.py

@@ -0,0 +1,89 @@
+import socket
+import re
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+from typing import Optional, Dict, Any
+
+NASK_WHOIS_SERVER = "whois.dns.pl"
+NASK_WHOIS_PORT = 43
+TIMEOUT_SECONDS = 5.0
+
+LEGAL_DISCLAIMER = "Informational utility. Subject to NASK registry rate limits."
+
+@dataclass
+class PLDomain:
+    name: str
+    status: str
+    expiration_date: Optional[datetime] = None
+    created_date: Optional[datetime] = None
+    raw_response: str = ""
+
+    @property
+    def is_blocked(self) -> bool:
+        """NASK sets status to BLOCKED for ~30 days after expiration."""
+        return "BLOCKED" in self.status.upper() or "TERMINATED" in self.status.upper()
+
+    @property
+    def estimated_drop_date(self) -> Optional[datetime]:
+        """
+        If a .pl domain is BLOCKED, it usually drops 30 days after expiration.
+        Note: Exact hour of deletion varies.
+        """
+        if self.expiration_date and self.is_blocked:
+            return self.expiration_date + timedelta(days=30)
+        return None
+
+    def summary(self) -> Dict[str, Any]:
+        return {
+            "domain": self.name,
+            "status": self.status,
+            "is_blocked": self.is_blocked,
+            "expiration_date": self.expiration_date.isoformat() if self.expiration_date else None,
+            "estimated_drop_date": self.estimated_drop_date.isoformat() if self.estimated_drop_date else None,
+            "disclaimer": LEGAL_DISCLAIMER
+        }
+
+
+def query_nask(domain: str) -> PLDomain:
+    """
+    Connects directly to whois.dns.pl over TCP Port 43 and parses the .pl domain status.
+    """
+    if not domain.lower().endswith(".pl"):
+        raise ValueError("dropcatch currently only supports .pl domains (NASK registry).")
+
+    # 1. Connect directly to WHOIS server
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.settimeout(TIMEOUT_SECONDS)
+        s.connect((NASK_WHOIS_SERVER, NASK_WHOIS_PORT))
+        s.send(f"{domain}\r\n".encode("utf-8"))
+        
+        response = b""
+        while True:
+            data = s.recv(4096)
+            if not data:
+                break
+            response += data
+            
+    raw_text = response.decode("utf-8", errors="replace")
+
+    # 2. Parse the proprietary NASK format using Regex
+    status_match = re.search(r"^\s*status:\s*(.+)$", raw_text, re.IGNORECASE | re.MULTILINE)
+    exp_match = re.search(r"^\s*option expiration date:\s*(.+)$", raw_text, re.IGNORECASE | re.MULTILINE)
+    
+    status = status_match.group(1).strip() if status_match else "UNKNOWN / NOT FOUND"
+    
+    expiration_date = None
+    if exp_match:
+        try:
+            # NASK format: 2026.09.29 12:00:00
+            date_str = exp_match.group(1).strip()
+            expiration_date = datetime.strptime(date_str, "%Y.%m.%d %H:%M:%S")
+        except ValueError:
+            pass
+
+    return PLDomain(
+        name=domain,
+        status=status,
+        expiration_date=expiration_date,
+        raw_response=raw_text
+    )

dropcatch-0.1.0/dropcatch.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: dropcatch
+Version: 0.1.0
+Summary: NASK (.pl) domain lifecycle tracker and raw WHOIS parser for drop-catching automation.
+Author-email: Rylse Solutions <hello@rylse.com>
+License-Expression: MIT
+Keywords: dropcatch,nask,dns.pl,whois,domain-sniping,pl-domains,seo
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# 🎯 dropcatch (alpha) for (NASK / .pl Edition)
+
+A specialized, zero-dependency Python utility for monitoring the lifecycle of Polish `.pl` domains directly via the NASK WHOIS registry (`whois.dns.pl`). 
+
+Built for drop-catchers, SEO professionals, and domain investors who need raw socket connections without third-party API limits.
+
+## ⚡ Installation
+
+```bash
+pip install dropcatch
+```
+
+## 🚀 Usage
+dropcatch connects directly to port 43 of the Polish registry, parses the proprietary text format, and computes exact drop windows.
+
+```bash
+import dropcatch
+
+# Query a .pl domain directly from NASK registry
+domain = dropcatch.query_nask("nask.pl")
+
+print(f"Domain: {domain.name}")
+print(f"Status: {domain.status}")
+print(f"Expiration Date: {domain.expiration_date}")
+
+# Check if it's currently in the 30-day blind period before deletion
+if domain.is_blocked:
+    print(f"Domain is BLOCKED. Will drop around: {domain.estimated_drop_date}")
+```
+
+## Additional domain registries
+Support for additional domain registries will be added over time. If you'd like to support the development of this dropcatch library, feel free to reach out to us via email.
+
+## ⚠️ Disclaimer
+This package is provided for informational and monitoring purposes only. Excessive querying may result in your IP being temporarily blocked by the NASK registry rate limiters. Use responsibly and do not hammer the WHOIS servers.

dropcatch-0.1.0/dropcatch.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+dropcatch/__init__.py
+dropcatch/nask.py
+dropcatch.egg-info/PKG-INFO
+dropcatch.egg-info/SOURCES.txt
+dropcatch.egg-info/dependency_links.txt
+dropcatch.egg-info/top_level.txt

dropcatch-0.1.0/dropcatch.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dropcatch-0.1.0/dropcatch.egg-info/top_level.txt

@@ -0,0 +1 @@
+dropcatch

dropcatch-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dropcatch"
+version = "0.1.0"
+description = "NASK (.pl) domain lifecycle tracker and raw WHOIS parser for drop-catching automation."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "Rylse Solutions", email = "hello@rylse.com" },
+]
+keywords = ["dropcatch", "nask", "dns.pl", "whois", "domain-sniping", "pl-domains", "seo"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["dropcatch*"]

dropcatch-0.1.0/setup.cfg

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