rippled/beast/utility/impl/PropertyStream.cpp

//------------------------------------------------------------------------------
/*
    This file is part of Beast: https://github.com/vinniefalco/Beast
    Copyright 2013, Vinnie Falco <vinnie.falco@gmail.com>

    Permission to use, copy, modify, and/or distribute this software for any
    purpose  with  or without fee is hereby granted, provided that the above
    copyright notice and this permission notice appear in all copies.

    THE  SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
    WITH  REGARD  TO  THIS  SOFTWARE  INCLUDING  ALL  IMPLIED  WARRANTIES  OF
    MERCHANTABILITY  AND  FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
    ANY  SPECIAL ,  DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
    WHATSOEVER  RESULTING  FROM  LOSS  OF USE, DATA OR PROFITS, WHETHER IN AN
    ACTION  OF  CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
//==============================================================================

#include "../PropertyStream.h"

#include <limits>
#include <iostream>

namespace beast {

//------------------------------------------------------------------------------
//
// Item
//
//------------------------------------------------------------------------------

PropertyStream::Item::Item (Source* source)
    : m_source (source)
{
}

PropertyStream::Source& PropertyStream::Item::source() const
{
    return *m_source;
}

PropertyStream::Source* PropertyStream::Item::operator-> () const
{
    return &source();
}

PropertyStream::Source& PropertyStream::Item::operator* () const
{
    return source();
}

//------------------------------------------------------------------------------
//
// Proxy
//
//------------------------------------------------------------------------------

PropertyStream::Proxy::Proxy (
    Map const& map, std::string const& key)
    : m_map (&map)
    , m_key (key)
{
}

PropertyStream::Proxy::Proxy (Proxy const& other)
    : m_map (other.m_map)
    , m_key (other.m_key)
{
}

PropertyStream::Proxy::~Proxy ()
{
    std::string const s (m_ostream.str());
    if (! s.empty())
        m_map->add (m_key, s);
}

std::ostream& PropertyStream::Proxy::operator<< (
    std::ostream& manip (std::ostream&)) const
{
    return m_ostream << manip;
}

//------------------------------------------------------------------------------
//
// Map
//
//------------------------------------------------------------------------------

PropertyStream::Map::Map (PropertyStream& stream)
    : m_stream (stream)
{
}

PropertyStream::Map::Map (Set& parent)
    : m_stream (parent.stream())
{
    m_stream.map_begin ();
}

PropertyStream::Map::Map (std::string const& key, Map& map)
    : m_stream (map.stream())
{
    m_stream.map_begin (key);
}

PropertyStream::Map::Map (std::string const& key, PropertyStream& stream)
    : m_stream (stream)
{
    m_stream.map_begin (key);
}

PropertyStream::Map::~Map ()
{
    m_stream.map_end ();
}

PropertyStream& PropertyStream::Map::stream()
{
    return m_stream;
}

PropertyStream const& PropertyStream::Map::stream() const
{
    return m_stream;
}

PropertyStream::Proxy PropertyStream::Map::operator[] (std::string const& key)
{
    return Proxy (*this, key);
}

//------------------------------------------------------------------------------
//
// Set
//
//------------------------------------------------------------------------------

PropertyStream::Set::Set (Set& set)
    : m_stream (set.m_stream)
{
    m_stream.array_begin ();
}

PropertyStream::Set::Set (std::string const& key, Map& map)
    : m_stream (map.stream())
{
    m_stream.array_begin (key);
}

PropertyStream::Set::Set (std::string const& key, PropertyStream& stream)
    : m_stream (stream)
{
    m_stream.array_begin (key);
}

PropertyStream::Set::~Set ()
{
    m_stream.array_end ();
}

PropertyStream& PropertyStream::Set::stream()
{
    return m_stream;
}

PropertyStream const& PropertyStream::Set::stream() const
{
    return m_stream;
}

//------------------------------------------------------------------------------
//
// Source
//
//------------------------------------------------------------------------------

PropertyStream::Source::Source (std::string const& name)
    : m_name (name)
    , m_state (this)
{
}

PropertyStream::Source::~Source ()
{
    SharedState::Access state (m_state);
    if (state->parent != nullptr)
        state->parent->remove (*this);
    removeAll (state);
}

std::string const& PropertyStream::Source::name () const
{
    return m_name;
}

void PropertyStream::Source::add (Source& source)
{
    SharedState::Access state (m_state);
    SharedState::Access childState (source.m_state);
    bassert (childState->parent == nullptr);
    state->children.push_back (childState->item);
    childState->parent = this;
}

void PropertyStream::Source::remove (Source& child)
{
    SharedState::Access state (m_state);
    SharedState::Access childState (child.m_state);
    remove (state, childState);
}

void PropertyStream::Source::removeAll ()
{
    SharedState::Access state (m_state);
    removeAll (state);
}

//------------------------------------------------------------------------------

void PropertyStream::Source::write (
    SharedState::Access& state, PropertyStream &stream)
{
    for (List <Item>::iterator iter (state->children.begin());
        iter != state->children.end(); ++iter)
    {
        Source& source (iter->source());
        Map map (source.name(), stream);
        source.write (stream);
    }
}

//------------------------------------------------------------------------------

void PropertyStream::Source::write_one (PropertyStream& stream)
{
    Map map (m_name, stream);
    onWrite (map);
}

void PropertyStream::Source::write (PropertyStream& stream)
{
    Map map (m_name, stream);
    onWrite (map);

    SharedState::Access state (m_state);

    for (List <Item>::iterator iter (state->children.begin());
        iter != state->children.end(); ++iter)
    {
        Source& source (iter->source());
        source.write (stream);
    }
}

void PropertyStream::Source::write (PropertyStream& stream, std::string const& path)
{
    std::pair <Source*, bool> result (find (path));

    if (result.first == nullptr)
        return;

    if (result.second)
        result.first->write (stream);
    else
        result.first->write_one (stream);
}

std::pair <PropertyStream::Source*, bool> PropertyStream::Source::find (std::string path)
{
    bool const deep (peel_trailing_slashstar (&path));
    bool const rooted (peel_leading_slash (&path));
    Source* source (this);
    if (! path.empty())
    {
        if (! rooted)
        {
            std::string const name (peel_name (&path));
            source = find_one_deep (name);
            if (source == nullptr)
                return std::make_pair (nullptr, deep);
        }
        source = source->find_path (path);
    }
    return std::make_pair (source, deep);
}

bool PropertyStream::Source::peel_leading_slash (std::string* path)
{
    if (! path->empty() && path->front() == '/')
    {
        *path = std::string (path->begin() + 1, path->end());
        return true;
    }
    return false;
}

bool PropertyStream::Source::peel_trailing_slashstar (std::string* path)
{
    bool found(false);
    if (path->empty())
        return false;
    if (path->back() == '*')
    {
        found = true;
        path->pop_back();
    }
    if(! path->empty() && path->back() == '/')
        path->pop_back();
    return found;
}

std::string PropertyStream::Source::peel_name (std::string* path)
{
    if (path->empty())
        return "";
    
    std::string::const_iterator first = (*path).begin();
    std::string::const_iterator last = (*path).end();
    std::string::const_iterator pos (std::find (first, last, '/'));
    std::string s (first, pos);
    
    if (pos != last)
        *path = std::string (pos+1, last);
    else
        *path = std::string ();

    return s;
}

// Recursive search through the whole tree until name is found
PropertyStream::Source* PropertyStream::Source::find_one_deep (std::string const& name)
{
    Source* found = find_one (name);
    if (found != nullptr)
        return found;
    SharedState::Access state (this->m_state);
    for (auto iter : state->children)
    {
        found = iter.source().find_one_deep (name);
        if (found != nullptr)
            return found;
    }
    return nullptr;
}

PropertyStream::Source* PropertyStream::Source::find_path (std::string path)
{
    if (path.empty())
        return this;
    Source* source (this);
    do
    {
        std::string const name (peel_name (&path));
        if(name.empty ())
            break;
        source = source->find_one(name);
    }
    while (source != nullptr); 
    return source;
}

// This function only looks at immediate children
// If no immediate children match, then return nullptr
PropertyStream::Source* PropertyStream::Source::find_one (std::string const& name)
{
    SharedState::Access state (this->m_state);
    for (auto iter : state->children)
    {
        if (iter.source().m_name == name)
            return &iter.source();
    }
    return nullptr;
}

void PropertyStream::Source::onWrite (Map&)
{
}

//------------------------------------------------------------------------------

void PropertyStream::Source::remove (
    SharedState::Access& state, SharedState::Access& childState)
{
    bassert (childState->parent == this);
    state->children.erase (
        state->children.iterator_to (
            childState->item));
    childState->parent = nullptr;
}

void PropertyStream::Source::removeAll (SharedState::Access& state)
{
    for (List <Item>::iterator iter (state->children.begin());
        iter != state->children.end();)
    {
        SharedState::Access childState ((*iter)->m_state);
        remove (state, childState);
    }
}

//------------------------------------------------------------------------------
//
// PropertyStream
//
//------------------------------------------------------------------------------

PropertyStream::PropertyStream ()
{
}

PropertyStream::~PropertyStream ()
{
}

void PropertyStream::add (std::string const& key, int32 value)
{
    lexical_add (key, value);
}

void PropertyStream::add (std::string const& key, uint32 value)
{
    lexical_add (key, value);
}

void PropertyStream::add (std::string const& key, int64 value)
{
    if (value <= std::numeric_limits <int32>::max() &&
        value >= std::numeric_limits <int32>::min())
    {
        add (key, int32(value));
    }
    else
    {
        lexical_add(key, value);
    }
}

void PropertyStream::add (std::string const& key, double value)
{
    lexical_add (key, value);
}

void PropertyStream::add (std::string const& key, uint64 value)
{
    if (value <= std::numeric_limits <uint32>::max() &&
        value >= std::numeric_limits <uint32>::min())
    {
        add (key, uint32(value));
    }
    else
    {
        lexical_add (key, value);
    }
}

void PropertyStream::add (int32 value)
{
    lexical_add (value);
}

void PropertyStream::add (uint32 value)
{
    lexical_add (value);
}

void PropertyStream::add (int64 value)
{
    if (value <= std::numeric_limits <int32>::max() &&
        value >= std::numeric_limits <int32>::min())
    {
        add (int32(value));
    }
    else
    {
        lexical_add (value);
    }
}

void PropertyStream::add (uint64 value)
{
    if (value <= std::numeric_limits <uint32>::max() &&
        value >= std::numeric_limits <uint32>::min())
    {
        add (uint32(value));
    }
    else
    {
        lexical_add (value);
    }
}

//------------------------------------------------------------------------------

class PropertyStreamTests : public UnitTest
{
public:
    typedef PropertyStream::Source Source;

    void test_peel_name (std::string s, std::string const& expected,
        std::string const& expected_remainder)
    {
        try
        {
            std::string const peeled_name = Source::peel_name (&s);
            expect (peeled_name == expected);
            expect (s == expected_remainder);
        }
        catch (...)
        {
            failException ();
        }
    }

    void test_peel_leading_slash (std::string s, std::string const& expected,
        bool should_be_found)
    {
        try
        {
            bool const found (Source::peel_leading_slash (&s));
            expect (found == should_be_found);
            expect (s == expected);
        }
        catch(...)
        {
            failException ();
        }
    }

    void test_peel_trailing_slashstar (std::string s, 
        std::string const& expected_remainder, bool should_be_found)
    {
        try
        {
            bool const found (Source::peel_trailing_slashstar (&s));
            expect (found == should_be_found);
            expect (s == expected_remainder);
        }
        catch (...)
        {
            failException ();
        }  
    }

    void test_find_one (Source& root, Source* expected, std::string const& name)
    {
        try
        {
            Source* source (root.find_one (name));
            expect (source == expected);
        }
        catch (...)
        {
            failException ();
        }
    }

    void test_find_path (Source& root, std::string const& path,
        Source* expected)
    {
        try
        {
            Source* source (root.find_path (path));
            expect (source == expected);
        }
        catch (...)
        {
            failException ();
        }
    }

    void test_find_one_deep (Source& root, std::string const& name,
        Source* expected)
    {
        try
        {
            Source* source (root.find_one_deep (name));
            expect (source == expected);
        }
        catch(...)
        {
            failException ();
        }
    }

    void test_find (Source& root, std::string path, Source* expected, 
        bool expected_star)
    {
        try
        {
            auto const result (root.find (path));
            expect (result.first == expected);
            expect (result.second == expected_star);
        }
        catch (...)
        {
            failException ();
        }
    }

    void runTest()
    {
        Source a ("a");
        Source b ("b");
        Source c ("c");
        Source d ("d");
        Source e ("e");
        Source f ("f");
        Source g ("g");

        //
        // a { b { d { f }, e }, c { g } }
        //

        a.add ( b );
        a.add ( c );
        c.add ( g );
        b.add ( d );
        b.add ( e );
        d.add ( f );

        beginTestCase ("peel_name");
        test_peel_name ("a", "a", "");
        test_peel_name ("foo/bar", "foo", "bar");
        test_peel_name ("foo/goo/bar", "foo", "goo/bar");
        test_peel_name ("", "", "");

        beginTestCase ("peel_leading_slash");
        test_peel_leading_slash ("foo/", "foo/", false);
        test_peel_leading_slash ("foo", "foo", false);
        test_peel_leading_slash ("/foo/", "foo/", true);
        test_peel_leading_slash ("/foo", "foo", true);

        beginTestCase ("peel_trailing_slashstar");
        test_peel_trailing_slashstar ("/foo/goo/*", "/foo/goo", true);
        test_peel_trailing_slashstar ("foo/goo/*", "foo/goo", true);
        test_peel_trailing_slashstar ("/foo/goo/", "/foo/goo", false);
        test_peel_trailing_slashstar ("foo/goo", "foo/goo", false);
        test_peel_trailing_slashstar ("", "", false);
        test_peel_trailing_slashstar ("/", "", false);
        test_peel_trailing_slashstar ("/*", "", true);
        test_peel_trailing_slashstar ("//", "/", false);
        test_peel_trailing_slashstar ("**", "*", true);
        test_peel_trailing_slashstar ("*/", "*", false);

        beginTestCase ("find_one");
        test_find_one (a, &b, "b");
        test_find_one (a, nullptr, "d");
        test_find_one (b, &e, "e");
        test_find_one (d, &f, "f");

        beginTestCase ("find_path");
        test_find_path (a, "a", nullptr); 
        test_find_path (a, "e", nullptr); 
        test_find_path (a, "a/b", nullptr);
        test_find_path (a, "a/b/e", nullptr);
        test_find_path (a, "b/e/g", nullptr);
        test_find_path (a, "b/e/f", nullptr);
        test_find_path (a, "b", &b);
        test_find_path (a, "b/e", &e);
        test_find_path (a, "b/d/f", &f);
        
        beginTestCase ("find_one_deep");
        test_find_one_deep (a, "z", nullptr);
        test_find_one_deep (a, "g", &g);
        test_find_one_deep (a, "b", &b);
        test_find_one_deep (a, "d", &d);
        test_find_one_deep (a, "f", &f);

        beginTestCase ("find");
        test_find (a, "",     &a, false);
        test_find (a, "*",    &a, true);
        test_find (a, "/b",   &b, false);
        test_find (a, "b",    &b, false);
        test_find (a, "d",    &d, false);
        test_find (a, "/b*",  &b, true);
        test_find (a, "b*",   &b, true);
        test_find (a, "d*",   &d, true);
        test_find (a, "/b/*", &b, true);
        test_find (a, "b/*",  &b, true);
        test_find (a, "d/*",  &d, true);
        test_find (a, "a",    nullptr, false);
        test_find (a, "/d",   nullptr, false);
        test_find (a, "/d*",  nullptr, true);
        test_find (a, "/d/*", nullptr, true);
    }

    PropertyStreamTests () 
        : UnitTest ("PropertyStream", "beast")
    {
    }
};

static PropertyStreamTests propertyStreamTests;

}