use crate::model::*; use crate::store_utils::*; use oxigraph::model::Term; use oxigraph::sparql::*; use pyo3::exceptions::{PyRuntimeError, PySyntaxError, PyTypeError, PyValueError}; use pyo3::prelude::{ pyclass, pymethods, pyproto, FromPyObject, IntoPy, Py, PyAny, PyCell, PyErr, PyObject, PyRef, PyRefMut, PyResult, Python, }; use pyo3::{PyIterProtocol, PyMappingProtocol, PyNativeType, PyObjectProtocol}; use std::vec::IntoIter; pub fn build_query_options( use_default_graph_as_union: bool, default_graph: Option<&PyAny>, named_graphs: Option<&PyAny>, ) -> PyResult { let mut options = QueryOptions::default(); if use_default_graph_as_union { options = options.with_default_graph_as_union(); } if let Some(default_graph) = default_graph { if let Ok(default_graphs) = default_graph.iter() { if default_graph.is_empty()? { return Err(PyValueError::new_err( "The query() method default_graph argument cannot be empty list", )); } for default_graph in default_graphs { options = options.with_default_graph(default_graph?.extract::()?); } } else if let Ok(default_graph) = default_graph.extract::() { options = options.with_default_graph(default_graph); } else { return Err(PyValueError::new_err( format!("The query() method default_graph argument should be a NamedNode, a BlankNode, the DefaultGraph or a not empty list of them. {} found", default_graph.get_type() ))); } } if let Some(named_graphs) = named_graphs { if named_graphs.is_empty()? { return Err(PyValueError::new_err( "The query() method named_graphs argument cannot be empty", )); } for named_graph in named_graphs.iter()? { options = options.with_named_graph(named_graph?.extract::()?); } } Ok(options) } pub fn query_results_to_python(py: Python<'_>, results: QueryResults) -> PyResult { Ok(match results { QueryResults::Solutions(inner) => PyQuerySolutions { inner }.into_py(py), QueryResults::Graph(inner) => PyQueryTriples { inner }.into_py(py), QueryResults::Boolean(b) => b.into_py(py), }) } /// Tuple associating variables and terms that are the result of a SPARQL ``SELECT`` query. /// /// It is the equivalent of a row in SQL. /// /// It could be indexes by variable name (:py:class:`Variable` or :py:class:`str`) or position in the tuple (:py:class:`int`). /// Unpacking also works. /// /// >>> store = SledStore() /// >>> store.add(Quad(NamedNode('http://example.com'), NamedNode('http://example.com/p'), Literal('1'))) /// >>> solution = next(store.query('SELECT ?s ?p ?o WHERE { ?s ?p ?o }')) /// >>> solution[Variable('s')] /// /// >>> solution['s'] /// /// >>> solution[0] /// /// >>> s, p, o = solution /// >>> s /// #[pyclass(unsendable, name = QuerySolution)] pub struct PyQuerySolution { inner: QuerySolution, } #[pyproto] impl PyObjectProtocol for PyQuerySolution { fn __repr__(&self) -> String { let mut buffer = String::new(); buffer.push_str("'); buffer } } #[pyproto] impl PyMappingProtocol for PyQuerySolution { fn __len__(&self) -> usize { self.inner.len() } fn __getitem__(&self, input: &PyAny) -> PyResult> { if let Ok(key) = usize::extract(input) { Ok(self .inner .get(key) .map(|term| term_to_python(input.py(), term.clone()))) } else if let Ok(key) = <&str>::extract(input) { Ok(self .inner .get(key) .map(|term| term_to_python(input.py(), term.clone()))) } else if let Ok(key) = input.downcast::>() { let key = &*key.borrow(); Ok(self .inner .get(<&Variable>::from(key)) .map(|term| term_to_python(input.py(), term.clone()))) } else { Err(PyTypeError::new_err(format!( "{} is not an integer of a string", input.get_type().name(), ))) } } } #[pyproto] impl PyIterProtocol for PyQuerySolution { fn __iter__(slf: PyRef) -> SolutionValueIter { SolutionValueIter { inner: slf .inner .values() .map(|v| v.cloned()) .collect::>() .into_iter(), } } } #[pyclass] pub struct SolutionValueIter { inner: IntoIter>, } #[pyproto] impl PyIterProtocol for SolutionValueIter { fn __iter__(slf: PyRefMut) -> Py { slf.into() } fn __next__(mut slf: PyRefMut) -> Option> { slf.inner .next() .map(|v| v.map(|v| term_to_python(slf.py(), v))) } } /// An iterator of :py:class:`QuerySolution` returned by a SPARQL ``SELECT`` query /// /// >>> store = SledStore() /// >>> store.add(Quad(NamedNode('http://example.com'), NamedNode('http://example.com/p'), Literal('1'))) /// >>> list(store.query('SELECT ?s WHERE { ?s ?p ?o }')) /// [>] #[pyclass(unsendable, name = QuerySolutions)] pub struct PyQuerySolutions { inner: QuerySolutionIter, } #[pymethods] impl PyQuerySolutions { /// :return: the ordered list of all variables that could appear in the query results /// :rtype: list(Variable) /// /// >>> store = SledStore() /// >>> store.query('SELECT ?s WHERE { ?s ?p ?o }').variables /// [] #[getter] fn variables(&self) -> Vec { self.inner .variables() .iter() .map(|v| v.clone().into()) .collect() } } #[pyproto] impl PyIterProtocol for PyQuerySolutions { fn __iter__(slf: PyRefMut) -> Py { slf.into() } fn __next__(mut slf: PyRefMut) -> PyResult> { Ok(slf .inner .next() .transpose() .map_err(map_evaluation_error)? .map(move |inner| PyQuerySolution { inner })) } } /// An iterator of :py:class:`Triple` returned by a SPARQL ``CONSTRUCT`` or ``DESCRIBE`` query /// /// >>> store = MemoryStore() /// >>> store.add(Quad(NamedNode('http://example.com'), NamedNode('http://example.com/p'), Literal('1'))) /// >>> list(store.query('CONSTRUCT WHERE { ?s ?p ?o }')) /// [ predicate= object=>>] #[pyclass(unsendable, name = QueryTriples)] pub struct PyQueryTriples { inner: QueryTripleIter, } #[pyproto] impl PyIterProtocol for PyQueryTriples { fn __iter__(slf: PyRefMut) -> Py { slf.into() } fn __next__(mut slf: PyRefMut) -> PyResult> { Ok(slf .inner .next() .transpose() .map_err(map_evaluation_error)? .map(|t| t.into())) } } pub fn map_evaluation_error(error: EvaluationError) -> PyErr { match error { EvaluationError::Parsing(error) => PySyntaxError::new_err(error.to_string()), EvaluationError::Io(error) => map_io_err(error), EvaluationError::Query(error) => PyValueError::new_err(error.to_string()), _ => PyRuntimeError::new_err(error.to_string()), } }