/*
 * Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, version 2.0,
 * as published by the Free Software Foundation.
 *
 * This program is designed to work with certain software (including
 * but not limited to OpenSSL) that is licensed under separate terms,
 * as designated in a particular file or component or in included license
 * documentation.  The authors of MySQL hereby grant you an additional
 * permission to link the program and your derivative works with the
 * separately licensed software that they have either included with
 * the program or referenced in the documentation.
 *
 * This program is distributed in the hope that it will be useful,  but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
 * the GNU General Public License, version 2.0, for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef MYSQLSHDK_LIBS_UTILS_STRUCTURED_TEXT_H_
#define MYSQLSHDK_LIBS_UTILS_STRUCTURED_TEXT_H_

#include <cstring>
#include <string>

#include "mysqlshdk/libs/utils/utils_string.h"

namespace shcore {

namespace kvp {

inline bool should_quote(const char *s) {
  // Chars that don't need to be quoted in a KVP key or value
  static constexpr auto k_kvp_allowed_chars =
      "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_.$@";

  size_t p = strspn(s, k_kvp_allowed_chars);
  return s[p] != 0;
}

inline std::string quote(const std::string &v, char q) {
  return should_quote(v.c_str()) ? quote_string(v, q) : v;
}

inline std::string make(const char *key, const std::string &value, char quote) {
  return kvp::quote(key, quote) + "=" + value;
}

}  // namespace kvp

/**
 * Produces a KVP pair, quoting strings when necessary.
 *
 * Use ' for quotes by default, so that they don't get escaped in a JSON string.
 */
inline std::string make_kvp(const char *key, const std::string &value,
                            char quote = '\'') {
  return kvp::make(key, kvp::quote(value, quote), quote);
}

inline std::string make_kvp(const char *key, const char *value,
                            char quote = '\'') {
  return make_kvp(key, std::string{value}, quote);
}

template <typename T>
inline std::string make_kvp(const char *key, T value, char quote = '\'') {
  return kvp::make(key, std::to_string(value), quote);
}

}  // namespace shcore

#endif  // MYSQLSHDK_LIBS_UTILS_STRUCTURED_TEXT_H_
