juniper 0.17.0

GraphQL server library.
Documentation
#![expect(missing_docs, reason = "GraphQL schema testing")]

use std::{collections::HashMap, pin::Pin};

use crate::{Context, GraphQLEnum, graphql_interface, graphql_object, graphql_subscription};

#[derive(Clone, Copy, Debug)]
pub struct Query;

#[graphql_object(context = Database)]
/// The root query object of the schema
impl Query {
    fn human(
        #[graphql(context)] database: &Database,
        #[graphql(description = "id of the human")] id: String,
    ) -> Option<&Human> {
        database.get_human(&id)
    }

    fn droid(
        #[graphql(context)] database: &Database,
        #[graphql(description = "id of the droid")] id: String,
    ) -> Option<&Droid> {
        database.get_droid(&id)
    }

    fn hero(
        #[graphql(context)] database: &Database,
        #[graphql(description = "If omitted, returns the hero of the whole saga. \
                                 If provided, returns the hero of that particular episode")]
        episode: Option<Episode>,
    ) -> Option<CharacterValue> {
        Some(database.get_hero(episode))
    }
}

#[derive(Clone, Copy, Debug)]
pub struct Subscription;

type HumanStream = Pin<Box<dyn futures::Stream<Item = Human> + Send>>;

#[graphql_subscription(context = Database)]
/// Super basic subscription fixture
impl Subscription {
    async fn async_human(context: &Database) -> HumanStream {
        let human = context.get_human("1000").unwrap().clone();
        Box::pin(futures::stream::once(futures::future::ready(human)))
    }
}
#[derive(GraphQLEnum, Clone, Copy, Debug, Eq, PartialEq)]
pub enum Episode {
    #[graphql(name = "NEW_HOPE")]
    NewHope,
    Empire,
    Jedi,
}

#[graphql_interface(for = [Human, Droid], context = Database)]
/// A character in the Star Wars Trilogy
pub trait Character {
    /// The id of the character
    fn id(&self) -> &str;

    /// The name of the character
    fn name(&self) -> Option<&str>;

    /// The friends of the character
    fn friends(&self, ctx: &Database) -> Vec<CharacterValue>;

    /// Which movies they appear in
    fn appears_in(&self) -> &[Episode];

    #[graphql(ignore)]
    fn friends_ids(&self) -> &[String];
}

#[derive(Clone)]
pub struct Human {
    id: String,
    name: String,
    friend_ids: Vec<String>,
    appears_in: Vec<Episode>,
    #[expect(dead_code, reason = "to be used yet")]
    secret_backstory: Option<String>,
    home_planet: Option<String>,
}

impl Human {
    pub fn new(
        id: &str,
        name: &str,
        friend_ids: &[&str],
        appears_in: &[Episode],
        secret_backstory: Option<&str>,
        home_planet: Option<&str>,
    ) -> Self {
        Self {
            id: id.into(),
            name: name.into(),
            friend_ids: friend_ids.iter().copied().map(Into::into).collect(),
            appears_in: appears_in.to_vec(),
            secret_backstory: secret_backstory.map(Into::into),
            home_planet: home_planet.map(Into::into),
        }
    }
}

/// A humanoid creature in the Star Wars universe.
#[graphql_object(context = Database, impl = CharacterValue)]
impl Human {
    /// The id of the human
    pub fn id(&self) -> &str {
        &self.id
    }

    /// The name of the human
    pub fn name(&self) -> Option<&str> {
        Some(self.name.as_str())
    }

    /// The friends of the human
    pub fn friends(&self, ctx: &Database) -> Vec<CharacterValue> {
        ctx.get_friends(&self.friend_ids)
    }

    /// Which movies they appear in
    pub fn appears_in(&self) -> &[Episode] {
        &self.appears_in
    }

    /// The home planet of the human
    pub fn home_planet(&self) -> &Option<String> {
        &self.home_planet
    }
}

#[derive(Clone)]
pub struct Droid {
    id: String,
    name: String,
    friend_ids: Vec<String>,
    appears_in: Vec<Episode>,
    #[expect(dead_code, reason = "to be used yet")]
    secret_backstory: Option<String>,
    primary_function: Option<String>,
}

