pidgin/pidgin

Add functions for reading XML files from XDG dirs
xdg-dirs
2016-10-02, qarkai
4e9c691a1d2d
Parents d6ebc5c97d74
Children 6d800b496317
Add functions for reading XML files from XDG dirs
2 files changed, 72 insertions(+), 0 deletions(-)
  • +18 -0
    libpurple/util.c
  • +54 -0
    libpurple/util.h
    • --- a/libpurple/util.c Sun Oct 02 07:11:20 2016 +0300
    +++ b/libpurple/util.c Sun Oct 02 07:13:45 2016 +0300
    @@ -3284,6 +3284,24 @@
    return purple_xmlnode_from_file(purple_user_dir(), filename, description, "util");
    }
    +PurpleXmlNode *
    +purple_util_read_xml_from_cache_file(const char *filename, const char *description)
    +{
    + return purple_xmlnode_from_file(purple_cache_dir(), filename, description, "util");
    +}
    +
    +PurpleXmlNode *
    +purple_util_read_xml_from_config_file(const char *filename, const char *description)
    +{
    + return purple_xmlnode_from_file(purple_config_dir(), filename, description, "util");
    +}
    +
    +PurpleXmlNode *
    +purple_util_read_xml_from_data_file(const char *filename, const char *description)
    +{
    + return purple_xmlnode_from_file(purple_data_dir(), filename, description, "util");
    +}
    +
    /*
    * Like mkstemp() but returns a file pointer, uses a pre-set template,
    * uses the semantics of tempnam() for the directory to use and allocates
    --- a/libpurple/util.h Sun Oct 02 07:11:20 2016 +0300
    +++ b/libpurple/util.h Sun Oct 02 07:13:45 2016 +0300
    @@ -953,6 +953,60 @@
    const char *description);
    /**
    + * purple_util_read_xml_from_cache_file:
    + * @filename: The basename of the file to open in the purple_cache_dir.
    + * @description: A very short description of the contents of this
    + * file. This is used in error messages shown to the
    + * user when the file can not be opened. For example,
    + * "preferences," or "buddy pounces."
    + *
    + * Read the contents of a given file and parse the results into an
    + * PurpleXmlNode tree structure. This is intended to be used to read
    + * Purple's cache xml files (xmpp-caps.xml, etc.)
    + *
    + * Returns: An PurpleXmlNode tree of the contents of the given file. Or NULL, if
    + * the file does not exist or there was an error reading the file.
    + */
    +PurpleXmlNode *
    +purple_util_read_xml_from_cache_file(const char *filename, const char *description);
    +
    +/**
    + * purple_util_read_xml_from_config_file:
    + * @filename: The basename of the file to open in the purple_config_dir.
    + * @description: A very short description of the contents of this
    + * file. This is used in error messages shown to the
    + * user when the file can not be opened. For example,
    + * "preferences," or "buddy pounces."
    + *
    + * Read the contents of a given file and parse the results into an
    + * PurpleXmlNode tree structure. This is intended to be used to read
    + * Purple's config xml files (prefs.xml, pounces.xml, etc.)
    + *
    + * Returns: An PurpleXmlNode tree of the contents of the given file. Or NULL, if
    + * the file does not exist or there was an error reading the file.
    + */
    +PurpleXmlNode *
    +purple_util_read_xml_from_config_file(const char *filename, const char *description);
    +
    +/**
    + * purple_util_read_xml_from_data_file:
    + * @filename: The basename of the file to open in the purple_data_dir.
    + * @description: A very short description of the contents of this
    + * file. This is used in error messages shown to the
    + * user when the file can not be opened. For example,
    + * "preferences," or "buddy pounces."
    + *
    + * Read the contents of a given file and parse the results into an
    + * PurpleXmlNode tree structure. This is intended to be used to read
    + * Purple's cache xml files (accounts.xml, etc.)
    + *
    + * Returns: An PurpleXmlNode tree of the contents of the given file. Or NULL, if
    + * the file does not exist or there was an error reading the file.
    + */
    +PurpleXmlNode *
    +purple_util_read_xml_from_data_file(const char *filename, const char *description);
    +
    +/**
    * purple_mkstemp:
    * @path: The returned path to the temp file.
    * @binary: Text or binary, for platforms where it matters.