NAME

Nano::Stash - Stashable Role

ABSTRACT

Stashable Entity Role

SYNOPSIS


            
              
              package Example;
use Moo;
extends 'Nano::Node';
with 'Nano::Stash';
sub bestie {
  my ($self, @args) = @_;
  return $self->stash('bestie', @args);
}
package main;
my $example = Example->new;
# $example->bestie($example);

DESCRIPTION

This package provides an entity-stashing role, useful for the ad-hoc persisting of Nano::Node entities. This role also makes it possible to save/load circularly dependent entities.

LIBRARIES

This package uses type constraints from:

Nano::Types

ATTRIBUTES

This package has the following attributes:

stashed


            
              
              stashed(HashRef)

This attribute is read-only, accepts (HashRef) values, and is optional.

METHODS

This package implements the following methods:

get


            
              
              get(Str $name) : Maybe[Node]

The get method finds and loads a previously stashed Nano::Node entity.

get example #1


            
              
              my $example = Example->new;
my $bestie = $example->get('bestie');

get example #2


            
              
              my $example = Example->new;
$example->bestie($example);
$example->save;
my $bestie = $example->get('bestie');

set


            
              
              set(Str $name, Node $node) : Node

The set method stashes the Nano::Node entity provided by name. This does not save the subject or invocant.

set example #1


            
              
              my $example = Example->new;
my $bestie = $example->set('bestie', $example);

stash


            
              
              stash(Str $name, Maybe[Node] $node) : Maybe[Node]

The stash method will "get" or "set" a stashed Nano::Node entity based on the arguments provided.

stash example #1


            
              
              my $example = Example->new;
my $bestie = $example->stash('bestie');

stash example #2


            
              
              my $example = Example->new;
$example->bestie($example);
$example->save;
my $bestie = $example->stash('bestie');

stash example #3


            
              
              my $example = Example->new;
my $bestie = $example->stash('bestie', $example);

AUTHOR

Al Newkirk, awncorp@cpan.org

LICENSE

This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file".