NAME

Venus::Box - Box Class

ABSTRACT

Box Class for Perl 5

SYNOPSIS

            

              
              
package main;
use Venus::Box;
my $box = Venus::Box->new(
  value => {},
);
# $box->keys->count->unbox;
            
          

DESCRIPTION

This package provides a pure Perl boxing mechanism for wrapping objects and values, and chaining method calls across all objects.

INTEGRATES

This package integrates behaviors from:

Venus::Role::Buildable

Venus::Role::Proxyable

METHODS

This package provides the following methods:

unbox

            

              
              
unbox(string $method, any @args) (any)
            
          

The unbox method returns the un-boxed underlying object. This is a virtual method that dispatches to __handle__unbox. This method supports dispatching, i.e. providing a method name and arguments whose return value will be acted on by this method.

Since 0.01

unbox example 1

            

              
              
# given: synopsis;
my $unbox = $box->unbox;
# bless({ value => {} }, "Venus::Hash")
            
          

unbox example 2

            

              
              
# given: synopsis;
my $unbox = $box->unbox('count');
# 0
            
          

AUTHORS

Awncorp, awncorp@cpan.org

LICENSE

Copyright (C) 2022, Awncorp, awncorp@cpan.org.

This program is free software, you can redistribute it and/or modify it under the terms of the Apache license version 2.0.