Struct Generator 

pub struct Generator { /* private fields */ }

Manages the recipes and production of basic resources for a planet.

The Generator is responsible for storing the allowed recipes for BasicResources and validating creation requests.

Unlike the Combinator, the Generator creates resources “from scratch” (using only energy). To create a basic resource, the generator:

1. Checks if the requested resource type is in its set of allowed recipes.
2. Discharges the provided EnergyCell to power the generation process.

Each planet instance has its own Generator initialized with a specific set of rules.

Implementations

impl Generator

pub fn new() -> Generator

Creates a new Generator with no recipes.

pub fn contains(&self, basic: BasicResourceType) -> bool

Returns true if the Generator contains a recipe for the specified BasicResourceType.

pub fn all_available_recipes(&self) -> HashSet<BasicResourceType>

Returns a HashSet of all the recipes available in the Generator.

impl Generator

pub fn make_oxygen( &self, energy_cell: &mut EnergyCell, ) -> Result<Oxygen, String>

Creates a new [<$basic>] resource.

This method attempts to create a new instance of the corresponding basic resource by discharging an EnergyCell.

Arguments

• energy_cell - A mutable reference to an EnergyCell which will be discharged to create the resource.

Returns

A Result indicating success:

• Ok([<$basic>]): The resource was successfully created.

Errors

Returns an error if there is no recipe for this resource or if the energy_cell is not charged.

pub fn make_hydrogen( &self, energy_cell: &mut EnergyCell, ) -> Result<Hydrogen, String>

Creates a new [<$basic>] resource.

This method attempts to create a new instance of the corresponding basic resource by discharging an EnergyCell.

Arguments

• energy_cell - A mutable reference to an EnergyCell which will be discharged to create the resource.

Returns

A Result indicating success:

• Ok([<$basic>]): The resource was successfully created.

Errors

Returns an error if there is no recipe for this resource or if the energy_cell is not charged.

pub fn make_carbon( &self, energy_cell: &mut EnergyCell, ) -> Result<Carbon, String>

Creates a new [<$basic>] resource.

This method attempts to create a new instance of the corresponding basic resource by discharging an EnergyCell.

Arguments

• energy_cell - A mutable reference to an EnergyCell which will be discharged to create the resource.

Returns

A Result indicating success:

• Ok([<$basic>]): The resource was successfully created.

Errors

Returns an error if there is no recipe for this resource or if the energy_cell is not charged.

pub fn make_silicon( &self, energy_cell: &mut EnergyCell, ) -> Result<Silicon, String>

Creates a new [<$basic>] resource.

This method attempts to create a new instance of the corresponding basic resource by discharging an EnergyCell.

Arguments

• energy_cell - A mutable reference to an EnergyCell which will be discharged to create the resource.

Returns

A Result indicating success:

• Ok([<$basic>]): The resource was successfully created.

Errors

Returns an error if there is no recipe for this resource or if the energy_cell is not charged.

pub fn try_make( &self, req: BasicResourceType, energy_cell: &mut EnergyCell, ) -> Result<BasicResource, String>

Attempts to create a basic resource of the specified type.

This method provides a generic way to request the creation of any basic resource that the generator has a recipe for.

Arguments

• req - The BasicResourceType enum variant representing the desired resource.
• energy_cell - A mutable reference to an EnergyCell to be used for discharging during resource creation.

Returns

A Result indicating success:

• Ok(BasicResource): The requested resource was successfully created and wrapped in the BasicResource enum.

Errors

Returns an error if the energy_cell is not charged or if there is no recipe for the requested resource type.

Trait Implementations

impl Debug for Generator

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

Formats the value using the given formatter.

impl Default for Generator

fn default() -> Self

Returns the “default value” for a type.