RDTSearch 0.13.1__py3-none-any.whl

rdtsearch-0.13.1.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: RDTSearch
+Version: 0.13.1
+Summary: Official terminal client for RDTvlokip Search — an independent, privacy-first French search engine
+Author: RDTvlokip
+License-Expression: AGPL-3.0-or-later
+Project-URL: Homepage, https://rdtsearch.rdtvlokip.fr/
+Project-URL: Search engine, https://search.rdtvlokip.fr
+Project-URL: API, https://search.rdtvlokip.fr/api
+Project-URL: Repository, https://github.com/RDTvlokip/rdtsearch
+Project-URL: PyPI, https://pypi.org/project/rdtsearch/
+Keywords: search,seo,backlinks,cli,tui,search engine,privacy
+Classifier: Environment :: Console
+Classifier: Natural Language :: French
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# RDTSearch
+
+Official terminal client for **[RDTvlokip Search](https://search.rdtvlokip.fr)** — an independent, privacy-first French search engine (~4.6M indexed pages, in-house crawler).
+
+**Single file, zero dependencies** (Python 3.8+ stdlib only), bilingual **French / English**, Windows first, Linux/macOS supported.
+
+## Features
+
+- **Search** the index with highlighted snippets, featured snippets, tracker and adult-content flags
+- **Domain tools**: indexing status, submission tracking, continuous indexing **watch**
+- **Engine statistics**: pages/domains/URLs totals, daily and hourly crawl charts
+- **Backlink analysis (SEO)**: global link graph stats, top linked domains, per-domain backlinks (source, anchor, nofollow/sponsored/UGC), anchor-text distribution, evolution history, CSV/JSON export
+- **SEO duel** (`compare`): two domains side by side — indexed pages, inbound links, top anchor, winner
+- **Self-diagnostic** (`doctor`): terminal, configuration and server health in one command
+- **Local snapshot cache**: backlink analyses are kept per day to save the anonymous quota
+- **Autocomplete suggestions** and **server health** (latency, server time)
+- **Interactive TUI**: framed interface with live stats sidebar, Tab completion and command palette, fish-style ghost completion, input history, arrow-key menus, contextual footer, result detail sheets with score breakdown, open results in your browser
+- **Settings** (`/settings`): language, glyphs (UTF/ASCII), colors, adult-content filter, persistent history, API timeout — with a terminal diagnostic
+- **Scripting friendly**: `--json` on every command, piped mode, colors auto-disabled outside a TTY, HTTP 429 / `Retry-After` handled
+
+## Installation
+
+```
+pip install rdtsearch
+```
+
+or, isolated (recommended for CLI tools):
+
+```
+pipx install rdtsearch
+```
+
+Requires Python 3.8+. No third-party packages.
+
+## CLI usage
+
+```
+rdtsearch search "debian" [-p N]       search the index (page N)
+rdtsearch domain example.com           indexing status of a domain
+rdtsearch watch example.com [-i SEC]   watch indexing continuously (default 300s)
+rdtsearch compare a.com b.com          SEO duel between two domains
+rdtsearch stats [-d DAYS]              engine and crawler statistics (default: 7 days)
+rdtsearch suggest "linu"               autocomplete suggestions
+rdtsearch health                       server health and latency
+rdtsearch doctor                       client + server self-diagnostic
+rdtsearch status example.com           submission status of a domain
+
+rdtsearch backlinks stats              global link graph statistics
+rdtsearch backlinks top [-n N]         domains with the most backlinks
+rdtsearch backlinks detail example.com backlinks of a domain (source, anchor, flags)
+rdtsearch backlinks anchors example.com anchor-text distribution
+rdtsearch backlinks history example.com backlink evolution snapshots
+rdtsearch backlinks export example.com [--format csv|json] [-o FILE]
+```
+
+Global options:
+
+| Option | Effect |
+|---|---|
+| `--json` | raw JSON output (every command) |
+| `--lang auto\|fr\|en` | interface language (default: saved setting or OS language) |
+| `--timeout S` | API timeout in seconds, 1–120 (default: 15) |
+| `--no-color` | disable colors |
+| `--tui` | force the interactive interface |
+| `--version` | show version |
+
+`backlinks detail` and `/backlinks` reuse today's local snapshot to save the anonymous quota; add `--fresh` to query the API again.
+
+## Interactive TUI
+
+Run `rdtsearch` with no arguments in a terminal.
+
+- **Type anything** and press Enter to search
+- **Digits** open a result in your browser, `i <n>` shows a result detail sheet (score breakdown), `n` / `p` change page
+- **Slash commands**: `/backlinks` `/clear` `/compare` `/doctor` `/domain` `/health` `/help` `/refresh` `/settings` `/stats` `/status` `/suggest` `/watch` `/quit`
+- **`/watch <domain> [sec]`** runs a live indexing monitor (default 30s): the frame redraws with a timestamped change log — press any key to stop
+- **`/compare a.com b.com`** and **`/doctor`** are available in the TUI too, as full views
+- **Tab**: command completion, contextual menus (suggestions, results, periods, settings), and a full command palette on an empty line
+- **Ghost completion** (fish-style): the likely continuation appears in grey, accept it with `→` at the end of the line
+- **↑ ↓** input history, **Esc** clears the line, commands are colored green (valid) or red (unknown) as you type
+
+## Settings
+
+`/settings` (TUI) or the config file persists: interface **language**, **glyphs** (auto / UTF / ASCII), **colors** (auto / on / off), **adult-content** filter, **history** persistence (off by default), and **API timeout**. A diagnostic panel shows the detected terminal size, encoding, active glyphs/colors and OS language.
+
+Config lives in `%APPDATA%\rdtsearch\` (Windows) or `~/.config/rdtsearch/` (Unix).
+
+## Anonymous limits
+
+The backlinks API has a free anonymous tier (server-side): 10 backlinks per analysis, 3 analyses per day, export reserved for premium accounts. The client reports these limits clearly and caches each analysis locally so re-viewing it does not spend quota.
+
+## Terminal support
+
+- Full Unicode interface in modern terminals: Windows Terminal, VS Code, ConEmu/Cmder, and all Unix terminals
+- Automatic ASCII fallback in the legacy Windows console (cmd.exe / conhost); forceable via `/settings`
+- Piped or redirected output falls back to a plain, script-friendly mode
+
+## License
+
+[GNU AGPLv3](https://www.gnu.org/licenses/agpl-3.0.html) — free software; if you run a modified version as a network service, you must offer its source to users.
+
+## Links
+
+- Homepage: https://rdtsearch.rdtvlokip.fr/
+- PyPI: https://pypi.org/project/rdtsearch/
+- Source (GitHub): https://github.com/RDTvlokip/rdtsearch
+- Search engine: https://search.rdtvlokip.fr
+- API documentation: https://search.rdtvlokip.fr/api

rdtsearch-0.13.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+rdtsearch.py,sha256=CuVXVUs3tJrIMSQQEsYCCFzGLMXu1YqyQ9tpUo6JnXw,126930
+rdtsearch-0.13.1.dist-info/licenses/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
+rdtsearch-0.13.1.dist-info/METADATA,sha256=mbPqgXJNWj18khyCp7rWNOvkoB28KsPcCV9nwoVzUWo,7300
+rdtsearch-0.13.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+rdtsearch-0.13.1.dist-info/entry_points.txt,sha256=ehWaxgaibXPv6FzheSILwS4IYEhZ-MwoyRt99rqa3I4,45
+rdtsearch-0.13.1.dist-info/top_level.txt,sha256=hOleVKy6CTwITOPnu_KT-gvWw69MRlzICIQff42hEvg,10
+rdtsearch-0.13.1.dist-info/RECORD,,

rdtsearch-0.13.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

rdtsearch-0.13.1.dist-info/entry_points.txt

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