summaryrefslogtreecommitdiffstats
path: root/extensions/Splinter/lib/Util.pm
blob: c8c0d52d2f38af9b33c4bf5b36c0d7e4a29c4f54 (plain)
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# -*- Mode: perl; indent-tabs-mode: nil -*-
#
# The contents of this file are subject to the Mozilla Public
# License Version 1.1 (the "License"); you may not use this file
# except in compliance with the License. You may obtain a copy of
# the License at http://www.mozilla.org/MPL/
#
# Software distributed under the License is distributed on an "AS
# IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
# implied. See the License for the specific language governing
# rights and limitations under the License.
#
# The Original Code is the Splinter Bugzilla Extension.
#
# The Initial Developer of the Original Code is Red Hat, Inc.
# Portions created by Red Hat, Inc. are Copyright (C) 2009
# Red Hat Inc. All Rights Reserved.
#
# Contributor(s):
#   Owen Taylor <otaylor@fishsoup.net>

package Bugzilla::Extension::Splinter::Util;

use strict;

use Bugzilla;
use Bugzilla::Util;

use base qw(Exporter);

@Bugzilla::Extension::Splinter::Util::EXPORT = qw(
    attachment_is_visible 
    attachment_id_is_patch
    get_review_url 
    get_review_link 
    add_review_links_to_email
);

# Checks if the current user can see an attachment
# Based on code from attachment.cgi
sub attachment_is_visible {
    my $attachment = shift;

    $attachment->isa('Bugzilla::Attachment') || return 0;

    return (Bugzilla->user->can_see_bug($attachment->bug->id) 
            && (!$attachment->isprivate 
                || Bugzilla->user->id == $attachment->attacher->id 
                || Bugzilla->user->is_insider));
}

sub attachment_id_is_patch {
    my $attach_id = shift;
    my $attachment = new Bugzilla::Attachment($attach_id);

    # The check on attachment_is_visible here is to prevent a tiny
    # information leak where someone could check if a private
    # attachment was a patch by creating text that would get linkified
    # differently. Likely excess paranoia
    return (defined $attachment
            && attachment_is_visible($attachment) 
            && $attachment->ispatch);
}

sub get_review_url {
    my ($bug, $attach_id, $absolute) = @_;
    my $base = Bugzilla->params->{'splinter_base'};
    my $bug_id = $bug->id;

    if (defined $absolute && $absolute) {
        my $urlbase = correct_urlbase();
        $urlbase =~ s!/$!! if $base =~ "^/";
        $base = $urlbase . $base;
    }

    if ($base =~ /\?/) {
        return "$base&bug=$bug_id&attachment=$attach_id";
    } 
    else {
        return "$base?bug=$bug_id&attachment=$attach_id";
    }
}

sub get_review_link {
    my ($attach_id, $link_text) = @_;

    my $attachment = Bugzilla::Attachment->new($attach_id);

    if ($attachment && $attachment->ispatch) {
        return "<a href='" . html_quote(get_review_url($attachment->bug, $attach_id)) . "'>$link_text</a>";
    }
}

sub munge_create_attachment {
    my ($bug, $intro_text, $attach_id, $view_link) = @_;

    if (attachment_id_is_patch ($attach_id)) {
        return ("$intro_text" .
                " View: $view_link\015\012" .
                " Review: " . get_review_url($bug, $attach_id, 1) . "\015\012");
    } 
    else {
        return ("$intro_text --> ($view_link)");
    }
}

# This adds review links into a bug mail before we send it out.
# Since this is happening after newlines have been converted into
# RFC-2822 style \r\n, we need handle line ends carefully.
# (\015 and \012 are used because Perl \n is platform-dependent)
sub add_review_links_to_email {
    my $email = shift;
    my $body = $email->body;
    my $new_body = 0;
    my $bug;

    if ($email->header('Subject') =~ /^\[Bug\s+(\d+)\]/ 
        && Bugzilla->user->can_see_bug($1))
    {
        $bug = Bugzilla::Bug->new($1);
    }

    return unless defined $bug;

    if ($body =~ /Review\s+of\s+attachment\s+\d+\s*:/) {
        $body =~ s~(Review\s+of\s+attachment\s+(\d+)\s*:)
                  ~"$1\015\012 --> (" . get_review_url($bug, $2, 1) . ")"
                  ~egx;
        $new_body = 1;
    }

    if ($body =~ /Created attachment \d+\015\012 --> /) {
        $body =~ s~(Created\ attachment\ (\d+)\015\012)
                   \ -->\ \(([^\015\012]*)\)[^\015\012]*
                  ~munge_create_attachment($bug, $1, $2, $3)
                  ~egx;
        $new_body = 1;
    }

    $email->body_set($body) if $new_body;
}

1;