mirror of
https://github.com/weechat/weechat.git
synced 2026-06-12 14:14:48 +02:00
doc/api: Improve python example for config_new_section
This updates the Python examples to include all the possible return values for the callbacks in config_new_section, like it is done in the C example. It also aligns the order of the values with the C example.
This commit is contained in:
committed by
Sébastien Helleu
parent
abdabb3ae4
commit
dc8a35796a
@@ -6457,24 +6457,34 @@ def my_section_read_cb(data: str, config_file: str, section: str, option_name: s
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
|
||||
|
||||
section = weechat.config_new_section(config_file, "section1", 1, 1,
|
||||
"my_section_read_cb", "",
|
||||
|
||||
@@ -6559,24 +6559,34 @@ def my_section_read_cb(data: str, config_file: str, section: str, option_name: s
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
|
||||
|
||||
section = weechat.config_new_section(config_file, "section1", 1, 1,
|
||||
"my_section_read_cb", "",
|
||||
|
||||
@@ -6696,24 +6696,34 @@ def my_section_read_cb(data: str, config_file: str, section: str, option_name: s
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
|
||||
|
||||
section = weechat.config_new_section(config_file, "section1", 1, 1,
|
||||
"my_section_read_cb", "",
|
||||
|
||||
@@ -6499,24 +6499,34 @@ def my_section_read_cb(data: str, config_file: str, section: str, option_name: s
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
|
||||
|
||||
section = weechat.config_new_section(config_file, "section1", 1, 1,
|
||||
"my_section_read_cb", "",
|
||||
|
||||
@@ -6269,24 +6269,34 @@ def my_section_read_cb(data: str, config_file: str, section: str, option_name: s
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
|
||||
|
||||
section = weechat.config_new_section(config_file, "section1", 1, 1,
|
||||
"my_section_read_cb", "",
|
||||
|
||||
@@ -496,24 +496,34 @@ def config_new_section(config_file: str, name: str,
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_write_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_write_default_cb(data: str, config_file: str, section_name: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_WRITE_OK
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_WRITE_MEMORY_ERROR
|
||||
|
||||
def my_section_create_option_cb(data: str, config_file: str, section: str, option_name: str, value: str | None) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
return weechat.WEECHAT_CONFIG_OPTION_SET_OK_CHANGED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_ERROR
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND
|
||||
|
||||
def my_section_delete_option_cb(data: str, config_file: str, section: str, option: str) -> int:
|
||||
# ...
|
||||
return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_OK_RESET
|
||||
# return weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR
|
||||
|
||||
section = weechat.config_new_section(config_file, "section1", 1, 1,
|
||||
"my_section_read_cb", "",
|
||||
|
||||
Reference in New Issue
Block a user