1 # Copyright (C) 2015 all contributors <meta@public-inbox.org>
2 # License: AGPLv3 or later (https://www.gnu.org/licenses/agpl-3.0.txt)
4 # Various Message-ID-related functions.
5 package PublicInbox::MID;
9 our @EXPORT_OK = qw/mid_clean id_compress mid2path mid_mime mid_escape/;
10 use URI::Escape qw(uri_escape_utf8);
11 use Digest::SHA qw/sha1_hex/;
12 use constant MID_MAX => 40; # SHA-1 hex length
16 defined($mid) or die "no Message-ID";
17 # MDA->precheck did more checking for us
18 if ($mid =~ /<([^>]+)>/) {
26 my ($id, $force) = @_;
28 if ($force || $id =~ /[^\w\-]/ || length($id) > MID_MAX) {
37 my ($x2, $x38) = ($mid =~ /\A([a-f0-9]{2})([a-f0-9]{38})\z/);
39 unless (defined $x38) {
40 # compatibility with old links (or short Message-IDs :)
41 $mid = mid_clean($mid);
43 $mid = sha1_hex($mid);
44 ($x2, $x38) = ($mid =~ /\A([a-f0-9]{2})([a-f0-9]{38})\z/);
49 sub mid_mime ($) { $_[0]->header_obj->header_raw('Message-ID') }
51 # RFC3986, section 3.3:
52 sub MID_ESC () { '^A-Za-z0-9\-\._~!\$\&\';\(\)\*\+,;=:@' }
53 sub mid_escape ($) { uri_escape_utf8($_[0], MID_ESC) }