polars-stream 0.54.2

Private crate for the streaming execution engine for the Polars DataFrame library
Documentation
use std::sync::Arc;

use polars_core::prelude::PlIndexMap;
use polars_core::schema::Schema;
use polars_utils::pl_str::PlSmallStr;

use super::compute_node_prelude::*;

pub struct SimpleProjectionNode {
    // Pre-computed projection, (index, input name, output name (if different)).
    projection: Vec<(usize, PlSmallStr, Option<PlSmallStr>)>,
}

impl SimpleProjectionNode {
    pub fn new(columns: PlIndexMap<PlSmallStr, PlSmallStr>, input_schema: Arc<Schema>) -> Self {
        let projection = columns
            .into_iter()
            .map(|(out, col)| {
                let rename = out != col;
                (
                    input_schema.index_of(&col).unwrap(),
                    col,
                    rename.then_some(out),
                )
            })
            .collect();
        Self { projection }
    }
}

impl ComputeNode for SimpleProjectionNode {
    fn name(&self) -> &str {
        "simple-projection"
    }

    fn update_state(
        &mut self,
        recv: &mut [PortState],
        send: &mut [PortState],
        _state: &StreamingExecutionState,
    ) -> PolarsResult<()> {
        assert!(recv.len() == 1 && send.len() == 1);
        recv.swap_with_slice(send);
        Ok(())
    }

    fn spawn<'env, 's>(
        &'env mut self,
        scope: &'s TaskScope<'s, 'env>,
        recv_ports: &mut [Option<RecvPort<'_>>],
        send_ports: &mut [Option<SendPort<'_>>],
        _state: &'s StreamingExecutionState,
        join_handles: &mut Vec<JoinHandle<PolarsResult<()>>>,
    ) {
        assert!(recv_ports.len() == 1 && send_ports.len() == 1);
        let receivers = recv_ports[0].take().unwrap().parallel();
        let senders = send_ports[0].take().unwrap().parallel();

        for (mut recv, mut send) in receivers.into_iter().zip(senders) {
            let slf = &*self;
            join_handles.push(scope.spawn_task(TaskPriority::High, async move {
                while let Ok(morsel) = recv.recv().await {
                    let morsel = morsel.try_map(|df| unsafe {
                        let mut cols = Vec::with_capacity(slf.projection.len());
                        for (idx, name, rename) in &slf.projection {
                            let mut col = df.columns()[*idx].clone();
                            debug_assert_eq!(col.name(), name);
                            if let Some(name) = rename {
                                col.rename(name.clone())
                            }
                            cols.push(col)
                        }
                        PolarsResult::Ok(DataFrame::new_unchecked(df.height(), cols))
                    })?;

                    if send.send(morsel).await.is_err() {
                        break;
                    }
                }

                Ok(())
            }));
        }
    }
}