Struct apollo_router::Executable

source ยท
#[non_exhaustive]
pub struct Executable {}
Expand description

Entry point into creating a router executable with more customization than main.

Implementationsยง

sourceยง

impl Executable

source

pub fn builder() -> __ExecutableBuilder<(__Optional<Option<ShutdownSource>>, __Optional<Option<SchemaSource>>, __Optional<Option<LicenseSource>>, __Optional<Option<ConfigurationSource>>, __Optional<Option<Opt>>)>

Returns a builder that can parse command-line options and run a Router in an existing Tokio runtime.

Builder methods:

  • .config(impl Into<ConfigurationSource>) Optional. Specifies where to find the Router configuration. The default is the file specified by the --config or -c CLI option.

  • .schema(impl Into<SchemaSource>) Optional. Specifies when to find the supergraph schema. The default is the file specified by the --supergraph or -s CLI option.

  • .shutdown(impl Into<ShutdownSource>) Optional. Specifies when the Router should shut down gracefully. The default is on CTRL+C (SIGINT).

  • .start() Returns a future that resolves to anyhow::Result<()> on fatal error or after graceful shutdown has completed. Must be called (and the future awaited) in the context of an existing Tokio runtime.

use apollo_router::{Executable, ShutdownSource};
use apollo_router::{ConfigurationSource, SchemaSource};
Executable::builder()
  .shutdown(ShutdownSource::None)
  .schema(SchemaSource::Stream(schemas))
  .config(ConfigurationSource::Stream(configs))
  .start()
  .await

Auto Trait Implementationsยง

Blanket Implementationsยง

sourceยง

impl<T> Any for T
where T: 'static + ?Sized,

sourceยง

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
sourceยง

impl<T> Any for T
where T: Any,

sourceยง

fn into_any(self: Box<T>) -> Box<dyn Any>

sourceยง

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

sourceยง

fn type_name(&self) -> &'static str

sourceยง

impl<T> AnySync for T
where T: Any + Send + Sync,

sourceยง

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send>

sourceยง

impl<T> Borrow<T> for T
where T: ?Sized,

sourceยง

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
sourceยง

impl<T> BorrowMut<T> for T
where T: ?Sized,

sourceยง

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
sourceยง

impl<T> From<T> for T

sourceยง

fn from(t: T) -> T

Returns the argument unchanged.

sourceยง

impl<T> FutureExt for T

sourceยง

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
sourceยง

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
sourceยง

impl<T> Instrument for T

sourceยง

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
sourceยง

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
sourceยง

impl<T> Instrument for T

sourceยง

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
sourceยง

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
sourceยง

impl<T, U> Into<U> for T
where U: From<T>,

sourceยง

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

sourceยง

impl<T> IntoEither for T

sourceยง

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
sourceยง

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
sourceยง

impl<T> IntoRequest<T> for T

sourceยง

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
sourceยง

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

sourceยง

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
sourceยง

impl<T> Paint for T
where T: ?Sized,

sourceยง

fn fg(&self, value: Color) -> Painted<&T>

Returns a styled value derived from self with the foreground set to value.

This method should be used rarely. Instead, prefer to use color-specific builder methods like red() and green(), which have the same functionality but are pithier.

ยงExample

Set foreground color to white using fg():

use yansi::{Paint, Color};

painted.fg(Color::White);

Set foreground color to white using white().

use yansi::Paint;

painted.white();
sourceยง

fn primary(&self) -> Painted<&T>

Returns self with the fg() set to Color::Primary.

ยงExample
println!("{}", value.primary());
sourceยง

fn fixed(&self, color: u8) -> Painted<&T>

Returns self with the fg() set to Color::Fixed.

ยงExample
println!("{}", value.fixed(color));
sourceยง

fn rgb(&self, r: u8, g: u8, b: u8) -> Painted<&T>

Returns self with the fg() set to Color::Rgb.

ยงExample
println!("{}", value.rgb(r, g, b));
sourceยง

fn black(&self) -> Painted<&T>

Returns self with the fg() set to Color::Black.

ยงExample
println!("{}", value.black());
sourceยง

fn red(&self) -> Painted<&T>

Returns self with the fg() set to Color::Red.

ยงExample
println!("{}", value.red());
sourceยง

fn green(&self) -> Painted<&T>

Returns self with the fg() set to Color::Green.

ยงExample
println!("{}", value.green());
sourceยง

fn yellow(&self) -> Painted<&T>

Returns self with the fg() set to Color::Yellow.

ยงExample
println!("{}", value.yellow());
sourceยง

