ceph-mirror/doc/scripts
Kefu Chai 2178a1aa77 doc/scripts: use raw string for regex in gen_state_diagram.py
Python 3.12 emits SyntaxWarning for invalid escape sequences in ordinary
string literals. The re.search() call on line 162 was the only pattern
in the file passed as a non-raw string, causing:

  doc/scripts/gen_state_diagram.py:162: SyntaxWarning: invalid escape
    sequence '\s'
    i = re.search("return\s+transit<\s*(\w*)\s*>()", line)

Add the r"" prefix to match the other re.search / re.finditer / re.sub
call sites in the same file. No behavior change; \s was already being
interpreted as a regex whitespace class because Python leaves unknown
escapes untouched, but this will become a SyntaxError in a future
Python release.

Signed-off-by: Kefu Chai <k.chai@proxmox.com>
2026-04-24 21:37:59 +08:00
..
gen_state_diagram.py doc/scripts: use raw string for regex in gen_state_diagram.py 2026-04-24 21:37:59 +08:00
README.md doc/dev: add section on using the gen_state_diagram.py script 2022-02-10 09:12:05 -06:00

Script Usage

Peering State Model: gen_state_diagram.py

$ git clone https://github.com/ceph/ceph.git
$ cd ceph
$ cat src/osd/PeeringState.h src/osd/PeeringState.cc | doc/scripts/gen_state_diagram.py > doc/dev/peering_graph.generated.dot
$ sed -i 's/7,7/1080,1080/' doc/dev/peering_graph.generated.dot
$ dot -Tsvg doc/dev/peering_graph.generated.dot > doc/dev/peering_graph.generated.svg