你怎么能让yaml-cpp解析器删除所有注释？

Question

我有一个项目需要读取记录良好的yaml文件,修改几个值,然后将其写回.麻烦的是yaml-cpp完全消除所有评论并"吃掉"它们.有趣的是,YAML::Emitter该类允许一个人向输出添加注释.有没有办法保留输入中的注释并将它们写回到我没有看到的库中？因为现在看来,我看不到使用YAML::Parser类的任何方式(使用YAML::Scanner类,其中注释本身实际上被"吃掉").

Answer 1

根据YAML 规范

注释是表示细节，不得对序列化树或表示图产生任何影响

因此，您需要使解析器不兼容以保留注释，如果 yaml-cpp 这样做了，它们应该在文档中明确说明。

我在ruamel.yaml中为 Python 执行了此操作。如果可以接受从 C++ 程序嵌入和调用 Python，您可以执行类似以下操作（我在 Linux Mint 下使用 Python 3.5）：

pythonyaml.cpp：

#include <Python.h>

int
update_yaml(const char*yif, const char *yof, const char* obj_path, int val)
{
    PyObject *pName, *pModule, *pFunc;
    PyObject *pArgs, *pValue;
    const char *modname = "update_yaml";
    const char *lus = "load_update_save";

    Py_Initialize();
    // add current directory to search path
    PyObject *sys_path = PySys_GetObject("path");
    PyList_Append(sys_path, PyUnicode_FromString("."));

    pName = PyUnicode_DecodeFSDefault(modname);
    /* Error checking of pName left out */

    pModule = PyImport_Import(pName);
    Py_DECREF(pName);

    if (pModule != NULL) {
        pFunc = PyObject_GetAttrString(pModule, lus);
        /* pFunc is a new reference */

        if (pFunc && PyCallable_Check(pFunc)) {
            pArgs = PyTuple_New(4);
            PyTuple_SetItem(pArgs, 0, PyUnicode_FromString(yif));
            PyTuple_SetItem(pArgs, 1, PyUnicode_FromString(yof));
            PyTuple_SetItem(pArgs, 2, PyUnicode_FromString(obj_path));
            PyTuple_SetItem(pArgs, 3, PyLong_FromLong(val));

            pValue = PyObject_CallObject(pFunc, pArgs);
            Py_DECREF(pArgs);
            if (pValue != NULL) {
                printf("Old value: %ld\n", PyLong_AsLong(pValue));
                Py_DECREF(pValue);
            }
            else {
                Py_DECREF(pFunc);
                Py_DECREF(pModule);
                PyErr_Print();
                fprintf(stderr,"Call failed\n");
                return 1;
            }
        }
        else {
            if (PyErr_Occurred())
                PyErr_Print();
            fprintf(stderr, "Cannot find function \"%s\"\n", lus);
        }
        Py_XDECREF(pFunc);
        Py_DECREF(pModule);
    }
    else {
        PyErr_Print();
        fprintf(stderr, "Failed to load \"%s\"\n", modname);
        return 1;
    }
    Py_Finalize();
    return 0;
}


int
main(int argc, char *argv[])
{
    const char *yaml_in_file = "input.yaml";
    const char *yaml_out_file = "output.yaml";
    update_yaml(yaml_in_file, yaml_out_file, "abc.1.klm", 42);
}

创建一个Makefile（将路径调整为您的Python3.5安装，需要安装标头，如果从源代码编译则正常，否则您需要python3-dev安装包）：

echo -e "SRC:=pythonyaml.cpp\n\ncompile:\n\tgcc \$(SRC) $(/opt/python/3.5/bin/python3-config --cflags --ldflags | tr --delete '\n' | sed 's/-Wstrict-prototypes//') -o pythonyaml"  > Makefile

用 编译程序make。

创建update_yaml.py将由以下方式加载pythonyaml：

# coding: utf-8

import traceback
import ruamel.yaml


def set_value(data, key_list, value):
    """key list is a set keys to access nested dict and list
    dict keys are assumed to be strings, keys for a list must be convertable to integer
    """
    key = key_list.pop(0)
    if isinstance(data, list):
        key = int(key)
    item = data[key]
    if len(key_list) == 0:
        data[key] = value
        return item
    return set_value(item, key_list, value)


def load_update_save(yaml_in, yaml_out, obj_path, value):
    try:
        if not isinstance(obj_path, list):
            obj_path = obj_path.split('.')
        with open(yaml_in) as fp:
            data = ruamel.yaml.round_trip_load(fp)
        res = set_value(data, obj_path.split('.'), value)
        with open(yaml_out, 'w') as fp:
            ruamel.yaml.round_trip_dump(data, fp)
        return res
    except Exception as e:
        print('Exception', e)
        traceback.print_exc()  # to get some useful feedback if your python has errors

创造input.yaml：

abc:
  - zero-th item of list
  - klm: -999        # the answer?
    xyz: last entry  # another comment

如果你已经ruamel.yaml安装了 python3.5 并运行./python_yaml它将打印Old value: -999，并且新文件output.yaml将包含：

abc:
- zero-th item of list
- klm: 42            # the answer?
  xyz: last entry    # another comment

• 虽然42只有两个字符（-999有四个字符），但注释仍然与其下面的注释对齐
• abc.1.klm您可以用 C++ 创建一个 Python 列表，并将其作为第三个参数，而不是提供点线路径load_update_save()。在这种情况下，您可以使用字符串以外的其他项目的键，或者包含点的字符串的键
• 根据您的使用情况，您可能希望更改为该值设置整数（PyLong_FromLong用于第四个参数）的硬编码假设。python 程序不需要为此更新。
• 您可以对输入和输出使用相同的文件名，以覆盖输入。
• 可以使用以下命令更改 python 文件中的注释ruamel.yaml