How publicsuffix/list works
The Public Suffix List is both a maintained domain-rule dataset and tooling for editing, validating, and using it. A contributor’s workflow runs through the psltool command interface, which parses and validates list data; the parser relies on domain-name handling, while online checks can consult GitHub and local history. The repository also provides suffix lookup, a standalone syntax linter, gTLD-list generation, and a private-domain review utility. Edges reflect excerpts, the source index, or README; unsampled internals are not inferred.
Main entry points: psltool.go psltool CLI · validate.go List validation · newgtlds.go gTLD updater · PSLPrivateDomainsProcessor.py Private-domain checker
Components 19
List and lookup
- Suffix list
public_suffix_list.dat - Suffix lookup
tools/internal/parser/file.go
Editing and validation
- psltool CLI
tools/psltool/psltool.go - PSL parser
tools/internal/parser/parser.go - Parsed list model
tools/internal/parser/file.go - Domain handling
tools/internal/domain/domain.go - List formatting
tools/internal/parser/clean.go - Validation exceptions
tools/internal/parser/exceptions.go - List validation
tools/internal/parser/validate.go - PR history
tools/internal/githistory/history.go - GitHub PR access
tools/internal/github/pr.go - Syntax linter
linter/pslint.py
List maintenance
- gTLD updater
tools/newgtlds.go - ICANN data
- IANA data
Domain review
- Private-domain checker
tools/private_domains_checker/PSLPrivateDomainsProcessor.py - DNS services
- WHOIS service
Other components
- Contributors
Connections 18
- Contributors → psltool CLI: run commands
tools/psltool/psltool.go - psltool CLI → PSL parser: parses list
tools/psltool/psltool.go - PSL parser → Domain handling: parses names
tools/internal/parser/parser.go - psltool CLI → List validation: validates list
tools/psltool/psltool.go - List validation → Domain handling: checks names
tools/internal/parser/validate.go - List validation → PR history: checks PR history
tools/internal/parser/validate.go - List validation → GitHub PR access: checks PR data
tools/internal/parser/validate.go - psltool CLI → PR history: loads PR history
tools/psltool/psltool.go - psltool CLI → GitHub PR access: fetches PR list
tools/psltool/psltool.go - Suffix lookup → Domain handling: uses domain names
tools/internal/parser/file.go - psltool CLI → List formatting: formats list
tools/psltool/psltool.go - Syntax linter → Suffix list: checks syntax
- gTLD updater → ICANN data: fetches gTLD data
tools/newgtlds.go - gTLD updater → IANA data: fetches TLD data
tools/newgtlds.go - gTLD updater → Suffix list: updates entries
- Private-domain checker → DNS services: checks DNS
tools/private_domains_checker/PSLPrivateDomainsProcessor.py - Private-domain checker → WHOIS service: queries WHOIS
- Private-domain checker → Suffix list: fetches list
tools/private_domains_checker/PSLPrivateDomainsProcessor.py