couchbase 3.5.1 → 3.5.2

data/ext/couchbase/couchbase/date_range.hxx

@@ -31,39 +31,41 @@ namespace couchbase
  */
 class date_range
 {
-  public:
-    date_range(std::string name, std::string start, std::string end);
-    date_range(std::string name, std::chrono::system_clock::time_point start, std::chrono::system_clock::time_point end);
-    date_range(std::string name, std::tm start, std::tm end);
+public:
+  date_range(std::string name, std::string start, std::string end);
+  date_range(std::string name,
+             std::chrono::system_clock::time_point start,
+             std::chrono::system_clock::time_point end);
+  date_range(std::string name, std::tm start, std::tm end);
 
-    static date_range with_start(std::string name, std::string start);
-    static date_range with_start(std::string name, std::chrono::system_clock::time_point start);
-    static date_range with_start(std::string name, std::tm start);
+  static date_range with_start(std::string name, std::string start);
+  static date_range with_start(std::string name, std::chrono::system_clock::time_point start);
+  static date_range with_start(std::string name, std::tm start);
 
-    static date_range with_end(std::string name, std::string end);
-    static date_range with_end(std::string name, std::chrono::system_clock::time_point end);
-    static date_range with_end(std::string name, std::tm end);
+  static date_range with_end(std::string name, std::string end);
+  static date_range with_end(std::string name, std::chrono::system_clock::time_point end);
+  static date_range with_end(std::string name, std::tm end);
 
-    [[nodiscard]] auto name() const -> const std::string&
-    {
-        return name_;
-    }
+  [[nodiscard]] auto name() const -> const std::string&
+  {
+    return name_;
+  }
 
-    [[nodiscard]] auto start() const -> const std::optional<std::string>&
-    {
-        return start_;
-    }
+  [[nodiscard]] auto start() const -> const std::optional<std::string>&
+  {
+    return start_;
+  }
 
-    [[nodiscard]] auto end() const -> const std::optional<std::string>&
-    {
-        return end_;
-    }
+  [[nodiscard]] auto end() const -> const std::optional<std::string>&
+  {
+    return end_;
+  }
 
-  private:
-    date_range(std::string name, std::optional<std::string> start, std::optional<std::string> end);
+private:
+  date_range(std::string name, std::optional<std::string> start, std::optional<std::string> end);
 
-    std::string name_;
-    std::optional<std::string> start_{};
-    std::optional<std::string> end_{};
+  std::string name_;
+  std::optional<std::string> start_{};
+  std::optional<std::string> end_{};
 };
 } // namespace couchbase

data/ext/couchbase/couchbase/date_range_facet.hxx

@@ -29,28 +29,28 @@ namespace couchbase
  */
 class date_range_facet : public search_facet
 {
-  public:
-    date_range_facet(std::string field, std::vector<date_range> ranges)
-      : search_facet{ std::move(field) }
-      , ranges_{ std::move(ranges) }
-    {
-    }
+public:
+  date_range_facet(std::string field, std::vector<date_range> ranges)
+    : search_facet{ std::move(field) }
+    , ranges_{ std::move(ranges) }
+  {
+  }
 
-    date_range_facet(std::string field, std::uint32_t size, std::vector<date_range> ranges)
-      : search_facet{ std::move(field), size }
-      , ranges_{ std::move(ranges) }
-    {
-    }
+  date_range_facet(std::string field, std::uint32_t size, std::vector<date_range> ranges)
+    : search_facet{ std::move(field), size }
+    , ranges_{ std::move(ranges) }
+  {
+  }
 
-    /**
-     * @return encoded representation of the search facet.
-     *
-     * @since 1.0.0
-     * @internal
-     */
-    [[nodiscard]] auto encode() const -> encoded_search_facet override;
+  /**
+   * @return encoded representation of the search facet.
+   *
+   * @since 1.0.0
+   * @internal
+   */
+  [[nodiscard]] auto encode() const -> encoded_search_facet override;
 
-  private:
-    std::vector<date_range> ranges_;
+private:
+  std::vector<date_range> ranges_;
 };
 } // namespace couchbase

data/ext/couchbase/couchbase/date_range_facet_result.hxx

