quasardb 3.14.2.dev3__cp310-cp310-macosx_11_0_arm64.whl → 3.14.2.dev5__cp310-cp310-macosx_11_0_arm64.whl

quasardb/convert.hpp

@@ -1,38 +0,0 @@
-/*
- *
- * Official Python API
- *
- * Copyright (c) 2009-2024, quasardb SAS. All rights reserved.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *    * Redistributions of source code must retain the above copyright
- *      notice, this list of conditions and the following disclaimer.
- *    * Redistributions in binary form must reproduce the above copyright
- *      notice, this list of conditions and the following disclaimer in the
- *      documentation and/or other materials provided with the distribution.
- *    * Neither the name of quasardb nor the names of its contributors may
- *      be used to endorse or promote products derived from this software
- *      without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY QUASARDB AND CONTRIBUTORS ``AS IS'' AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
- * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
- * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-#pragma once
-
-// Convenience include, includes $everything
-
-#include "convert/array.hpp"
-#include "convert/point.hpp"
-#include "convert/range.hpp"
-#include "convert/value.hpp"

quasardb/detail/qdb_resource.hpp

@@ -1,129 +0,0 @@
-/*
- *
- * Official Python API
- *
- * Copyright (c) 2009-2024, quasardb SAS. All rights reserved.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *    * Redistributions of source code must retain the above copyright
- *      notice, this list of conditions and the following disclaimer.
- *    * Redistributions in binary form must reproduce the above copyright
- *      notice, this list of conditions and the following disclaimer in the
- *      documentation and/or other materials provided with the distribution.
- *    * Neither the name of quasardb nor the names of its contributors may
- *      be used to endorse or promote products derived from this software
- *      without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY QUASARDB AND CONTRIBUTORS ``AS IS'' AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
- * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
- * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-#pragma once
-
-#include <qdb/client.h> // for qdb_handle_t
-
-namespace qdb
-{
-
-namespace detail
-{
-
-/**
- * Resource guard for QDB-native allocated resources. Automatically invokes
- * qdb_release() when the guard goes out of scope.
- */
-template <typename ValueType>
-class qdb_resource
-{
-public:
-    /**
-     * Default constructor, initializes nullpointer.
-     */
-    qdb_resource(qdb_handle_t h)
-        : qdb_resource(h, nullptr)
-    {}
-
-    /**
-     * Constructor and immediately initialize with pointer.
-     */
-    qdb_resource(qdb_handle_t h, ValueType * p)
-        : h_(h)
-        , p_(p)
-    {}
-
-    qdb_resource(qdb_resource const &)             = delete;
-    qdb_resource & operator=(qdb_resource const &) = delete;
-
-    ~qdb_resource()
-    {
-        if (p_ != nullptr)
-        {
-            qdb_release(h_, p_);
-        }
-
-        p_ = nullptr;
-    }
-
-    constexpr operator ValueType *() const
-    {
-        return get();
-    }
-
-    operator ValueType *()
-    {
-        return get();
-    }
-
-    ValueType * get()
-    {
-        return p_;
-    }
-
-    constexpr ValueType const * get() const
-    {
-        return p_;
-    }
-
-    ValueType ** operator&()
-    {
-        return &p_;
-    }
-
-    ValueType & operator*()
-    {
-        return *p_;
-    }
-
-    ValueType * operator->()
-    {
-        return p_;
-    }
-
-    constexpr ValueType const * operator->() const
-    {
-        return p_;
-    }
-
-    constexpr ValueType const & operator*() const
-    {
-        return *p_;
-    }
-
-private:
-    qdb_handle_t h_;
-    ValueType * p_;
-};
-
-} // namespace detail
-
-} // namespace qdb

quasardb/detail/retry.cpp

