mirror of
https://github.com/ansible/ansible.git
synced 2026-07-27 16:18:51 +02:00
1378412a9e
* Deconstruct AGENTS.md to context dir * Split guidelines applicable to both humans and agents to top-level `context` dir. * Instruct agents to read all context files for now- piecemeal/just-in-time context ingestion has been spotty and problematic to date. Co-authored-by: Matt Clay <matt@mystile.com> Assisted-by: Claude * update package-data sanity to ignore context * markdown line length sanity * Ignore context dir in change detection * Remove core plugin deprecation instructions * Inconsistent with published docs and docsite behavior- resolve those first. --------- Co-authored-by: Matt Clay <matt@mystile.com>
810 B
810 B
Data tagging
How not to break things
Avoid unnecessary mutation of values, such as calling str.strip or to_text, etc. as these will drop tags, losing things like origin and trust for templating.
When mutation of a value is necessary, carefully consider which tags, if any, need to be propagated to the resulting value.
When tags must be removed
Some APIs don't understand tagged types and can't automatically treat them as their untagged equivalents.
This includes C-implemented Python APIs that perform exact type checks, serialization libraries that reject derived types,
and any interface where the consumer expects or requires plain types.
In these cases, use transform_to_native_types() from ansible.utils.vars to convert tagged values to native types before passing them to the API.