Metadata-Version: 2.4
Name: python-pler
Version: 0.1.1
Summary: Pler - Probe and Cloudflare Filter Tool
Author-email: Justakazh <akaswisnuaji@gmail.com>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests

# Pler - Domain Probe & Cloudflare Checker

**Pler** is a simple yet powerful Python script to check whether a domain is using Cloudflare.  
It is useful for **bug bounty hunters**, **pentesters**, or **OSINT** purposes, as it can filter results according to your needs.

---

## ✨ Features
- 🚀 **Multi-threading** → fast domain checks.
- 🌐 **IPv4 & IPv6 support**.
- 🎯 **Result filtering** → only IP, only domain, or domain + IP.
- ☁️ **Cloudflare detection** → quickly identify domains behind Cloudflare.
- ❓ **Unknown mode** → show domains that cannot be resolved.
- 📄 **Save output to file** for later use.

---

## 📦 Installation

Clone the repository and install dependencies:

```bash
git clone https://github.com/justakazh/pler.git
cd pler
pip install -r requirements.txt
```

Or install directly from **PyPI** (if published):

```bash
pip install pler
```

---

## ⚙️ Usage

```bash
python3 pler.py [options]
```

### Options
| Argument | Description |
|----------|-------------|
| `-d`, `--domain` `<domain>` | Target domain to check. |
| `-l`, `--list` `<file>` | File containing list of domains (one per line). |
| `-t`, `--threads` `<int>` | Number of threads (default: 3). |
| `-ft`, `--filter-type` `{ip,domain,domain_ip}` | Output filter type. |
| `-su`, `--show-unknown` | Show domains with unknown IP. |
| `-sc`, `--show-cloudflare` | Show domains that use Cloudflare. |
| `-o`, `--output` `<file>` | Save results to a file. |
| `-s`, `--silent` | Disable banner & non-essential output. |

---

## 🖥️ Examples

**Check a single domain**
```bash
python3 pler.py -d example.com
```

**Check from a file**
```bash
python3 pler.py -l subdomains.txt
```

**Check via STDIN**
```bash
echo "example.com" | python3 pler.py
cat subdomains.txt | python3 pler.py
```

**Show only IP addresses**
```bash
cat subdomains.txt | python3 pler.py -ft ip
```

**Show only domains**
```bash
cat subdomains.txt | python3 pler.py -ft domain
```

**Show only domains using Cloudflare**
```bash
cat subdomains.txt | python3 pler.py -sc
```

**Show only unknown IPs**
```bash
cat subdomains.txt | python3 pler.py -su
```

**Save results to file**
```bash
cat subdomains.txt | python3 pler.py -ft domain_ip -o result.txt
```

---

## 📜 License
This project is licensed under the [MIT License](LICENSE).
