Blue hawk demo

[ngrayluna]

• Removes code from markdown file and moves it to code_examples/source.
• Uses Blue Hawk to parse the script into snippets using code snippets and Blue Hawk CLI. Those snippets are then injected into markdown files. For example, suppose you have a file called quickstart.py:

{{< code language="python" source="/code_examples/snippets/quickstart.snippet.all.py" >}}

Where quickstart refers to the file name and all refers to the code block comment + title

  # :snippet-start: all
  import wandb
  import random
  # :snippet-end: all

This PR also adds a GitHub Action that checks:

1. You can install libraries used in scripts successfully check_dependencies.sh
2. Files stored in code_examples/source run successfully. It uses matrix to check files in parallel.

---

This is a WIP PR. Not ready for reviews just yet while I still demo, configure.

Known to-dos:

1. Configure wandb API key for checks. See this line in error message.

📄 View preview links for changed pages

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pypi/​wandb@​0.21.3

View full report

[socket-security]

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert  (click "▶" to expand/collapse)
Warn		pypi/[email protected] has Native code. Location: Package overview From: ? → pypi/[email protected] → pypi/[email protected] ℹ Read more on: This package | This alert | Why is native code a concern? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at [email protected]. Suggestion: Verify that the inclusion of native code is expected and necessary for this package's functionality. If it is unnecessary or unexpected, consider using alternative packages without native code to mitigate potential risks. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore pypi/[email protected]. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		pypi/[email protected] has Native code. Location: Package overview From: ? → pypi/[email protected] → pypi/[email protected] ℹ Read more on: This package | This alert | Why is native code a concern? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at [email protected]. Suggestion: Verify that the inclusion of native code is expected and necessary for this package's functionality. If it is unnecessary or unexpected, consider using alternative packages without native code to mitigate potential risks. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore pypi/[email protected]. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		pypi/[email protected] has Native code. Location: Package overview From: code_examples/requirements.txt → pypi/[email protected] ℹ Read more on: This package | This alert | Why is native code a concern? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at [email protected]. Suggestion: Verify that the inclusion of native code is expected and necessary for this package's functionality. If it is unnecessary or unexpected, consider using alternative packages without native code to mitigate potential risks. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore pypi/[email protected]. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

[cloudflare-workers-and-pages]

Deploying docs with    Cloudflare Pages

Latest commit:	e368b54
Status:	✅  Deploy successful!
Preview URL:	https://c33a93b4.docodile.pages.dev
Branch Preview URL:	https://blue-hawk-demo.docodile.pages.dev

View logs

[mdlinville]

This is a bit greedy. At a minimum I'd add -type f so you don't find directories that end in .py. I'm also confused why you have to take something that is going to be multi-line input with one result per line, join it up, and then split it again right away?

Suggested change

	SCRIPTS=$(find code_examples/source -name "*.py" | jq -R -s -c 'split("\n")[:-1]')
	SCRIPTS=$(find 'code_examples/source' -type f -name "*.py" | jq -R -s -c 'split("\n")[:-1]')

[github-actions]

PR Preview: Changed content

Base preview: https://blue-hawk-demo.docodile.pages.dev

Added

Title	Path
Code.Html	layouts/shortcodes/code.html

Modified

Title	Path
W&B Quickstart	content/en/guides/quickstart.md

[ngrayluna]

Closing in favor of: #1668