Struct Command

Source

pub struct Command { /* private fields */ }

Expand description

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§

Source §

impl Command

Source

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.

Source

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.

Source

pub fn args(&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.

Source

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.

Source

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()?;

Source