Struct pstoedit::Command

pub struct Command { /* fields omitted */ }

Command builder for generic pstoedit interaction.

Commands are the main way to interact with pstoedit. A command is typically constructed using arg, args and/or args_slice. It can be run using run, multiple times if necessary.

Examples

use pstoedit::Command;

pstoedit::init()?;
Command::new().arg("-gstest")?.run()?;

use pstoedit::Command;

pstoedit::init()?;
Command::new().args_slice(&["-f", "latex2e", "input.ps", "output.tex"])?.run()?;

Errors

Most methods can raise NulError if a passed string contains an internal nul byte. Only run can raise different errors.

Implementations

impl Command

pub fn new() -> Self

Create a command with program name and without arguments.

The program name is already set in this function and should not be set using arg, args, or args_slice.

pub fn arg<S>(&mut self, arg: S) -> Result<&mut Self> where
    S: Into<Vec<u8>>, 

Add a single argument.

For more information, examples, and errors, see Command.

pub fn args<I>(&mut self, args: I) -> Result<&mut Self> where
    I: IntoIterator,
    I::Item: Into<Vec<u8>>, 

Add multiple arguments.

Examples

use pstoedit::Command;

pstoedit::init()?;
Command::new().args(std::env::args().skip(1))?.run()?;

Errors

NulError if a passed string contains an internal nul byte. Only the arguments before this string will have been added. Ownership of these later arguments will not be returned, consider using arg if necessary for more control.

pub fn args_slice<S>(&mut self, args: &[S]) -> Result<&mut Self> where
    S: AsRef<str>, 

Add multiple arguments from slice.

Ownership of arguments is not passed for ergonomic reasons. If the potential optimization benefits of passing ownership are desired, use args or arg. This can be the case when passing instances of String or Vec<u8>.

Examples

See Command.

Errors

NulError if a passed string contains an internal nul byte. Only the arguments before this string will have been added.

pub fn gs<S>(&mut self, gs: S) -> Result<&mut Self> where
    S: Into<Vec<u8>>, 

Specify ghostscript executable.

By default pstoedit tries to automatically determine this value. The specifics of this are platform-dependent.

Examples

use pstoedit::Command;

pstoedit::init()?;
// Use personal ghostscript executable that is not in PATH
let gs = "/home/user/projects/ghostscript/bin/gs";
Command::new().arg("-gstest")?.gs(gs)?.run()?;

pub fn run(&self) -> Result<()>

Run the command.

This can be done multiple times for the same Command.

Examples

See Command.

Errors

• NotInitialized if init was not called successfully.
• PstoeditError if pstoedit returns with a non-zero status code.

Trait Implementations

impl Clone for Command

fn clone(&self) -> Command

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Command

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for Command

fn default() -> Self

Returns the "default value" for a type.