# `SF016` Scan code for requirement references
{bdg-ref-primary}`tooling <tooling>`

When `code_sources` are declared, Speky shall scan them for comments containing a
reference tag of the form `speky:<name>#<ID>`, where `<name>` matches the manifest's
`name` field. Tags in other namespaces shall be silently ignored.

Each discovered reference shall record the target ID, file path, line number, and
symbol name.

Supported languages: Python (`.py`), Go (`.go`), Rust (`.rs`).


:::{dropdown} Tested by
:open: 
:icon: check-circle-fill
:color: success

[`TF013` Scan code for references](/tests/TF013)
:::

:::{dropdown} References
:icon: link
:color: secondary

__Relates to:__
[`SF015` Code sources in manifest](/requirements/SF015)

__Referenced by:__
- [`SF017` Source links in manifest](/requirements/SF017)
- [`SN006` Use tree-sitter for code scanning](/requirements/SN006)

:::

:::{dropdown} Source
:icon: file-code
:color: info

__Source file__: [`specs/functional.yaml`](https://github.com/agagniere/speky/blob/master/specs/functional.yaml)

__Loaded from__: [`speky`](https://github.com/agagniere/speky/blob/master/specs/speky.yaml)

__Implemented in:__
- {fab}`python` [`python/speky/scanner.py:1`](https://github.com/agagniere/speky/blob/master/python/speky/scanner.py#L1)
- {fab}`python` [`scan_code_sources`](https://github.com/agagniere/speky/blob/master/python/speky/specification.py#L191)
:::