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".