@@ -1,30 +0,0 @@
-#include "retry.hpp"
-#include <pybind11/chrono.h>
-
-namespace qdb::detail
-{
-
-void register_retry_options(py::module_ & m)
-{
-    namespace py = pybind11;
-
-    py::class_<retry_options>{m, "RetryOptions"}                                      //
-        .def(py::init<std::size_t, std::chrono::milliseconds, std::size_t, double>(), //
-            py::arg("retries") = std::size_t{3},                                      //
-            py::kw_only(),                                                            //
-            py::arg("delay")    = std::chrono::milliseconds{3000},                    //
-            py::arg("exponent") = std::size_t{2},                                     //
-            py::arg("jitter")   = double{0.1}                                         //
-            )                                                                         //
-                                                                                      //
-        .def_readwrite("retries_left", &retry_options::retries_left)                  //
-        .def_readwrite("delay", &retry_options::delay)                                //
-        .def_readwrite("exponent", &retry_options::exponent)                          //
-        .def_readwrite("jitter", &retry_options::jitter)                              //
-                                                                                      //
-        .def("has_next", &retry_options::has_next)                                    //
-        .def("next", &retry_options::next)                                            //
-        ;
-}
-
-}; // namespace qdb::detail

quasardb/detail/retry.hpp

@@ -1,147 +0,0 @@
-/*
- *
- * Official Python API
- *
- * Copyright (c) 2009-2021, quasardb SAS. All rights reserved.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *    * Redistributions of source code must retain the above copyright
- *      notice, this list of conditions and the following disclaimer.
- *    * Redistributions in binary form must reproduce the above copyright
- *      notice, this list of conditions and the following disclaimer in the
- *      documentation and/or other materials provided with the distribution.
- *    * Neither the name of quasardb nor the names of its contributors may
- *      be used to endorse or promote products derived from this software
- *      without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY QUASARDB AND CONTRIBUTORS ``AS IS'' AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
- * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
- * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-#pragma once
-
-#include "../error.hpp"
-#include <chrono>
-
-namespace qdb::detail
-{
-
-struct retry_options
-{
-    qdb::logger logger_;
-
-    // how many retries are left. 0 means no retries
-    std::size_t retries_left;
-
-    // delay for the next retry
-    std::chrono::milliseconds delay;
-
-    // factor by which delay is increased every retry
-    std::size_t exponent;
-
-    // random jitter added/removed to delay_. Jitter of 0.1 means that 10% is automatically
-    // added or removed from delay_
-    double jitter;
-
-    /**
-     * Retry options constructor
-     */
-    retry_options(std::size_t retries   = 3,
-        std::chrono::milliseconds delay = std::chrono::milliseconds{3000},
-        std::size_t exponent            = 2,
-        double jitter                   = 0.1)
-        : logger_("quasardb.detail.retry")
-        , retries_left{retries}
-        , delay{delay}
-        , exponent{exponent}
-        , jitter{jitter}
-    {}
-
-    static inline retry_options from_kwargs(py::kwargs args)
-    {
-        if (args.contains("retries") == false)
-        {
-            return {};
-        }
-
-        auto retries = args["retries"];
-
-        // We're going to assume that retries is an actual RetryOptions class, because
-        // our Numpy and Pandas adapters always coerce it to that type. By making this
-        // assumption, we can slightly optimize this code path.
-        //
-        // By providing an explicit RetryOptions object is also the only way to fine-tune
-        // other parameters.
-
-        try
-        {
-            return retries.cast<retry_options>();
-        }
-        catch (py::cast_error const & /*e*/)
-        {
-            // For convenience, we also give the user the choice to just provide `retries`
-            // as an integer, in which case we'll assume this is the number of retries the
-            // user wants to perform.
-            //
-            // In all likelihood, this is the only parameter the user will want to tune.
-            return {retries.cast<std::size_t>()};
-        }
-    }
-
-    inline constexpr bool has_next() const noexcept
-    {
-        return retries_left > 0;
-    }
-
-    /**
-     * Returns new object, with `retries_left_` and `delay_` adjusted accordingly.
-     */
-    inline retry_options next() const
-    {
-        if (has_next() == false) [[unlikely]]
-        {
-            throw qdb::out_of_bounds_exception{
-                "RetryOptions.next() called but retries already exhausted."};
-        }
-
-        assert(has_next() == true);
-
-        return retry_options{retries_left - 1, delay * exponent, exponent, jitter};
-    }
-
-    /**
-     * Returns true if we have retries left and the error is retryable.
-     */
-    inline constexpr bool should_retry(qdb_error_t e) const noexcept
-    {
-        // We check for `is_retryable` first, because in all likelihood e is qdb_e_ok
-        return retry_options::is_retryable(e) && has_next();
-    }
-
-    static constexpr bool is_retryable(qdb_error_t e) noexcept
-    {
-        switch (e)
-        {
-        case qdb_e_async_pipe_full:
-        case qdb_e_try_again:
-            return true;
-            break;
-        default:
-            return false;
-        };
-    }
-};
-
-void register_retry_options(py::module_ & m);
-
-}; // namespace qdb::detail

