The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

CCM / HTTP-AnyUA-0.904 / lib / HTTP / AnyUA / Middleware / RequestHeaders.pm 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
—
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

              
package HTTP::AnyUA::Middleware::RequestHeaders;
# ABSTRACT: Middleware to add custom request headers
use warnings;
use strict;
our $VERSION = '0.904'; # VERSION
use parent 'HTTP::AnyUA::Middleware';
use HTTP::AnyUA::Util;
sub init {
    my $self = shift;
    my %args = @_;
    $self->{override} = !!$args{override};
    $self->{headers}  = HTTP::AnyUA::Util::normalize_headers($args{headers});
}
sub request {
    my $self = shift;
    my ($method, $url, $args) = @_;
    if ($self->override) {
        $args->{headers} = {
            %{HTTP::AnyUA::Util::normalize_headers($args->{headers})},
            %{$self->headers},
        };
    }
    else {
        $args->{headers} = {
            %{$self->headers},
            %{HTTP::AnyUA::Util::normalize_headers($args->{headers})},
        };
    }
    return $self->backend->request($method, $url, $args);
}
sub headers { shift->{headers} }
sub override { shift->{override} }
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
HTTP::AnyUA::Middleware::RequestHeaders - Middleware to add custom request headers
=head1 VERSION
version 0.904
=head1 SYNOPSIS
    $any_ua->apply_middleware('RequestHeaders',
        headers  => {connection => 'close'},
        override => 0,
    );
=head1 DESCRIPTION
This middleware adds custom headers to each request.
=head1 ATTRIBUTES
=head2 headers
Get the custom headers.
=head2 override
When true, custom headers overwrite headers in the request. The default is false (the request
headers take precedence when defined).
=head1 SEE ALSO
=over 4
=item *
L<HTTP::AnyUA::Middleware>
=back
=head1 BUGS
Please report any bugs or feature requests on the bugtracker website
L<https://github.com/chazmcgarvey/HTTP-AnyUA/issues>
When submitting a bug or request, please include a test-file or a
patch to an existing test-file that illustrates the bug or desired
feature.
=head1 AUTHOR
Charles McGarvey <chazmcgarvey@brokenzipper.com>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2019 by Charles McGarvey.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut