oslo config documentation should mention the delimiters needed when using a '$' within a string value

Bug #1872839 reported by Keith Berger
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
oslo.config
Fix Released
Undecided
Ben Nemec

Bug Description

The oslo config code treat treats the '$' as a special character and it needs to be delimited when using within a string. This is mentioned in the code

https://github.com/openstack/oslo.config/blob/master/oslo_config/cfg.py#L2752-L2758

but not in any of the documentation

https://docs.openstack.org/oslo.config/latest/index.html

A note should be added to the documentation explain what is needed when using a $ within a string.

Changed in oslo.config:
assignee: nobody → Ben Nemec (bnemec)
status: New → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to oslo.config (master)

Reviewed: https://review.opendev.org/724867
Committed: https://git.openstack.org/cgit/openstack/oslo.config/commit/?id=df5e5db191c13198a12b3eb24f0eda603e3324d8
Submitter: Zuul
Branch: master

commit df5e5db191c13198a12b3eb24f0eda603e3324d8
Author: Stephen Finucane <email address hidden>
Date: Fri May 1 16:10:30 2020 +0100

    docs: Mention other ways of escaping '$'

    oslo config code treat treats the '$' as a special character and it
    needs to be delimited when using within a string. There are two ways of
    doing this, '$$' or '\$'. We document the former but not the latter. Fix
    this.

    Change-Id: I37cdf31ba1c2924779a46b1a2eeabb66c46a2212
    Signed-off-by: Stephen Finucane <email address hidden>
    Closes-Bug: #1872839

Changed in oslo.config:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.