NAME

Venus::Role::Patchable - Patchable Role

ABSTRACT

Patchable Role for Perl 5

SYNOPSIS

package Example;

use Venus::Class;

with 'Venus::Role::Patchable';

package main;

my $example = Example->new;

# my $patch = $example->patch;

# bless(.., "Venus::Space")

DESCRIPTION

This package modifies the consuming package and provides methods for patching (or monkey-patching) routines in the calling package using "patch" in Venus::Space.

METHODS

This package provides the following methods:

patch

patch(string $name, coderef $code) (Venus::Space)

The patch method overwrites the named subroutine in the calling package using "patch" in Venus::Space returning a Venus::Space object that can be used to restore the original subroutine when "unpatch" in Venus::Space is called.

Since 3.55

patch example 1

package Example;

use Venus::Class;

with 'Venus::Role::Patchable';

sub test {
  my ($self, @args) = @_;

  return [$self, @args];
}

package main;

my $example = Example->new;

my $patch = $example->patch('test', sub {
  my ($next, @args) = @_;

  return ['patched', @{$next->(@args)}];
});

# bless(.., "Venus::Space")

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.