Skip to main content

reifydb_value/value/container/
temporal.rs

1// SPDX-License-Identifier: Apache-2.0
2// Copyright (c) 2026 ReifyDB
3
4use std::{
5	fmt::{self, Debug},
6	ops::Deref,
7	result::Result as StdResult,
8};
9
10use serde::{Deserialize, Deserializer, Serialize, Serializer};
11
12use crate::{
13	Result,
14	util::bitvec::BitVec,
15	value::{Value, is::IsTemporal},
16};
17
18pub struct TemporalContainer<T>
19where
20	T: IsTemporal,
21{
22	data: Vec<T>,
23}
24
25impl<T: IsTemporal> Clone for TemporalContainer<T> {
26	fn clone(&self) -> Self {
27		Self {
28			data: self.data.clone(),
29		}
30	}
31}
32
33impl<T: IsTemporal + Debug> Debug for TemporalContainer<T> {
34	fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
35		f.debug_struct("TemporalContainer").field("data", &self.data).finish()
36	}
37}
38
39impl<T: IsTemporal> PartialEq for TemporalContainer<T> {
40	fn eq(&self, other: &Self) -> bool {
41		self.data == other.data
42	}
43}
44
45impl<T: IsTemporal + Serialize> Serialize for TemporalContainer<T> {
46	fn serialize<Ser: Serializer>(&self, serializer: Ser) -> StdResult<Ser::Ok, Ser::Error> {
47		#[derive(Serialize)]
48		struct Helper<'a, T: Clone + PartialEq + Serialize> {
49			data: &'a Vec<T>,
50		}
51		Helper {
52			data: &self.data,
53		}
54		.serialize(serializer)
55	}
56}
57
58impl<'de, T: IsTemporal + Deserialize<'de>> Deserialize<'de> for TemporalContainer<T> {
59	fn deserialize<D: Deserializer<'de>>(deserializer: D) -> StdResult<Self, D::Error> {
60		#[derive(Deserialize)]
61		struct Helper<T: Clone + PartialEq> {
62			data: Vec<T>,
63		}
64		let h = Helper::deserialize(deserializer)?;
65		Ok(TemporalContainer {
66			data: h.data,
67		})
68	}
69}
70
71impl<T: IsTemporal> Deref for TemporalContainer<T> {
72	type Target = [T];
73
74	fn deref(&self) -> &Self::Target {
75		self.data.as_slice()
76	}
77}
78
79impl<T> TemporalContainer<T>
80where
81	T: IsTemporal + Clone + Debug + Default,
82{
83	pub fn new(data: Vec<T>) -> Self {
84		Self {
85			data,
86		}
87	}
88
89	pub fn with_capacity(capacity: usize) -> Self {
90		Self {
91			data: Vec::with_capacity(capacity),
92		}
93	}
94
95	pub fn from_vec(data: Vec<T>) -> Self {
96		Self {
97			data,
98		}
99	}
100}
101
102impl<T> TemporalContainer<T>
103where
104	T: IsTemporal + Clone + Debug + Default,
105{
106	pub fn from_parts(data: Vec<T>) -> Self {
107		Self {
108			data,
109		}
110	}
111
112	pub fn len(&self) -> usize {
113		self.data.len()
114	}
115
116	pub fn capacity(&self) -> usize {
117		self.data.capacity()
118	}
119
120	pub fn heap_size(&self) -> usize {
121		self.capacity() * size_of::<T>()
122	}
123
124	pub fn is_empty(&self) -> bool {
125		self.data.is_empty()
126	}
127
128	pub fn clear(&mut self) {
129		self.data.clear();
130	}
131
132	pub fn push(&mut self, value: T) {
133		self.data.push(value);
134	}
135
136	pub fn push_default(&mut self) {
137		self.data.push(T::default());
138	}
139
140	pub fn get(&self, index: usize) -> Option<&T> {
141		if index < self.len() {
142			self.data.get(index)
143		} else {
144			None
145		}
146	}
147
148	pub fn is_defined(&self, idx: usize) -> bool {
149		idx < self.len()
150	}
151
152	pub fn is_fully_defined(&self) -> bool {
153		true
154	}
155
156	pub fn data(&self) -> &Vec<T> {
157		&self.data
158	}
159
160	pub fn data_mut(&mut self) -> &mut Vec<T> {
161		&mut self.data
162	}
163
164	pub fn as_string(&self, index: usize) -> String {
165		if index < self.len() {
166			self.data[index].to_string()
167		} else {
168			"none".to_string()
169		}
170	}
171
172	pub fn get_value(&self, index: usize) -> Value {
173		if index < self.len() {
174			self.data[index].to_value()
175		} else {
176			Value::none()
177		}
178	}
179
180	pub fn extend(&mut self, other: &Self) -> Result<()> {
181		self.data.extend(other.data.iter().cloned());
182		Ok(())
183	}
184
185	pub fn iter(&self) -> impl Iterator<Item = Option<T>> + '_
186	where
187		T: Copy,
188	{
189		self.data.iter().map(|&v| Some(v))
190	}
191
192	pub fn slice(&self, start: usize, end: usize) -> Self {
193		let count = (end - start).min(self.len().saturating_sub(start));
194		let mut new_data = Vec::with_capacity(count);
195		for i in start..(start + count) {
196			new_data.push(self.data[i].clone());
197		}
198		Self {
199			data: new_data,
200		}
201	}
202
203	pub fn filter(&mut self, mask: &BitVec) {
204		let mut new_data = Vec::with_capacity(mask.count_ones());
205
206		for (i, keep) in mask.iter().enumerate() {
207			if keep && i < self.len() {
208				new_data.push(self.data[i].clone());
209			}
210		}
211
212		self.data = new_data;
213	}
214
215	pub fn reorder(&mut self, indices: &[usize]) {
216		let mut new_data = Vec::with_capacity(indices.len());
217
218		for &idx in indices {
219			if idx < self.len() {
220				new_data.push(self.data[idx].clone());
221			} else {
222				new_data.push(T::default());
223			}
224		}
225
226		self.data = new_data;
227	}
228
229	pub fn take(&self, num: usize) -> Self {
230		Self {
231			data: self.data[..num.min(self.data.len())].to_vec(),
232		}
233	}
234}
235
236impl<T> Default for TemporalContainer<T>
237where
238	T: IsTemporal + Clone + Debug + Default,
239{
240	fn default() -> Self {
241		Self::with_capacity(0)
242	}
243}
244
245#[cfg(test)]
246pub mod tests {
247	use super::*;
248	use crate::value::{date::Date, datetime::DateTime, duration::Duration, time::Time};
249
250	#[test]
251	fn test_date_container() {
252		let dates = vec![
253			Date::from_ymd(2023, 1, 1).unwrap(),
254			Date::from_ymd(2023, 6, 15).unwrap(),
255			Date::from_ymd(2023, 12, 31).unwrap(),
256		];
257		let container = TemporalContainer::from_vec(dates.clone());
258
259		assert_eq!(container.len(), 3);
260		assert_eq!(container.get(0), Some(&dates[0]));
261		assert_eq!(container.get(1), Some(&dates[1]));
262		assert_eq!(container.get(2), Some(&dates[2]));
263
264		for i in 0..3 {
265			assert!(container.is_defined(i));
266		}
267	}
268
269	#[test]
270	fn test_datetime_container() {
271		let datetimes = vec![
272			DateTime::from_epoch_secs(1000000000).unwrap(),
273			DateTime::from_epoch_secs(2000000000).unwrap(),
274		];
275		let container = TemporalContainer::from_vec(datetimes.clone());
276
277		assert_eq!(container.len(), 2);
278		assert_eq!(container.get(0), Some(&datetimes[0]));
279		assert_eq!(container.get(1), Some(&datetimes[1]));
280	}
281
282	#[test]
283	fn test_time_container() {
284		let times = vec![
285			Time::from_hms(9, 0, 0).unwrap(),
286			Time::from_hms(12, 30, 45).unwrap(),
287			Time::from_hms(23, 59, 59).unwrap(),
288		];
289		let container = TemporalContainer::from_vec(times.clone());
290
291		assert_eq!(container.len(), 3);
292		assert_eq!(container.get(0), Some(&times[0]));
293		assert_eq!(container.get(1), Some(&times[1]));
294		assert_eq!(container.get(2), Some(&times[2]));
295	}
296
297	#[test]
298	fn test_interval_container() {
299		let durations = vec![Duration::from_days(30).unwrap(), Duration::from_hours(24).unwrap()];
300		let container = TemporalContainer::from_vec(durations.clone());
301
302		assert_eq!(container.len(), 2);
303		assert_eq!(container.get(0), Some(&durations[0]));
304		assert_eq!(container.get(1), Some(&durations[1]));
305	}
306
307	#[test]
308	fn test_with_capacity() {
309		let container: TemporalContainer<Date> = TemporalContainer::with_capacity(10);
310		assert_eq!(container.len(), 0);
311		assert!(container.is_empty());
312		assert!(container.capacity() >= 10);
313	}
314
315	#[test]
316	fn test_push_with_default() {
317		let mut container: TemporalContainer<Date> = TemporalContainer::with_capacity(3);
318
319		container.push(Date::from_ymd(2023, 1, 1).unwrap());
320		container.push_default();
321		container.push(Date::from_ymd(2023, 12, 31).unwrap());
322
323		assert_eq!(container.len(), 3);
324		assert_eq!(container.get(0), Some(&Date::from_ymd(2023, 1, 1).unwrap()));
325		assert_eq!(container.get(1), Some(&Date::default())); // push_default pushes default
326		assert_eq!(container.get(2), Some(&Date::from_ymd(2023, 12, 31).unwrap()));
327
328		assert!(container.is_defined(0));
329		assert!(container.is_defined(1));
330		assert!(container.is_defined(2));
331	}
332
333	#[test]
334	fn test_extend() {
335		let mut container1 = TemporalContainer::from_vec(vec![
336			Date::from_ymd(2023, 1, 1).unwrap(),
337			Date::from_ymd(2023, 6, 15).unwrap(),
338		]);
339		let container2 = TemporalContainer::from_vec(vec![Date::from_ymd(2023, 12, 31).unwrap()]);
340
341		container1.extend(&container2).unwrap();
342
343		assert_eq!(container1.len(), 3);
344	}
345
346	#[test]
347	fn test_iter() {
348		let dates = vec![
349			Date::from_ymd(2023, 1, 1).unwrap(),
350			Date::from_ymd(2023, 6, 15).unwrap(),
351			Date::from_ymd(2023, 12, 31).unwrap(),
352		];
353		let container = TemporalContainer::new(dates.clone());
354
355		let collected: Vec<Option<Date>> = container.iter().collect();
356		assert_eq!(collected, vec![Some(dates[0]), Some(dates[1]), Some(dates[2])]);
357	}
358
359	#[test]
360	fn testault() {
361		let container: TemporalContainer<Date> = TemporalContainer::default();
362		assert_eq!(container.len(), 0);
363		assert!(container.is_empty());
364	}
365}