impl Droid {
    pub fn new(
        id: &str,
        name: &str,
        friend_ids: &[&str],
        appears_in: &[Episode],
        secret_backstory: Option<&str>,
        primary_function: Option<&str>,
    ) -> Self {
        Self {
            id: id.into(),
            name: name.into(),
            friend_ids: friend_ids.iter().copied().map(Into::into).collect(),
            appears_in: appears_in.to_vec(),
            secret_backstory: secret_backstory.map(Into::into),
            primary_function: primary_function.map(Into::into),
        }
    }
}

/// A mechanical creature in the Star Wars universe.
#[graphql_object(context = Database, impl = CharacterValue)]
impl Droid {
    /// The id of the droid
    pub fn id(&self) -> &str {
        &self.id
    }

    /// The name of the droid
    pub fn name(&self) -> Option<&str> {
        Some(self.name.as_str())
    }

    /// The friends of the droid
    pub fn friends(&self, ctx: &Database) -> Vec<CharacterValue> {
        ctx.get_friends(&self.friend_ids)
    }

    /// Which movies they appear in
    pub fn appears_in(&self) -> &[Episode] {
        &self.appears_in
    }

    /// The primary function of the droid
    pub fn primary_function(&self) -> &Option<String> {
        &self.primary_function
    }
}

#[derive(Clone, Default)]
pub struct Database {
    humans: HashMap<String, Human>,
    droids: HashMap<String, Droid>,
}

impl Context for Database {}

impl Database {
    pub fn new() -> Database {
        let mut humans = HashMap::new();
        let mut droids = HashMap::new();

        humans.insert(
            "1000".into(),
            Human::new(
                "1000",
                "Luke Skywalker",
                &["1002", "1003", "2000", "2001"],
                &[Episode::NewHope, Episode::Empire, Episode::Jedi],
                None,
                Some("Tatooine"),
            ),
        );

        humans.insert(
            "1001".into(),
            Human::new(
                "1001",
                "Darth Vader",
                &["1004"],
                &[Episode::NewHope, Episode::Empire, Episode::Jedi],
                None,
                Some("Tatooine"),
            ),
        );

        humans.insert(
            "1002".into(),
            Human::new(
                "1002",
                "Han Solo",
                &["1000", "1003", "2001"],
                &[Episode::NewHope, Episode::Empire, Episode::Jedi],
                None,
                None,
            ),
        );

        humans.insert(
            "1003".into(),
            Human::new(
                "1003",
                "Leia Organa",
                &["1000", "1002", "2000", "2001"],
                &[Episode::NewHope, Episode::Empire, Episode::Jedi],
                None,
                Some("Alderaan"),
            ),
        );

        humans.insert(
            "1004".into(),
            Human::new(
                "1004",
                "Wilhuff Tarkin",
                &["1001"],
                &[Episode::NewHope],
                None,
                None,
            ),
        );

        droids.insert(
            "2000".into(),
            Droid::new(
                "2000",
                "C-3PO",
                &["1000", "1002", "1003", "2001"],
                &[Episode::NewHope, Episode::Empire, Episode::Jedi],
                None,
                Some("Protocol"),
            ),
        );

        droids.insert(
            "2001".into(),
            Droid::new(
                "2001",
                "R2-D2",
                &["1000", "1002", "1003"],
                &[Episode::NewHope, Episode::Empire, Episode::Jedi],
                None,
                Some("Astromech"),
            ),
        );

        Database { humans, droids }
    }

    pub fn get_hero(&self, episode: Option<Episode>) -> CharacterValue {
        if episode == Some(Episode::Empire) {
            self.get_human("1000").unwrap().clone().into()
        } else {
            self.get_droid("2001").unwrap().clone().into()
        }
    }

    pub fn get_human(&self, id: &str) -> Option<&Human> {
        self.humans.get(id)
    }

    pub fn get_droid(&self, id: &str) -> Option<&Droid> {
        self.droids.get(id)
    }

    pub fn get_character(&self, id: &str) -> Option<CharacterValue> {
        #[expect(clippy::manual_map, reason = "more readable")]
        if let Some(h) = self.humans.get(id) {
            Some(h.clone().into())
        } else if let Some(d) = self.droids.get(id) {
            Some(d.clone().into())
        } else {
            None
        }
    }

    pub fn get_friends(&self, ids: &[String]) -> Vec<CharacterValue> {
        ids.iter().flat_map(|id| self.get_character(id)).collect()
    }
}