@@ -35,21 +35,21 @@ class internal_date_range_facet_result;
  */
 class date_range_facet_result : public search_facet_result
 {
-  public:
-    /**
-     * @since 1.0.0
-     * @internal
-     */
-    explicit date_range_facet_result(internal_date_range_facet_result internal);
+public:
+  /**
+   * @since 1.0.0
+   * @internal
+   */
+  explicit date_range_facet_result(internal_date_range_facet_result internal);
 
-    [[nodiscard]] auto name() const -> const std::string& override;
-    [[nodiscard]] auto field() const -> const std::string& override;
-    [[nodiscard]] auto total() const -> std::uint64_t override;
-    [[nodiscard]] auto missing() const -> std::uint64_t override;
-    [[nodiscard]] auto other() const -> std::uint64_t override;
-    [[nodiscard]] auto date_ranges() const -> const std::vector<search_date_range>&;
+  [[nodiscard]] auto name() const -> const std::string& override;
+  [[nodiscard]] auto field() const -> const std::string& override;
+  [[nodiscard]] auto total() const -> std::uint64_t override;
+  [[nodiscard]] auto missing() const -> std::uint64_t override;
+  [[nodiscard]] auto other() const -> std::uint64_t override;
+  [[nodiscard]] auto date_ranges() const -> const std::vector<search_date_range>&;
 
-  private:
-    std::unique_ptr<internal_date_range_facet_result> internal_;
+private:
+  std::unique_ptr<internal_date_range_facet_result> internal_;
 };
 } // namespace couchbase

data/ext/couchbase/couchbase/date_range_query.hxx

