1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
#ifndef INCLUDED_ORCUS_CONFIG_HPP
#define INCLUDED_ORCUS_CONFIG_HPP
#include "orcus/env.hpp"
#include "orcus/types.hpp"
#include <string>
#include <variant>
namespace orcus {
struct ORCUS_DLLPUBLIC config
{
format_t input_format;
/**
* configuration settings specific to the CSV format. This struct must be
* POD.
*/
struct csv_config
{
/** Number of header rows to repeat in case of split. */
size_t header_row_size;
/**
* Whether or not to split oversized source data into multiple sheets
* in case it spills over.
*/
bool split_to_multiple_sheets;
};
// TODO: add config for other formats as needed.
using data_type = std::variant<csv_config>;
/**
* Enable or disable runtime debug output to stdout or stderr.
*/
bool debug;
/**
* Control whether or not to perform strict check of the xml structure of
* a stream being parsed. When enabled, it throws an xml_structure_error
* exception when an incorrect xml structure is detected.
*/
bool structure_check;
data_type data;
config(format_t input_format);
};
struct ORCUS_DLLPUBLIC json_config
{
/**
* Path of the JSON file being parsed, in case the JSON string originates
* from a file. This parameter is required if external JSON files need to
* be resolved. Otherwise it's optional.
*/
std::string input_path;
/**
* Path of the file to which output is written to. Used only from the
* orcus-json command line tool.
*/
std::string output_path;
/**
* Output format type. Used only from the orcus-json command line tool.
*/
dump_format_t output_format;
/**
* Control whether or not to preserve the order of object's child
* name/value pairs. By definition, JSON's object is an unordered set of
* name/value pairs, but in some cases preserving the original order may
* be desirable.
*/
bool preserve_object_order;
/**
* Control whether or not to resolve JSON references to external files.
*/
bool resolve_references;
/**
* When true, the document tree should allocate memory and hold copies of
* string values in the tree. When false, no extra memory is allocated
* for string values in the tree and the string values simply point to the
* original json string stream.
*
* In other words, when this option is set to false, the caller must
* ensure that the json string stream instance stays alive for the entire
* life cycle of the document tree.
*/
bool persistent_string_values;
json_config();
~json_config();
};
struct ORCUS_DLLPUBLIC yaml_config
{
enum class output_format_type { none, yaml, json };
std::string input_path;
std::string output_path;
output_format_type output_format;
yaml_config();
~yaml_config();
};
}
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
