)]}'
{"doc/source/reference/drivers.rst":[{"author":{"_account_id":27954,"name":"Moisés Guimarães de Medeiros","email":"guimaraes@pm.me","username":"moguimar"},"change_message_id":"e8dc62c6ed883c7d09d0b4c71543afb7fcbedbd9","unresolved":false,"context_lines":[{"line_number":3,"context_line":"Backend Drivers for oslo.config"},{"line_number":4,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Currently, oslo.config is tightly bound to the plain text configuration files,"},{"line_number":7,"context_line":"we added a backend drivers support to allow deployers to store configuration"},{"line_number":8,"context_line":"data in other places. So far, we created a new driver called"},{"line_number":9,"context_line":"``INIConfigurationSourceDriver`` that allows to search for INI files served"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_424303b1","line":6,"range":{"start_line":6,"start_character":0,"end_line":6,"end_character":11},"updated":"2018-06-21 12:25:53.000000000","message":"time references will eventually get outdated","commit_id":"6cd391a66b86107dba804979780f86f6551d8b00"},{"author":{"_account_id":27954,"name":"Moisés Guimarães de Medeiros","email":"guimaraes@pm.me","username":"moguimar"},"change_message_id":"e8dc62c6ed883c7d09d0b4c71543afb7fcbedbd9","unresolved":false,"context_lines":[{"line_number":3,"context_line":"Backend Drivers for oslo.config"},{"line_number":4,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Currently, oslo.config is tightly bound to the plain text configuration files,"},{"line_number":7,"context_line":"we added a backend drivers support to allow deployers to store configuration"},{"line_number":8,"context_line":"data in other places. So far, we created a new driver called"},{"line_number":9,"context_line":"``INIConfigurationSourceDriver`` that allows to search for INI files served"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_82f83b7c","line":6,"range":{"start_line":6,"start_character":43,"end_line":6,"end_character":47},"updated":"2018-06-21 12:25:53.000000000","message":"you can drop this one","commit_id":"6cd391a66b86107dba804979780f86f6551d8b00"},{"author":{"_account_id":27954,"name":"Moisés Guimarães de Medeiros","email":"guimaraes@pm.me","username":"moguimar"},"change_message_id":"e8dc62c6ed883c7d09d0b4c71543afb7fcbedbd9","unresolved":false,"context_lines":[{"line_number":27,"context_line":"    uri \u003d https://oslo.config/extra.conf"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Even tought, we now that would be a good benefit since we will be able to"},{"line_number":31,"context_line":"store some of those secrets outside the configuration files and restore"},{"line_number":32,"context_line":"those secrets over a secure connection using https, this is a mid point"},{"line_number":33,"context_line":"solution. We are working to allow deployers to store configuration data in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_dd5936fd","line":30,"range":{"start_line":30,"start_character":16,"end_line":30,"end_character":19},"updated":"2018-06-21 12:25:53.000000000","message":"know","commit_id":"6cd391a66b86107dba804979780f86f6551d8b00"},{"author":{"_account_id":27954,"name":"Moisés Guimarães de Medeiros","email":"guimaraes@pm.me","username":"moguimar"},"change_message_id":"e8dc62c6ed883c7d09d0b4c71543afb7fcbedbd9","unresolved":false,"context_lines":[{"line_number":39,"context_line":"able to restore unmutable values, this will protect the service from having"},{"line_number":40,"context_line":"options from external sources mutaded when they reload the configuration files."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Note: For Rocky release, we are marking this feature as experimental."}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_dd405609","line":42,"range":{"start_line":42,"start_character":0,"end_line":42,"end_character":69},"updated":"2018-06-21 12:25:53.000000000","message":"I think that a disclaimer with special highlight at the beginning of the text will be better.","commit_id":"6cd391a66b86107dba804979780f86f6551d8b00"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"d57527f92d8fd4c3eda14c4628dff465ba05aef6","unresolved":false,"context_lines":[{"line_number":4,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":".. autoclass:: oslo_config.sources._uri.URIConfigurationSource"},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"Oslo.config is tightly bound to plain text configuration files, we added a"},{"line_number":9,"context_line":"backend drivers support to allow deployers to store configuration data in"},{"line_number":10,"context_line":"other places. So far, we created a new driver called"}],"source_content_type":"text/x-rst","patch_set":6,"id":"5f7c97a3_404c1b9d","line":7,"updated":"2018-06-25 19:17:03.000000000","message":"I wonder if most of the rest of the information below really should go in a new section in the \"configuration\" section instead of under reference. We haven\u0027t done a great job of separating the user content from the developer content in this repo, so maybe we want to just deal with that in a separate patch.","commit_id":"ed5ada86d45e1555cd56e956d43f643dd5d92b0d"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"d57527f92d8fd4c3eda14c4628dff465ba05aef6","unresolved":false,"context_lines":[{"line_number":7,"context_line":""},{"line_number":8,"context_line":"Oslo.config is tightly bound to plain text configuration files, we added a"},{"line_number":9,"context_line":"backend drivers support to allow deployers to store configuration data in"},{"line_number":10,"context_line":"other places. So far, we created a new driver called"},{"line_number":11,"context_line":"``INIConfigurationSourceDriver`` that allows to search for INI files served"},{"line_number":12,"context_line":"through ``http`` and ``https``."},{"line_number":13,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"5f7c97a3_80f9d34e","line":10,"updated":"2018-06-25 19:17:03.000000000","message":"\"So far\" implies a promise to do something else. We don\u0027t want to make that promise in the documentation.","commit_id":"ed5ada86d45e1555cd56e956d43f643dd5d92b0d"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"d57527f92d8fd4c3eda14c4628dff465ba05aef6","unresolved":false,"context_lines":[{"line_number":8,"context_line":"Oslo.config is tightly bound to plain text configuration files, we added a"},{"line_number":9,"context_line":"backend drivers support to allow deployers to store configuration data in"},{"line_number":10,"context_line":"other places. So far, we created a new driver called"},{"line_number":11,"context_line":"``INIConfigurationSourceDriver`` that allows to search for INI files served"},{"line_number":12,"context_line":"through ``http`` and ``https``."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Below is an example using a configuration file and hypothetical external ini"}],"source_content_type":"text/x-rst","patch_set":6,"id":"5f7c97a3_e0fe8736","line":11,"updated":"2018-06-25 19:17:03.000000000","message":"We should refer to the driver by the name the user is going to see (\"remote_file\") instead of the class name. We don\u0027t want them to have to know about implementation details.","commit_id":"ed5ada86d45e1555cd56e956d43f643dd5d92b0d"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"d57527f92d8fd4c3eda14c4628dff465ba05aef6","unresolved":false,"context_lines":[{"line_number":25,"context_line":"    config_sources \u003d extra_conf_from_ini"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"    [extra_conf_from_ini]"},{"line_number":28,"context_line":"    driver \u003d ini"},{"line_number":29,"context_line":"    uri \u003d https://oslo.config/extra.conf"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"5f7c97a3_6098371a","line":28,"updated":"2018-06-25 19:17:03.000000000","message":"s/ini/remote_file/","commit_id":"ed5ada86d45e1555cd56e956d43f643dd5d92b0d"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"d57527f92d8fd4c3eda14c4628dff465ba05aef6","unresolved":false,"context_lines":[{"line_number":29,"context_line":"    uri \u003d https://oslo.config/extra.conf"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"It\u0027s worth pointing out that, at this point, this INI driver will only be"},{"line_number":33,"context_line":"able to restore unmutable values, this will protect the service from having"},{"line_number":34,"context_line":"options from external sources mutaded when they reload the configuration files."}],"source_content_type":"text/x-rst","patch_set":6,"id":"5f7c97a3_209ebf05","line":32,"updated":"2018-06-25 19:17:03.000000000","message":"This applies to all drivers for now.","commit_id":"ed5ada86d45e1555cd56e956d43f643dd5d92b0d"}],"oslo_config/sources/__init__.py":[{"author":{"_account_id":8866,"name":"Raildo Mascena de Sousa Filho","email":"rmascena@redhat.com","username":"raildo"},"change_message_id":"1be48934031241d7619598dd856cb84267bcd91e","unresolved":false,"context_lines":[{"line_number":9,"context_line":"# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the"},{"line_number":10,"context_line":"# License for the specific language governing permissions and limitations"},{"line_number":11,"context_line":"# under the License."},{"line_number":12,"context_line":"r\"\"\""},{"line_number":13,"context_line":"Oslo.config\u0027s primary source of configuration data are plaintext, INI-like"},{"line_number":14,"context_line":"style, configuration files. With the addition of backend drivers support,"},{"line_number":15,"context_line":"it is possible to store configuration data in different places and with"}],"source_content_type":"text/x-python","patch_set":8,"id":"5f7c97a3_c5d10659","line":12,"updated":"2018-06-26 14:24:13.000000000","message":"nit: remove this \"r\" before the \"\"\"","commit_id":"252a719b2b7a29036923e50c0f7d68f94451b3d4"},{"author":{"_account_id":6928,"name":"Ben Nemec","email":"openstack@nemebean.com","username":"bnemec"},"change_message_id":"9cb179f7ad05ad509330676387e41aa67d5b23bb","unresolved":false,"context_lines":[{"line_number":13,"context_line":"Oslo.config\u0027s primary source of configuration data are plaintext, INI-like"},{"line_number":14,"context_line":"style, configuration files. With the addition of backend drivers support,"},{"line_number":15,"context_line":"it is possible to store configuration data in different places and with"},{"line_number":16,"context_line":"different formats, as long as, exists a proper driver to connect to those"},{"line_number":17,"context_line":"external sources and provides a way to fetch configuration values from them."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"A backend driver implementation is divided in two main classes, a driver"}],"source_content_type":"text/x-python","patch_set":12,"id":"5f7c97a3_774e916e","line":16,"range":{"start_line":16,"start_character":29,"end_line":16,"end_character":30},"updated":"2018-07-10 18:25:41.000000000","message":"Nit: I would replace the comma with \"there\".","commit_id":"e8c93ea5bad7777f56de1904296ffd701dd71cfc"},{"author":{"_account_id":6928,"name":"Ben Nemec","email":"openstack@nemebean.com","username":"bnemec"},"change_message_id":"9cb179f7ad05ad509330676387e41aa67d5b23bb","unresolved":false,"context_lines":[{"line_number":21,"context_line":"class of type :class:`ConfigurationSource`."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"**IMPORTANT:** At this point, all backend drivers are only able to provide"},{"line_number":24,"context_line":"unmutable values, this protects applications and services to have options"},{"line_number":25,"context_line":"from external sources mutaded when they reload configuration files."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Abstract Classes"}],"source_content_type":"text/x-python","patch_set":12,"id":"5f7c97a3_37a259fc","line":24,"range":{"start_line":24,"start_character":0,"end_line":24,"end_character":9},"updated":"2018-07-10 18:25:41.000000000","message":"Nit: This is typically written as immutable.","commit_id":"e8c93ea5bad7777f56de1904296ffd701dd71cfc"},{"author":{"_account_id":6928,"name":"Ben Nemec","email":"openstack@nemebean.com","username":"bnemec"},"change_message_id":"9cb179f7ad05ad509330676387e41aa67d5b23bb","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"**IMPORTANT:** At this point, all backend drivers are only able to provide"},{"line_number":24,"context_line":"unmutable values, this protects applications and services to have options"},{"line_number":25,"context_line":"from external sources mutaded when they reload configuration files."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Abstract Classes"},{"line_number":28,"context_line":"----------------"}],"source_content_type":"text/x-python","patch_set":12,"id":"5f7c97a3_97b24d49","line":25,"range":{"start_line":25,"start_character":22,"end_line":25,"end_character":29},"updated":"2018-07-10 18:25:41.000000000","message":"*mutated","commit_id":"e8c93ea5bad7777f56de1904296ffd701dd71cfc"},{"author":{"_account_id":6928,"name":"Ben Nemec","email":"openstack@nemebean.com","username":"bnemec"},"change_message_id":"9cb179f7ad05ad509330676387e41aa67d5b23bb","unresolved":false,"context_lines":[{"line_number":74,"context_line":"        driver \u003d castellan"},{"line_number":75,"context_line":"        ..."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"    Each specific driver knows all the available options to properly instatiate"},{"line_number":78,"context_line":"    a ConfigurationSource using the values comming from the given group in the"},{"line_number":79,"context_line":"    open_source_from_opt_group() method and is able to generate sample config"},{"line_number":80,"context_line":"    through the list_options_for_discovery() method."}],"source_content_type":"text/x-python","patch_set":12,"id":"5f7c97a3_57d03553","line":77,"range":{"start_line":77,"start_character":69,"end_line":77,"end_character":79},"updated":"2018-07-10 18:25:41.000000000","message":"*instantiate","commit_id":"e8c93ea5bad7777f56de1904296ffd701dd71cfc"},{"author":{"_account_id":6928,"name":"Ben Nemec","email":"openstack@nemebean.com","username":"bnemec"},"change_message_id":"9cb179f7ad05ad509330676387e41aa67d5b23bb","unresolved":false,"context_lines":[{"line_number":75,"context_line":"        ..."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"    Each specific driver knows all the available options to properly instatiate"},{"line_number":78,"context_line":"    a ConfigurationSource using the values comming from the given group in the"},{"line_number":79,"context_line":"    open_source_from_opt_group() method and is able to generate sample config"},{"line_number":80,"context_line":"    through the list_options_for_discovery() method."},{"line_number":81,"context_line":""}],"source_content_type":"text/x-python","patch_set":12,"id":"5f7c97a3_37f019fc","line":78,"range":{"start_line":78,"start_character":43,"end_line":78,"end_character":50},"updated":"2018-07-10 18:25:41.000000000","message":"*coming","commit_id":"e8c93ea5bad7777f56de1904296ffd701dd71cfc"}]}
