1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148
use core::fmt;
use crate::{
condition::{
equal, greater_than, greater_than_or_equal, less_than, less_than_or_equal, not_equal,
Between, Comparison, In,
},
operand::Operand,
path::Path,
};
/// The [DynamoDB `size` function][1]. Returns a number representing an attributes size.
///
/// See also: [Path::size]
///
/// [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Size {
// `Path` is correct here
// https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Syntax
pub(crate) path: Path,
}
impl Size {
/// Check if the value of this operand is equal to the given value.
///
/// [DynamoDB documentation.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators)
pub fn equal<T>(self, right: T) -> Comparison
where
T: Into<Operand>,
{
equal(self, right)
}
/// Check if the value of this operand is not equal to the given value.
///
/// [DynamoDB documentation.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators)
pub fn not_equal<T>(self, right: T) -> Comparison
where
T: Into<Operand>,
{
not_equal(self, right)
}
/// Check if the value of this operand is greater than the given value.
///
/// [DynamoDB documentation.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators)
pub fn greater_than<T>(self, right: T) -> Comparison
where
T: Into<Operand>,
{
greater_than(self, right)
}
/// Check if the value of this operand is greater than or equal to the given value.
///
/// [DynamoDB documentation.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators)
pub fn greater_than_or_equal<T>(self, right: T) -> Comparison
where
T: Into<Operand>,
{
greater_than_or_equal(self, right)
}
/// Check if the value of this operand is less than the given value.
///
/// [DynamoDB documentation.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators)
pub fn less_than<T>(self, right: T) -> Comparison
where
T: Into<Operand>,
{
less_than(self, right)
}
/// Check if the value of this operand is less than or equal to the given value.
///
/// [DynamoDB documentation.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators)
pub fn less_than_or_equal<T>(self, right: T) -> Comparison
where
T: Into<Operand>,
{
less_than_or_equal(self, right)
}
/// The [DynamoDB `BETWEEN` operator][1]. True if `self` is greater than or
/// equal to `lower`, and less than or equal to `upper`.
///
/// ```
/// use dynamodb_expression::{Num, Path};
/// # use pretty_assertions::assert_eq;
///
/// let condition = Path::new_name("foo").size().between(Num::new(512), Num::new(1024));
/// assert_eq!(r#"size(foo) BETWEEN 512 AND 1024"#, condition.to_string());
/// ```
///
/// See also: [`Key::between`]
///
/// [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
/// [`Key::between`]: crate::key::Key::between
pub fn between<L, U>(self, lower: L, upper: U) -> Between
where
L: Into<Operand>,
U: Into<Operand>,
{
Between {
op: self.into(),
lower: lower.into(),
upper: upper.into(),
}
}
/// A [DynamoDB `IN` operation][1]. True if the value at this [`Path`] is equal
/// to any value in the list.
///
/// The list can contain up to 100 values. It must have at least 1.
///
/// ```
/// use dynamodb_expression::{Num, Path};
/// # use pretty_assertions::assert_eq;
///
/// let condition = Path::new_name("foo").size().in_([10, 20, 30, 40, 50].map(Num::new));
/// assert_eq!(r#"size(foo) IN (10,20,30,40,50)"#, condition.to_string());
/// ```
///
/// [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
pub fn in_<I, T>(self, items: I) -> In
where
I: IntoIterator<Item = T>,
T: Into<Operand>,
{
In::new(self, items)
}
}
impl fmt::Display for Size {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(f, "size({})", self.path)
}
}
impl<T> From<T> for Size
where
T: Into<Path>,
{
fn from(path: T) -> Self {
Self { path: path.into() }
}
}