fn blue(&self) -> Painted<&T>

Returns self with the fg() set to Color::Blue.

ยงExample
println!("{}", value.blue());
sourceยง

fn magenta(&self) -> Painted<&T>

Returns self with the fg() set to Color::Magenta.

ยงExample
println!("{}", value.magenta());
sourceยง

fn cyan(&self) -> Painted<&T>

Returns self with the fg() set to Color::Cyan.

ยงExample
println!("{}", value.cyan());
sourceยง

fn white(&self) -> Painted<&T>

Returns self with the fg() set to Color::White.

ยงExample
println!("{}", value.white());
sourceยง

fn bright_black(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightBlack.

ยงExample
println!("{}", value.bright_black());
sourceยง

fn bright_red(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightRed.

ยงExample
println!("{}", value.bright_red());
sourceยง

fn bright_green(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightGreen.

ยงExample
println!("{}", value.bright_green());
sourceยง

fn bright_yellow(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightYellow.

ยงExample
println!("{}", value.bright_yellow());
sourceยง

fn bright_blue(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightBlue.

ยงExample
println!("{}", value.bright_blue());
sourceยง

fn bright_magenta(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightMagenta.

ยงExample
println!("{}", value.bright_magenta());
sourceยง

fn bright_cyan(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightCyan.

ยงExample
println!("{}", value.bright_cyan());
sourceยง

fn bright_white(&self) -> Painted<&T>

Returns self with the fg() set to Color::BrightWhite.

ยงExample
println!("{}", value.bright_white());
sourceยง

fn bg(&self, value: Color) -> Painted<&T>

Returns a styled value derived from self with the background set to value.

This method should be used rarely. Instead, prefer to use color-specific builder methods like on_red() and on_green(), which have the same functionality but are pithier.

ยงExample

Set background color to red using fg():

use yansi::{Paint, Color};

painted.bg(Color::Red);

Set background color to red using on_red().

use yansi::Paint;

painted.on_red();
sourceยง

fn on_primary(&self) -> Painted<&T>

Returns self with the bg() set to Color::Primary.

ยงExample
println!("{}", value.on_primary());
sourceยง

fn on_fixed(&self, color: u8) -> Painted<&T>

Returns self with the bg() set to Color::Fixed.

ยงExample
println!("{}", value.on_fixed(color));
sourceยง

fn on_rgb(&self, r: u8, g: u8, b: u8) -> Painted<&T>

Returns self with the bg() set to Color::Rgb.

ยงExample
println!("{}", value.on_rgb(r, g, b));
sourceยง

fn on_black(&self) -> Painted<&T>

Returns self with the bg() set to Color::Black.

ยงExample
println!("{}", value.on_black());
sourceยง

fn on_red(&self) -> Painted<&T>

Returns self with the bg() set to Color::Red.

ยงExample
println!("{}", value.on_red());
sourceยง

fn on_green(&self) -> Painted<&T>

Returns self with the bg() set to Color::Green.

ยงExample
println!("{}", value.on_green());
sourceยง

fn on_yellow(&self) -> Painted<&T>

Returns self with the bg() set to Color::Yellow.

ยงExample
println!("{}", value.on_yellow());
sourceยง

fn on_blue(&self) -> Painted<&T>

Returns self with the bg() set to Color::Blue.

ยงExample
println!("{}", value.on_blue());
sourceยง

fn on_magenta(&self) -> Painted<&T>

Returns self with the bg() set to Color::Magenta.

ยงExample
println!("{}", value.on_magenta());
sourceยง

fn on_cyan(&self) -> Painted<&T>

Returns self with the bg() set to Color::Cyan.

ยงExample
println!("{}", value.on_cyan());
sourceยง

fn on_white(&self) -> Painted<&T>

Returns self with the bg() set to Color::White.

ยงExample
println!("{}", value.on_white());
sourceยง

fn on_bright_black(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightBlack.

ยงExample
println!("{}", value.on_bright_black());
sourceยง

fn on_bright_red(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightRed.

ยงExample
println!("{}", value.on_bright_red());
sourceยง

fn on_bright_green(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightGreen.

ยงExample
println!("{}", value.on_bright_green());
sourceยง

fn on_bright_yellow(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightYellow.

ยงExample
println!("{}", value.on_bright_yellow());
sourceยง

fn on_bright_blue(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightBlue.

ยงExample
println!("{}", value.on_bright_blue());
sourceยง

fn on_bright_magenta(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightMagenta.

ยงExample
println!("{}", value.on_bright_magenta());
sourceยง

fn on_bright_cyan(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightCyan.

ยงExample
println!("{}", value.on_bright_cyan());
sourceยง

fn on_bright_white(&self) -> Painted<&T>

Returns self with the bg() set to Color::BrightWhite.

ยงExample
println!("{}", value.on_bright_white());
sourceยง

fn attr(&self, value: Attribute) -> Painted<&T>

Enables the styling Attribute value.

This method should be used rarely. Instead, prefer to use attribute-specific builder methods like bold() and underline(), which have the same functionality but are pithier.

ยงExample

Make text bold using attr():

use yansi::{Paint, Attribute};

painted.attr(Attribute::Bold);

Make text bold using using bold().

use yansi::Paint;

painted.bold();
sourceยง

fn bold(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Bold.

ยงExample
println!("{}", value.bold());
sourceยง

fn dim(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Dim.

ยงExample
println!("{}", value.dim());
sourceยง

fn italic(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Italic.

ยงExample
println!("{}", value.italic());
sourceยง

fn underline(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Underline.

ยงExample
println!("{}", value.underline());

Returns self with the attr() set to Attribute::Blink.

ยงExample
println!("{}", value.blink());

Returns self with the attr() set to Attribute::RapidBlink.

ยงExample
println!("{}", value.rapid_blink());
sourceยง

fn invert(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Invert.

ยงExample
println!("{}", value.invert());
sourceยง

fn conceal(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Conceal.

ยงExample
println!("{}", value.conceal());
sourceยง

fn strike(&self) -> Painted<&T>

Returns self with the attr() set to Attribute::Strike.

ยงExample
println!("{}", value.strike());
sourceยง

fn quirk(&self, value: Quirk) -> Painted<&T>

Enables the yansi Quirk value.

This method should be used rarely. Instead, prefer to use quirk-specific builder methods like mask() and wrap(), which have the same functionality but are pithier.

ยงExample

Enable wrapping using .quirk():

use yansi::{Paint, Quirk};

painted.quirk(Quirk::Wrap);

Enable wrapping using wrap().

use yansi::Paint;

painted.wrap();
sourceยง

fn mask(&self) -> Painted<&T>

Returns self with the quirk() set to Quirk::Mask.

ยงExample
println!("{}", value.mask());
sourceยง

fn wrap(&self) -> Painted<&T>

Returns self with the quirk() set to Quirk::Wrap.

ยงExample
println!("{}", value.wrap());
sourceยง

fn linger(&self) -> Painted<&T>

Returns self with the quirk() set to Quirk::Linger.

ยงExample
println!("{}", value.linger());
sourceยง

fn clear(&self) -> Painted<&T>

๐Ÿ‘ŽDeprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear(). The clear() method will be removed in a future release.

Returns self with the quirk() set to Quirk::Clear.

ยงExample
println!("{}", value.clear());
sourceยง

fn resetting(&self) -> Painted<&T>

Returns self with the quirk() set to Quirk::Resetting.

ยงExample
println!("{}", value.resetting());
sourceยง

fn bright(&self) -> Painted<&T>

Returns self with the quirk() set to Quirk::Bright.

ยงExample
println!("{}", value.bright());
sourceยง

fn on_bright(&self) -> Painted<&T>

Returns self with the quirk() set to Quirk::OnBright.

ยงExample
println!("{}", value.on_bright());
sourceยง

fn whenever(&self, value: Condition) -> Painted<&T>

Conditionally enable styling based on whether the Condition value applies. Replaces any previous condition.

See the crate level docs for more details.

ยงExample

Enable styling painted only when both stdout and stderr are TTYs:

use yansi::{Paint, Condition};

painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);
sourceยง

fn new(self) -> Painted<Self>
where Self: Sized,

Create a new Painted with a default Style. Read more
sourceยง

fn paint<S>(&self, style: S) -> Painted<&Self>
where S: Into<Style>,

Apply a style wholesale to self. Any previous style is replaced. Read more
sourceยง

impl<T> Same for T

ยง

type Output = T

Should always be Self
sourceยง

impl<T, U> TryFrom<U> for T
where U: Into<T>,

ยง

type Error = Infallible

The type returned in the event of a conversion error.
sourceยง

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
sourceยง

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

ยง

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
sourceยง

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
sourceยง

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

sourceยง

fn vzip(self) -> V

sourceยง

impl<T> WithSubscriber for T

sourceยง

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
sourceยง

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
sourceยง

impl<T> WithSubscriber for T

sourceยง

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
sourceยง

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more