@@ -29,237 +29,251 @@
 namespace couchbase
 {
 /**
- * The date range query finds documents containing a date value in the specified field within the specified range. Either start or end can
- * be omitted, but not both.
+ * The date range query finds documents containing a date value in the specified field within the
+ * specified range. Either start or end can be omitted, but not both.
  *
- * Match documents where field `review_date` falls within the range ("2001-10-09T10:20:30-08:00", "2016-10-31")
+ * Match documents where field `review_date` falls within the range ("2001-10-09T10:20:30-08:00",
+ * "2016-10-31")
  * @snippet test_unit_search.cxx search-date-range
  *
  * It also works with `std::tm` and `std::chrono::system_clock::time_point`.
  * @snippet test_unit_search.cxx search-date-range-tm
  *
- * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-date-range.html server documentation.
+ * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-date-range.html server
+ * documentation.
  *
  * @since 1.0.0
  * @committed
  */
 class date_range_query : public search_query
 {
-  public:
-    /**
-     * Set lower limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value  start limit time point
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto start(std::chrono::system_clock::time_point value) -> date_range_query&;
+public:
+  /**
+   * Set lower limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value  start limit time point
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto start(std::chrono::system_clock::time_point value) -> date_range_query&;
 
-    /**
-     * Set lower limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value start limit as a `tm` (broken down timestamp)
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto start(std::tm value) -> date_range_query&;
+  /**
+   * Set lower limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value start limit as a `tm` (broken down timestamp)
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto start(std::tm value) -> date_range_query&;
 
-    /**
-     * Set lower limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value  start limit time point
-     * @param inclusive whether to include limit value into the interval.
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto start(std::chrono::system_clock::time_point value, bool inclusive) -> date_range_query&;
+  /**
+   * Set lower limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value  start limit time point
+   * @param inclusive whether to include limit value into the interval.
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto start(std::chrono::system_clock::time_point value, bool inclusive) -> date_range_query&;
 
-    /**
-     * Set lower limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value start limit as a `tm` (broken down timestamp)
-     * @param inclusive whether to include limit value into the interval.
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto start(std::tm value, bool inclusive) -> date_range_query&;
+  /**
+   * Set lower limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value start limit as a `tm` (broken down timestamp)
+   * @param inclusive whether to include limit value into the interval.
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto start(std::tm value, bool inclusive) -> date_range_query&;
 
-    /**
-     * Set preformatted date as lower limit.
-     *
-     * @param value  start limit formatted as a string, use @ref date_time_parser() for non-standard formats
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto start(std::string value) -> date_range_query&
-    {
-        start_ = std::move(value);
-        return *this;
-    }
+  /**
+   * Set preformatted date as lower limit.
+   *
+   * @param value  start limit formatted as a string, use @ref date_time_parser() for non-standard
+   * formats
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto start(std::string value) -> date_range_query&
+  {
+    start_ = std::move(value);
+    return *this;
+  }
 
-    /**
-     * Set preformatted date as lower limit.
-     *
-     * @param value  start limit formatted as a string, use @ref date_time_parser() for non-standard formats
-     * @param inclusive whether to include limit value into the interval.
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto start(std::string value, bool inclusive) -> date_range_query&
-    {
-        start_ = std::move(value);
-        inclusive_start_ = inclusive;
-        return *this;
-    }
+  /**
+   * Set preformatted date as lower limit.
+   *
+   * @param value  start limit formatted as a string, use @ref date_time_parser() for non-standard
+   * formats
+   * @param inclusive whether to include limit value into the interval.
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto start(std::string value, bool inclusive) -> date_range_query&
+  {
+    start_ = std::move(value);
+    inclusive_start_ = inclusive;
+    return *this;
+  }
 
-    /**
-     * Set upper limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value  end limit time point
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto end(std::chrono::system_clock::time_point value) -> date_range_query&;
+  /**
+   * Set upper limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value  end limit time point
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto end(std::chrono::system_clock::time_point value) -> date_range_query&;
 
-    /**
-     * Set upper limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value end limit as a `tm` (broken down timestamp)
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto end(std::tm value) -> date_range_query&;
+  /**
+   * Set upper limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value end limit as a `tm` (broken down timestamp)
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto end(std::tm value) -> date_range_query&;
 
-    /**
-     * Set upper limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value  end limit time point
-     * @param inclusive whether to include limit value into the interval.
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto end(std::chrono::system_clock::time_point value, bool inclusive) -> date_range_query&;
+  /**
+   * Set upper limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value  end limit time point
+   * @param inclusive whether to include limit value into the interval.
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto end(std::chrono::system_clock::time_point value, bool inclusive) -> date_range_query&;
 
-    /**
-     * Set upper limit and automatically format so that default date_time parser will be able to parse it on the server.
-     *
-     * @param value end limit as a `tm` (broken down timestamp)
-     * @param inclusive whether to include limit value into the interval.
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto end(std::tm value, bool inclusive) -> date_range_query&;
+  /**
+   * Set upper limit and automatically format so that default date_time parser will be able to parse
+   * it on the server.
+   *
+   * @param value end limit as a `tm` (broken down timestamp)
+   * @param inclusive whether to include limit value into the interval.
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto end(std::tm value, bool inclusive) -> date_range_query&;
 
-    /**
-     * Set preformatted date as upper limit.
-     *
-     * @param value  end limit formatted as a string, use @ref date_time_parser() for non-standard formats
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto end(std::string value)
-    {
-        end_ = std::move(value);
-        return *this;
-    }
+  /**
+   * Set preformatted date as upper limit.
+   *
+   * @param value  end limit formatted as a string, use @ref date_time_parser() for non-standard
+   * formats
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto end(std::string value)
+  {
+    end_ = std::move(value);
+    return *this;
+  }
 
-    /**
-     * Set preformatted date as upper limit.
-     *
-     * @param value  end limit formatted as a string, use @ref date_time_parser() for non-standard formats
-     * @param inclusive whether to include limit value into the interval.
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto end(std::string value, bool inclusive) -> date_range_query&
-    {
-        end_ = std::move(value);
-        inclusive_end_ = inclusive;
-        return *this;
-    }
+  /**
+   * Set preformatted date as upper limit.
+   *
+   * @param value  end limit formatted as a string, use @ref date_time_parser() for non-standard
+   * formats
+   * @param inclusive whether to include limit value into the interval.
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto end(std::string value, bool inclusive) -> date_range_query&
+  {
+    end_ = std::move(value);
+    inclusive_end_ = inclusive;
+    return *this;
+  }
 
-    /**
-     * Enable custom date parser.
-     *
-     * @param parser_name name of the custom date parser
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto date_time_parser(std::string parser_name) -> date_range_query&
-    {
-        date_time_parser_ = std::move(parser_name);
-        return *this;
-    }
+  /**
+   * Enable custom date parser.
+   *
+   * @param parser_name name of the custom date parser
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto date_time_parser(std::string parser_name) -> date_range_query&
+  {
+    date_time_parser_ = std::move(parser_name);
+    return *this;
+  }
 
-    /**
-     * If a field is specified, only terms in that field will be matched.
-     *
-     * @param field_name name of the field to be matched
-     *
-     * @return this query for chaining purposes.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    auto field(std::string field_name) -> date_range_query&
-    {
-        field_ = std::move(field_name);
-        return *this;
-    }
+  /**
+   * If a field is specified, only terms in that field will be matched.
+   *
+   * @param field_name name of the field to be matched
+   *
+   * @return this query for chaining purposes.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  auto field(std::string field_name) -> date_range_query&
+  {
+    field_ = std::move(field_name);
+    return *this;
+  }
 
-    /**
-     * @return encoded representation of the query.
-     *
-     * @since 1.0.0
-     * @internal
-     */
-    [[nodiscard]] auto encode() const -> encoded_search_query override;
+  /**
+   * @return encoded representation of the query.
+   *
+   * @since 1.0.0
+   * @internal
+   */
+  [[nodiscard]] auto encode() const -> encoded_search_query override;
 
-  private:
-    std::optional<std::string> start_{};
-    std::optional<std::string> end_{};
-    std::optional<bool> inclusive_start_{};
-    std::optional<bool> inclusive_end_{};
-    std::optional<std::string> date_time_parser_{};
-    std::optional<std::string> field_{};
+private:
+  std::optional<std::string> start_{};
+  std::optional<std::string> end_{};
+  std::optional<bool> inclusive_start_{};
+  std::optional<bool> inclusive_end_{};
+  std::optional<std::string> date_time_parser_{};
+  std::optional<std::string> field_{};
 };
 } // namespace couchbase