quasardb/detail/sleep.hpp

@@ -1,53 +0,0 @@
-/*
- *
- * Official Python API
- *
- * Copyright (c) 2009-2021, quasardb SAS. All rights reserved.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *    * Redistributions of source code must retain the above copyright
- *      notice, this list of conditions and the following disclaimer.
- *    * Redistributions in binary form must reproduce the above copyright
- *      notice, this list of conditions and the following disclaimer in the
- *      documentation and/or other materials provided with the distribution.
- *    * Neither the name of quasardb nor the names of its contributors may
- *      be used to endorse or promote products derived from this software
- *      without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY QUASARDB AND CONTRIBUTORS ``AS IS'' AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
- * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
- * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-#pragma once
-
-#include "../concepts.hpp"
-#include <chrono>
-
-namespace qdb::detail
-{
-
-template <typename Duration = std::chrono::milliseconds>
-struct default_sleep_strategy
-{
-    using duration_t = Duration;
-
-    static void sleep(duration_t const & delay)
-    {
-        std::this_thread::sleep_for(delay);
-    };
-};
-
-static_assert(qdb::concepts::sleep_strategy<default_sleep_strategy<>>);
-static_assert(qdb::concepts::sleep_strategy<default_sleep_strategy<std::chrono::seconds>>);
-
-}; // namespace qdb::detail

quasardb/detail/ts_column.hpp

@@ -1,224 +0,0 @@
-/*
- *
- * Official Python API
- *
- * Copyright (c) 2009-2024, quasardb SAS. All rights reserved.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *    * Redistributions of source code must retain the above copyright
- *      notice, this list of conditions and the following disclaimer.
- *    * Redistributions in binary form must reproduce the above copyright
- *      notice, this list of conditions and the following disclaimer in the
- *      documentation and/or other materials provided with the distribution.
- *    * Neither the name of quasardb nor the names of its contributors may
- *      be used to endorse or promote products derived from this software
- *      without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY QUASARDB AND CONTRIBUTORS ``AS IS'' AND ANY
- * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
- * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
- * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-#pragma once
-
-#include "../error.hpp"
-#include <qdb/ts.h>
-#include <cassert>
-#include <string>
-
-namespace qdb
-{
-
-namespace detail
-{
-
-inline std::string type_to_string(qdb_ts_column_type_t t)
-{
-    switch (t)
-    {
-    case qdb_ts_column_double:
-        return "double";
-    case qdb_ts_column_blob:
-        return "blob";
-    case qdb_ts_column_int64:
-        return "int64";
-    case qdb_ts_column_timestamp:
-        return "timestamp";
-    case qdb_ts_column_string:
-        return "string";
-    case qdb_ts_column_symbol:
-        return "symbol";
-    default:
-        return "uninitialized";
-    }
-}
-
-struct column_info
-{
-    column_info() = default;
-
-    explicit column_info(qdb_ts_column_type_t t, const std::string & n)
-        : column_info{t, n, std::string{}}
-    {}
-
-    explicit column_info(qdb_ts_column_type_t t, const std::string & n, const std::string & s)
-        : type{t}
-        , name{n}
-        , symtable{s}
-    {
-        if (t == qdb_ts_column_symbol && s.empty()) [[unlikely]]
-        {
-            throw qdb::invalid_argument_exception{
-                "column '" + n + "' is a symbol but no symbol table provided"};
-        }
-        else if (t != qdb_ts_column_symbol && s.empty() == false) [[unlikely]]
-        {
-            throw qdb::invalid_argument_exception{
-                "column '" + n + "' is a not a symbol but symbol table provided: '" + s + "'"};
-        }
-    }
-
-    explicit column_info(const qdb_ts_column_info_t & ci)
-        : column_info{ci.type, ci.name, {}}
-    {}
-
-    explicit column_info(const qdb_ts_column_info_ex_t & ci)
-        : column_info{ci.type, ci.name, ci.symtable}
-    {}
-
-    std::string repr() const
-    {
-        return "<quasardb.ColumnInfo name='" + name + "' type='" + type_to_string(type) + "'>";
-    }
-
-    operator qdb_ts_column_info_t() const noexcept
-    {
-        qdb_ts_column_info_t res;
-
-        // WARNING(leon): we assume that the lifetime of `this` is longer
-        // than `res`, and that the string does not need to be deep-copied.
-        //
-        // In our current code, this is the case.
-        res.type = type;
-        res.name = name.c_str();
-
-        return res;
-    }
-
-    operator qdb_ts_column_info_ex_t() const noexcept
-    {
-        qdb_ts_column_info_ex_t res;
-
-        // WARNING(leon): we assume that the lifetime of `this` is longer
-        // than `res`, and that the string does not need to be deep-copied.
-        //
-        // In our current code, this is the case.
-        res.type     = type;
-        res.name     = name.c_str();
-        res.symtable = symtable.c_str();
-
-        return res;
-    }
-
-    qdb_ts_column_type_t type{qdb_ts_column_uninitialized};
-    std::string name;
-    std::string symtable;
-};
-
-static inline std::vector<qdb_ts_column_info_t> convert_columns(
-    const std::vector<column_info> & columns)
-{
-    std::vector<qdb_ts_column_info_t> res(columns.size());
-
-    std::transform(columns.cbegin(), columns.cend(), res.begin(),
-        [](const column_info & ci) -> qdb_ts_column_info_t { return ci; });
-
-    return res;
-}
-static inline std::vector<qdb_ts_column_info_ex_t> convert_columns_ex(
-    const std::vector<column_info> & columns)
-{
-    std::vector<qdb_ts_column_info_ex_t> res(columns.size());
-
-    std::transform(columns.cbegin(), columns.cend(), res.begin(),
-        [](const column_info & ci) -> qdb_ts_column_info_ex_t { return ci; });
-
-    return res;
-}
-
-static inline std::vector<column_info> convert_columns(
-    const qdb_ts_column_info_ex_t * columns, size_t count)
-{
-    std::vector<column_info> res(count);
-
-    std::transform(columns, columns + count, res.begin(),
-        [](const qdb_ts_column_info_ex_t & ci) { return column_info{ci}; });
-
-    return res;
-}
-
-struct indexed_column_info
-{
-    indexed_column_info() = default;
-
-    indexed_column_info(qdb_ts_column_type_t t, qdb_size_t i, const std::string & s = {})
-        : type{t}
-        , index{i}
-        , symtable{s}
-    {
-        assert((t != qdb_ts_column_symbol) == s.empty());
-    }
-
-    qdb_ts_column_type_t type{qdb_ts_column_uninitialized};
-    qdb_size_t index;
-    std::string symtable;
-};
-
-using indexed_columns_t = std::map<std::string, indexed_column_info>;
-
-template <typename ColumnType>
-static indexed_columns_t index_columns(const std::vector<ColumnType> & columns)
-{
-    indexed_columns_t i_columns;
-    for (qdb_size_t i = 0; i < columns.size(); ++i)
-    {
-        i_columns.insert(
-            indexed_columns_t::value_type(columns[i].name, {columns[i].type, i, columns[i].symtable}));
-    }
-
-    return i_columns;
-}
-
-template <typename Module>
-static inline void register_ts_column(Module & m)
-{
-    namespace py = pybind11;
-
-    py::class_<column_info>{m, "ColumnInfo"}                                             //
-        .def(py::init<qdb_ts_column_type_t, const std::string &>())                      //
-        .def(py::init<qdb_ts_column_type_t, const std::string &, const std::string &>()) //
-        .def("__repr__", &column_info::repr)
-        .def_readwrite("type", &column_info::type)          //
-        .def_readwrite("name", &column_info::name)          //
-        .def_readwrite("symtable", &column_info::symtable); //
-
-    py::class_<indexed_column_info>{m, "IndexedColumnInfo"}                     //
-        .def(py::init<qdb_ts_column_type_t, qdb_size_t>())                      //
-        .def(py::init<qdb_ts_column_type_t, qdb_size_t, const std::string &>()) //
-        .def_readonly("type", &indexed_column_info::type)                       //
-        .def_readonly("index", &indexed_column_info::index)                     //
-        .def_readonly("symtable", &indexed_column_info::symtable);              //
-}
-
-} // namespace detail
-
-} // namespace qdb