Skip to content

docs: add Common Recipes section for well-known files#2527

Open
iacker wants to merge 1 commit into
projectdiscovery:mainfrom
iacker:docs/well-known-recipes
Open

docs: add Common Recipes section for well-known files#2527
iacker wants to merge 1 commit into
projectdiscovery:mainfrom
iacker:docs/well-known-recipes

Conversation

@iacker

@iacker iacker commented Jul 4, 2026

Copy link
Copy Markdown

Per maintainer feedback on #2472, this PR adds a Common Recipes section to the README demonstrating how to detect , , , and other well-known URIs using httpx's composable primitives.

Changes

  • ✨ New "Common Recipes" section inserted before "# Notes"
  • 📖 Practical one-liners using -path, -mc, -mct, -mr flags
  • 🔗 Links to RFC 9116 (security.txt) and IANA well-known URIs registry

Context

@Mzack9999 suggested in this comment turning the closed PR #2472 into docs showing well-known file recipes as an alternative to adding per-file flags.

This aligns with httpx's philosophy of composability over specialized flags.

Testing

Verified all one-liners locally:

echo target.com | httpx -path '/.well-known/security.txt' -mc 200 -mct 'text/plain' -mr 'Contact:'

cc @Mzack9999 — happy to iterate on wording/format if needed.

Per maintainer feedback on PR projectdiscovery#2472, add a 'Common Recipes' section
demonstrating how to detect security.txt, robots.txt, sitemap.xml, and
other well-known URIs using httpx's composable primitives.

Includes:
- security.txt detection with RFC 9116 compliance checks
- robots.txt and sitemap.xml probes
- IANA well-known URIs registry reference
- One-liner examples using -path, -mc, -mct, -mr flags

Reference: projectdiscovery#2468 (comment)
@coderabbitai

coderabbitai Bot commented Jul 4, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fd4891c4-64d5-46d3-8498-e8449a656532

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant