StructuredData.cpp

Go to the documentation of this file.

//===-- StructuredData.cpp ------------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
 
#include "lldb/Utility/StructuredData.h"
#include "lldb/Utility/FileSpec.h"
#include "lldb/Utility/Status.h"
#include "llvm/ADT/StringExtras.h"
#include "llvm/Support/MemoryBuffer.h"
#include <cerrno>
#include <cinttypes>
#include <cstdlib>
 
using namespace lldb_private;
using namespace llvm;
 
static StructuredData::ObjectSP ParseJSONObject(const json::Object &object);
static StructuredData::ObjectSP ParseJSONArray(const json::Array &array);
 
StructuredData::ObjectSP StructuredData::ParseJSON(llvm::StringRef json_text) {
  llvm::Expected<json::Value> value = json::parse(json_text);
  if (!value) {
    llvm::consumeError(value.takeError());
    return nullptr;
  }
  return ParseJSONValue(*value);
}
 
StructuredData::ObjectSP
StructuredData::ParseJSONFromFile(const FileSpec &input_spec, Status &error) {
  StructuredData::ObjectSP return_sp;
 
  auto buffer_or_error = llvm::MemoryBuffer::getFile(input_spec.GetPath());
  if (!buffer_or_error) {
    error = Status::FromErrorStringWithFormatv(
        "could not open input file: {0} - {1}.", input_spec.GetPath(),
        buffer_or_error.getError().message());
    return return_sp;
  }
  llvm::Expected<json::Value> value =
      json::parse(buffer_or_error.get()->getBuffer().str());
  if (value)
    return ParseJSONValue(*value);
  error = Status::FromError(value.takeError());
  return StructuredData::ObjectSP();
}
 
bool StructuredData::IsRecordType(const ObjectSP object_sp) {
  return object_sp->GetType() == lldb::eStructuredDataTypeArray ||
         object_sp->GetType() == lldb::eStructuredDataTypeDictionary;
}
 
StructuredData::ObjectSP
StructuredData::ParseJSONValue(const json::Value &value) {
  if (const json::Object *O = value.getAsObject())
    return ParseJSONObject(*O);
 
  if (const json::Array *A = value.getAsArray())
    return ParseJSONArray(*A);
 
  if (auto s = value.getAsString())
    return std::make_shared<StructuredData::String>(*s);
 
  if (auto b = value.getAsBoolean())
    return std::make_shared<StructuredData::Boolean>(*b);
 
  if (auto u = value.getAsUINT64())
    return std::make_shared<StructuredData::UnsignedInteger>(*u);
 
  if (auto i = value.getAsInteger())
    return std::make_shared<StructuredData::SignedInteger>(*i);
 
  if (auto d = value.getAsNumber())
    return std::make_shared<StructuredData::Float>(*d);
 
  if (auto n = value.getAsNull())
    return std::make_shared<StructuredData::Null>();
 
  return StructuredData::ObjectSP();
}
 
static StructuredData::ObjectSP ParseJSONObject(const json::Object &object) {
  auto dict_up = std::make_unique<StructuredData::Dictionary>();
  for (const auto &[key, value] : object) {
    if (auto value_sp = StructuredData::ParseJSONValue(value))
      dict_up->AddItem(key, value_sp);
  }
  return std::move(dict_up);
}
 
static StructuredData::ObjectSP ParseJSONArray(const json::Array &array) {
  auto array_up = std::make_unique<StructuredData::Array>();
  for (const json::Value &value : array) {
    if (auto value_sp = StructuredData::ParseJSONValue(value))
      array_up->AddItem(value_sp);
  }
  return std::move(array_up);
}
 
StructuredData::ObjectSP
StructuredData::Object::GetObjectForDotSeparatedPath(llvm::StringRef path) {
  if (GetType() == lldb::eStructuredDataTypeDictionary) {
    std::pair<llvm::StringRef, llvm::StringRef> match = path.split('.');
    llvm::StringRef key = match.first;
    ObjectSP value = GetAsDictionary()->GetValueForKey(key);
    if (!value)
      return {};
 
    // Do we have additional words to descend?  If not, return the value
    // we're at right now.
    if (match.second.empty())
      return value;
 
    return value->GetObjectForDotSeparatedPath(match.second);
  }
 
  if (GetType() == lldb::eStructuredDataTypeArray) {
    std::pair<llvm::StringRef, llvm::StringRef> match = path.split('[');
    if (match.second.empty())
      return shared_from_this();
 
    uint64_t val = 0;
    if (!llvm::to_integer(match.second, val, /* Base = */ 10))
      return {};
 
    return GetAsArray()->GetItemAtIndex(val);
  }
 
  return shared_from_this();
}
 
void StructuredData::Object::DumpToStdout(bool pretty_print) const {
  json::OStream stream(llvm::outs(), pretty_print ? 2 : 0);
  Serialize(stream);
}
 
void StructuredData::Array::Serialize(json::OStream &s) const {
  s.arrayBegin();
  for (const auto &item_sp : m_items) {
    item_sp->Serialize(s);
  }
  s.arrayEnd();
}
 
void StructuredData::Float::Serialize(json::OStream &s) const {
  s.value(m_value);
}
 
void StructuredData::Boolean::Serialize(json::OStream &s) const {
  s.value(m_value);
}
 
void StructuredData::String::Serialize(json::OStream &s) const {
  s.value(m_value);
}
 
void StructuredData::Dictionary::Serialize(json::OStream &s) const {
  s.objectBegin();
  ForEachSorted([&s](llvm::StringRef key, Object *object) {
    s.attributeBegin(key);
    object->Serialize(s);
    s.attributeEnd();
    return true;
  });
  s.objectEnd();
}
 
void StructuredData::Null::Serialize(json::OStream &s) const {
  s.value(nullptr);
}
 
void StructuredData::Generic::Serialize(json::OStream &s) const {
  s.value(llvm::formatv("{0:X}", m_object));
}
 
void StructuredData::Float::GetDescription(lldb_private::Stream &s) const {
  s.Printf("%f", m_value);
}
 
void StructuredData::Boolean::GetDescription(lldb_private::Stream &s) const {
  s.Printf(m_value ? "True" : "False");
}
 
void StructuredData::String::GetDescription(lldb_private::Stream &s) const {
  s.PutCString(m_value.empty() ? "\"\"" : m_value.c_str());
}
 
void StructuredData::Array::GetDescription(lldb_private::Stream &s) const {
  size_t index = 0;
  size_t indentation_level = s.GetIndentLevel();
  for (const auto &item_sp : m_items) {
    // Sanitize.
    if (!item_sp)
      continue;
 
    // Reset original indentation level.
    s.SetIndentLevel(indentation_level);
    s.Indent();
 
    // Print key
    s.Printf("[%zu]:", index++);
 
    // Return to new line and increase indentation if value is record type.
    // Otherwise add spacing.
    bool should_indent = IsRecordType(item_sp);
    if (should_indent) {
      s.EOL();
      s.IndentMore();
    } else {
      s.PutChar(' ');
    }
 
    // Print value and new line if now last pair.
    item_sp->GetDescription(s);
    if (item_sp != *(--m_items.end()))
      s.EOL();
 
    // Reset indentation level if it was incremented previously.
    if (should_indent)
      s.IndentLess();
  }
}
 
void StructuredData::Dictionary::GetDescription(lldb_private::Stream &s) const {
  size_t indentation_level = s.GetIndentLevel();
  const size_t num_entries = GetSize();
  size_t entry_index = 0;
 
  ForEachSorted([&](llvm::StringRef key, Object *object) {
    const bool is_last = ++entry_index == num_entries;
 
    // Sanitize.
    if (key.empty() || !object)
      return true;
 
    // Reset original indentation level.
    s.SetIndentLevel(indentation_level);
    s.Indent();
 
    // Print key.
    s.Format("{0}:", key);
 
    // Return to new line and increase indentation if value is record type.
    // Otherwise add spacing.
    bool should_indent = IsRecordType(object->shared_from_this());
    if (should_indent) {
      s.EOL();
      s.IndentMore();
    } else {
      s.PutChar(' ');
    }
 
    // Print value and new line if now last pair.
    object->GetDescription(s);
    if (!is_last)
      s.EOL();
 
    // Reset indentation level if it was incremented previously.
    if (should_indent)
      s.IndentLess();
    return true;
  });
}
 
void StructuredData::Null::GetDescription(lldb_private::Stream &s) const {
  s.PutCString("NULL");
}
 
void StructuredData::Generic::GetDescription(lldb_private::Stream &s) const {
  s.Printf("%p", m_object);
}