Enum BuildTarget 

pub enum BuildTarget {
    Hb,
    Bin,
    Cdylib,
}

A build target is what runs htl’s output. The htl binary runs a .hb bundle; the OS runs a native binary; a caller written in C, Python or C# loads a cdylib. That is the axis, and it is the only thing the entries below differ about — README “Build targets” has the table of what each one produces.

What is in the enum, and what is derived from it

The enum is over what runs the output, and nothing else. Cargo’s [lib] crate-type and the entry-script rule are answers derived from an entry (crate_types, entry), not fields stored beside it, so adding a target is adding one arm and the answers it gives rather than a row of parallel data that can disagree with itself. A platform or a target triple is deliberately not in here: bin on Linux and bin on Windows are the same build target, and if a platform ever has to be named it is an attribute of one target, not a fourth entry.

Why it is not called a host

Two of the three entries happen to be Rust crates, which is why this used to be called a host; an output nothing Rust runs — a .love bundle, say — is the entry that makes that word plainly wrong.

Host keeps its own meaning throughout htl and is not this: it is the Rust side that embeds the Lua state — #[host_module], the src/host.d.tl generated from it, and [build] host / htl build --host x,y, which name the modules that side provides at run time. A project can have a host and the default target (htl build alone), and two targets can share one host, so they are two axes rather than two words for one.

Variants

Hb

A .hb bundle, run by the htl binary. What plain htl build produces, and what every project without Rust in it is.

Bin

A native binary, run by the OS: a library crate holding the host module and the embedded scripts, with a thin binary on top.

Cdylib

A C ABI library, loaded by a caller that is not written in Rust.

Implementations

impl BuildTarget

pub const ALL: &'static [BuildTarget]

Every target there is, in the order they are offered and reported.

pub fn name(&self) -> &'static str

How it is spelled on the command line (--target <name>) and in htl.toml.

pub fn names() -> Vec<&'static str>

Every name, in ALL order: what a flag offers and what a typo is answered with.

pub fn crate_types(&self) -> &'static [&'static str]

[lib] crate-type = [...] beyond the default rlib, which needs no section at all. Derived rather than stored: the crate shape is a consequence of what loads the output, so it is answered here and Cargo.toml has nothing else to know about it.

pub fn entry(&self) -> Script

What this target has to say about src/main.tl.

pub fn runs_it(&self) -> &'static str

Who is on the far end, in the words the README’s table and htl new’s refusals use.

Trait Implementations

impl Clone for BuildTarget

fn clone(&self) -> BuildTarget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BuildTarget

impl Debug for BuildTarget

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BuildTarget

The string form is the only form: target = "cdylib" in htl.toml goes through FromStr, so a name that is not one is refused with the same sentence the command line answers a typo with, rather than with serde’s list of variant spellings.

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for BuildTarget

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

Formats the value using the given formatter.

impl Eq for BuildTarget

impl FromStr for BuildTarget

type Err = String

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for BuildTarget

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BuildTarget

fn eq(&self, other: &BuildTarget) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BuildTarget