/[suikacvs]/test/cvs

Diff of /test/cvs

Parent Directory | Revision Log | View Patch Patch

-revision 1.10 by wakaba,
Tue Mar 26 05:41:16 2002 UTC
+revision 1.26 by wakaba,
Sun Jun 16 10:45:54 2002 UTC
 Line 1
  =head1 NAME
- Message::Header Perl module
+ Message::Header --- A Perl Module for Internet Message Headers
- =head1 DESCRIPTION
- Perl module for RFC 822/2822 message C<header>.
  =cut
  package Message::Header;
  use strict;
- use vars qw($VERSION %REG %DEFAULT);
+ use vars qw(%DEFAULT @ISA %REG $VERSION);
- $VERSION = '1.00';
+ $VERSION=do{my @r=(q$Revision$=~/\d+/g);sprintf "%d."."%02d" x $#r,@r};
+ require Message::Field::Structured;     ## This may seem silly:-)
+ push @ISA, qw(Message::Field::Structured);
+ %REG = %Message::Util::REG;
+         $REG{M_field} = qr/^([^\x3A]+):$REG{FWS}([\x00-\xFF]*)$/;
+         $REG{M_fromline} = qr/^\x3E?From$REG{WSP}+([\x00-\xFF]*)$/;
+         $REG{ftext} = qr/[\x21-\x39\x3B-\x7E]+/;        ## [2]822
+         $REG{NON_ftext} = qr/[^\x21-\x39\x3B-\x7E]/;    ## [2]822
+         $REG{NON_ftext_usefor} = qr/[^0-9A-Za-z-]/;     ## name-character
+         $REG{NON_ftext_http} = $REG{NON_http_token};
+ ## Namespace support
+         our %NS_phname2uri;     ## PH-namespace name -> namespace URI
+         our %NS_uri2phpackage;  ## namespace URI -> PH-package name
+         require Message::Header::Default;       ## Default namespace
- use overload '@{}' => sub {shift->_delete_empty_field()->{field}},
+ ## Initialize of this class -- called by constructors
-              '""' => sub {shift->stringify};
+ %DEFAULT = (
+     -_HASH_NAME => 'value',
+     -_METHODS   => [qw|field field_exist field_type add replace count delete subject id is|],
+     -_MEMBERS   => [qw|value|],
+     -_VALTYPE_DEFAULT   => ':default',
+     -by => 'name',      ## (Reserved for method level option)
+     -field_format_pattern       => '%s: %s',
+     -field_name_case_sensible   => 0,
+     -field_name_unsafe_rule     => 'NON_ftext',
+     -field_name_validation      => 1,   ## Method level option.
+     -field_sort => 0,
+     #-format    => 'mail-rfc2822',
+     -linebreak_strict   => 0,   ## Not implemented completely
+     -line_length_max    => 60,  ## For folding
+     #ns_default_phuri
+     -output_bcc => 0,
+     -output_folding     => 1,
+     -output_mail_from   => 0,
+     #-parse_all => 0,
+     -translate_underscore       => 1,
+     #-uri_mailto_safe
+     -uri_mailto_safe_level      => 4,
+     -use_folding        => 1,
+     #-value_type
+ );
- $REG{WSP}     = qr/[\x09\x20]/;
+ $DEFAULT{-value_type} = {
- $REG{FWS}     = qr/[\x09\x20]*/;
+         ':default'      => ['Message::Field::Unstructured'],
- $REG{M_field} = qr/^([^\x3A]+):$REG{FWS}([\x00-\xFF]*)$/;
- $REG{M_fromline} = qr/^\x3E?From$REG{WSP}+([\x00-\xFF]*)$/;
+         p3p     => ['Message::Field::Params'],
- $REG{UNSAFE_field_name} = qr/[\x00-\x20\x3A\x7F-\xFF]/;
+         link    => ['Message::Field::ValueParams'],
+         'user-agent'    => ['Message::Field::UA'],
+         server  => ['Message::Field::UA'],
+ };
+ for (qw(date expires))
+   {$DEFAULT{-value_type}->{$_} = ['Message::Field::Date']}
+ for (qw(accept accept-charset accept-encoding accept-language uri))
+   {$DEFAULT{-value_type}->{$_} = ['Message::Field::CSV']}
+ for (qw(location referer))
+   {$DEFAULT{-value_type}->{$_} = ['Message::Field::URI']}
+ my %header_goodcase = (
+         'article-i.d.'  => 'Article-I.D.',
+         etag    => 'ETag',
+         'pics-label'    => 'PICS-Label',
+         te      => 'TE',
+         url     => 'URL',
+         'www-authenticate'      => 'WWW-Authenticate',
+ );
- =head2 options
+ ## taken from L<HTTP::Header>
+ # "Good Practice" order of HTTP message headers:
+ #    - General-Headers
+ #    - Request-Headers
+ #    - Response-Headers
+ #    - Entity-Headers
+ # (From draft-ietf-http-v11-spec-rev-01, Nov 21, 1997)
+ my @header_order = qw(
+   mail-from x-envelope-from relay-version path status
+    cache-control connection date pragma transfer-encoding upgrade trailer via
+    accept accept-charset accept-encoding accept-language
+    authorization expect from host
+    if-modified-since if-match if-none-match if-range if-unmodified-since
+    max-forwards proxy-authorization range referer te user-agent
+    accept-ranges age location proxy-authenticate retry-after server vary
+    warning www-authenticate
+    mime-version
+    allow content-base content-encoding content-language content-length
+    content-location content-md5 content-range content-type
+    etag expires last-modified content-style-type content-script-type
+    link
- These options can be getten/set by C<get_option>/C<set_option>
+   xref
- method.
+ );
+ my %header_order;
- =head3 capitalize = 0/1
+ =head1 CONSTRUCTORS
- (First character of) C<field-name> is capitalized
+ The following methods construct new C<Message::Header> objects:
- when C<stringify>.  (Default = 1)
- =head3 fold_length = numeric value
+ =over 4
- Length of line used to fold.  (Default = 70)
+ =cut
- =head3 mail_from = 0/1
+ sub _init ($;%) {
+   my $self = shift;
+   my %options = @_;
+   my $DEFAULT = Message::Util::make_clone (\%DEFAULT);
+   $self->SUPER::_init (%$DEFAULT, %options);
+   $self->{value} = [];
+   $self->_ns_load_ph ('default');
+   $self->_ns_load_ph ('rfc822');
+   $self->{option}->{ns_default_phuri} = $self->{ns}->{phname2uri}->{'rfc822'}
+     unless $self->{option}->{ns_default_phuri};
+   my @new_fields = ();
+   for my $name (keys %options) {
+     unless (substr ($name, 0, 1) eq '-') {
+       push @new_fields, ($name => $options{$name});
+     }
+   }
+   $self->_init_by_format ($self->{option}->{format}, $self->{option});
+   # Make alternative representations of @header_order.  This is used
+   # for sorting.
+   my $i = 1;
+   for (@header_order) {
+       $header_order{$_} = $i++ unless $header_order{$_};
+   }
+   $self->add (@new_fields, -parse => $self->{option}->{parse_all})
+     if $#new_fields > -1;
+ }
+ sub _init_by_format ($$\%) {
+   my $self = shift;
+   my ($format, $option) = @_;
+   if ($format =~ /cgi/) {
+     unshift @header_order, qw(content-type location);
+     $option->{field_sort} = 'good-practice';
+     $option->{use_folding} = 0;
+   } elsif ($format =~ /http/) {
+     $option->{field_sort} = 'good-practice';
+   }
+   if ($format =~ /uri-url-mailto/) {
+     $option->{output_bcc} = 0;
+     $option->{field_format_pattern} = '%s=%s';
+     $option->{output_folding} = sub {
+       $_[1] =~ s/([^:@+\$A-Za-z0-9\-_.!~*])/sprintf('%%%02X', ord $1)/ge;
+       $_[1];
+     };  ## Yes, this is not folding!
+   }
+ }
- Outputs "From " line (known as Un*x From, Mail-From, and so on)
+ =item $msg = Message::Header->new ([%initial-fields/options])
- when C<stringify>.  (Default = 0)
+ Constructs a new C<Message::Headers> object.  You might pass some initial
+ C<field-name>-C<field-body> pairs and/or options as parameters to the constructor.
+ Example:
+  $hdr = new Message::Headers
+         Date         => 'Thu, 03 Feb 1994 00:00:00 +0000',
+         Content_Type => 'text/html',
+         Content_Location => 'http://www.foo.example/',
+         -format => 'mail-rfc2822'       ## not to be header field
+         ;
  =cut
- %DEFAULT = (
+ ## Inherited
-   capitalize    => 1,
-   fold_length   => 70,
-   field_type    => {':DEFAULT' => 'Message::Field::Unstructured'},
-   mail_from     => -1,
-   output_bcc    => -1,
-   parse_all     => -1,
- );
- my @field_type_Structured = qw(cancel-lock
-   importance mime-version path precedence x-cite
-   x-face x-mail-count x-msmail-priority x-priority x-uidl xref);
- for (@field_type_Structured)
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Structured'}
- my @field_type_Address = qw(approved bcc cc delivered-to disposition-notification-to
-   envelope-to
-   errors-to fcc from mail-followup-to mail-followup-cc mail-from reply-to resent-bcc
-   resent-cc resent-to resent-from resent-sender return-path
-   return-receipt-to sender to x-approved x-beenthere
-   x-complaints-to x-envelope-from x-envelope-sender
-   x-envelope-to x-ml-address x-ml-command x-ml-to x-nfrom x-nto);
- for (@field_type_Address)
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Address'}
- my @field_type_Date = qw(date date-received delivery-date expires
-   expire-date nntp-posting-date posted reply-by resent-date x-tcup-date);
- for (@field_type_Date)
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Date'}
- my @field_type_MsgID = qw(content-id in-reply-to message-id
-   references resent-message-id see-also supersedes);
- for (@field_type_MsgID)
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::MsgID'}
- for (qw(received x-received))
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Received'}
- $DEFAULT{field_type}->{'content-type'} = 'Message::Field::ContentType';
- $DEFAULT{field_type}->{'content-disposition'} = 'Message::Field::ContentDisposition';
- for (qw(x-face-type))
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::ValueParams'}
- for (qw(accept accept-charset accept-encoding accept-language
-   content-language
-   content-transfer-encoding encrypted followup-to keywords newsgroups
-   x-brother x-daughter x-respect x-moe x-syster x-wife))
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::CSV'}
- my @field_type_URI = qw(list-archive list-help list-owner
-   list-post list-subscribe list-unsubscribe uri url x-home-page x-http_referer
-   x-info x-pgp-key x-ml-url x-uri x-url x-web);
- for (@field_type_URI)
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Structured'}
- for (qw(list-id))
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Structured'}
- for (qw(subject title x-nsubject))
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::Subject'}
- for (qw(list-software user-agent server))
-   {$DEFAULT{field_type}->{$_} = 'Message::Field::UA'}
- =head2 Message::Header->new ([%option])
+ =item $msg = Message::Header->parse ($header, [%initial-fields/options])
- Returns new Message::Header instance.  Some options can be
+ Parses given C<header> and constructs a new C<Message::Headers>
- specified as hash.
+ object.  You might pass some additional C<field-name>-C<field-body> pairs
+ or/and initial options as parameters to the constructor.
  =cut
- sub new ($;%) {
+ sub parse ($$;%) {
    my $class = shift;
-   my $self = bless {option => {@_}}, $class;
+   my $header = shift;
-   for (keys %DEFAULT) {$self->{option}->{$_} ||= $DEFAULT{$_}}
+   my $self = bless {}, $class;
+   $self->_init (@_);    ## BUG: don't check linebreak_strict
+   $header =~ s/\x0D?\x0A$REG{WSP}/\x20/gos if $self->{option}->{use_folding};
+   for my $field (split /\x0D?\x0A/, $header) {
+     if ($field =~ /$REG{M_fromline}/) {
+       my ($s,undef,$value) = $self->_value_to_arrayitem
+         ('mail-from' => $1, $self->{option});
+       push @{$self->{value}}, $value if $s;
+     } elsif ($field =~ /$REG{M_field}/) {
+       my ($name, $body) = ($1, $2);
+       $body =~ s/$REG{WSP}+$//;
+       my ($s,undef,$value) = $self->_value_to_arrayitem
+         ($name => $body, $self->{option});
+       push @{$self->{value}}, $value if $s;
+     } elsif (length $field) {
+       my ($s,undef,$value) = $self->_value_to_arrayitem
+         ('x-unknown' => $field, $self->{option});
+       push @{$self->{value}}, $value if $s;
+     }
+   }
    $self;
  }
- =head2 Message::Header->parse ($header, [%option])
+ =item $msg = Message::Header->parse_array (\@header, [%initial-fields/options])
- Parses given C<header> and return a new Message::Header
+ Parses given C<header> and constructs a new C<Message::Headers>
- object.  Some options can be specified as hash.
+ object.  Same as C<Message::Header-E<lt>parse> but this method
+ is given an array reference.  You might pass some additional
+ C<field-name>-C<field-body> pairs or/and initial options
+ as parameters to the constructor.
  =cut
- sub parse ($$;%) {
+ sub parse_array ($\@;%) {
    my $class = shift;
    my $header = shift;
-   my $self = bless {option => {@_}}, $class;
+   Carp::croak "parse_array: first argument is not an array reference"
-   for (keys %DEFAULT) {$self->{option}->{$_} ||= $DEFAULT{$_}}
+     unless ref $header eq 'ARRAY';
-   $header =~ s/\x0D?\x0A$REG{WSP}+/\x20/gos;    ## unfold
+   my $self = bless {}, $class;
-   for my $field (split /\x0D?\x0A/, $header) {
+   $self->_init (@_);
+   while (1) {
+     my $field = shift @$header;
+     if ($self->{option}->{use_folding}) {
+       while (1) {
+         if ($$header[0] =~ /^$REG{WSP}/) {
+           $field .= shift @$header;
+         } else {last}
+       }
+     }
+     if ($self->{option}->{linebreak_strict}) {
+       $field =~ s/\x0D\x0A//g;
+     } else {
+       $field =~ tr/\x0D\x0A//d;
+     }
+     local $self->{option}->{parse} = $self->{option}->{parse_all};
      if ($field =~ /$REG{M_fromline}/) {
-       my $body = $1;
+       my ($s,undef,$value) = $self->_value_to_arrayitem
-       $body = $self->_field_body ($body, 'mail-from')
+         ('mail-from' => $1, $self->{option});
-         if $self->{option}->{parse_all}>0;
+       push @{$self->{value}}, $value if $s;
-       push @{$self->{field}}, {name => 'mail-from', body => $body};
      } elsif ($field =~ /$REG{M_field}/) {
-       my ($name, $body) = (lc $1, $2);
+       my ($name, $body) = ($self->_n11n_field_name ($1), $2);
-       $name =~ s/$REG{WSP}+$//;
        $body =~ s/$REG{WSP}+$//;
-       $body = $self->_field_body ($body, $name) if $self->{option}->{parse_all}>0;
+       my ($s,undef,$value) = $self->_value_to_arrayitem
-       push @{$self->{field}}, {name => $name, body => $body};
+         ($name => $body, $self->{option});
+       push @{$self->{value}}, $value if $s;
+     } elsif (length $field) {
+       my ($s,undef,$value) = $self->_value_to_arrayitem
+         ('x-unknown' => $field, $self->{option});
+       push @{$self->{value}}, $value if $s;
      }
+     last if $#$header < 0;
    }
    $self;
  }
+ =back
+ =head1 METHODS
  =head2 $self->field ($field_name)
  Returns C<field-body> of given C<field-name>.
-Line 150 
 context, only first one is returned.)
+Line 281 
 context, only first one is returned.)
  =cut
- sub field ($$) {
+ sub field ($@) {shift->SUPER::item (@_)}
+ sub field_exist ($@) {shift->SUPER::item_exist (@_)}
+ ## item-by?, \$checked-item, {item-key => 1}, \%option
+ sub _item_match ($$\$\%\%) {
    my $self = shift;
-   my $name = lc shift;
+   my ($by, $i, $list, $option) = @_;
-   my @ret;
+   return 0 unless ref $$i;  ## Already removed
-   for my $field (@{$self->{field}}) {
+   if ($by eq 'name') {
-     if ($field->{name} eq $name) {
+     my %o = %$option; $o{parse} = 0;
-       unless (wantarray) {
+     my %l;
-         $field->{body} = $self->_field_body ($field->{body}, $name);
+     for (keys %$list) {
-         return $field->{body};
+       my ($s, undef, $v) = $self->_value_to_arrayitem ($_, '', %o);
+       if ($s) {
+         $l{$v->{name} . ':' . ( $option->{ns} || $v->{ns} ) } = 1;
        } else {
-         $field->{body} = $self->_field_body ($field->{body}, $name);
+         $l{$v->{name} .':'. ( $option->{ns} || $self->{option}->{ns_default_phuri} ) } = 1;
-         push @ret, $field->{body};
        }
      }
+     return 1 if $l{$$i->{name} . ':' . $$i->{ns}};
+   } elsif ($by eq 'ns') {
+     return 1 if $list->{ $$i->{ns} };
    }
-   if ($#ret < 0) {
+;
-     return $self->add ($name);
-   }
-   @ret;
  }
+ *_delete_match = \&_item_match;
- sub field_exist ($$) {
+ ## Returns returned item value    \$item-value, \%option
-   my $self = shift;
+ sub _item_return_value ($\$\%) {
-   my $name = lc shift;
+   if (ref ${$_[1]}->{body}) {
-   my @ret;
+     ${$_[1]}->{body};
-   for my $field (@{$self->{field}}) {
+   } else {
-     return 1 if ($field->{name} eq $name);
+     ${$_[1]}->{body} = $_[0]->_parse_value (${$_[1]}->{name} => ${$_[1]}->{body},
+       ns => ${$_[1]}->{ns});
+     ${$_[1]}->{body};
    }
-;
  }
+ *_add_return_value = \&_item_return_value;
+ *_replace_return_value = \&_item_return_value;
- =head2 $self->field_name ($index)
+ ## Returns returned (new created) item value    $name, \%option
+ sub _item_new_value ($$\%) {
- Returns C<field-name> of $index'th C<field>.
+     my ($s,undef,$value) = $_[0]->_value_to_arrayitem
+         ($_[1] => '', $_[2]);
- =head2 $self->field_body ($index)
+     $s? $value: undef;
+ }
- Returns C<field-body> of $index'th C<field>.
- =cut
- sub field_name ($$) {
+ ## $self->_parse_value ($type, $value, %options);
+ sub _parse_value ($$$;%) {
    my $self = shift;
-   $self->{field}->[shift]->{name};
+   my $name = shift ;#|| $self->{option}->{_VALTYPE_DEFAULT};
- }
+   my $value = shift;  return $value if ref $value;
- sub field_body ($$) {
+   my %option = @_;
-   my $self = shift;
+   my $vtype; { no strict 'refs';
-   my $i = shift;
+     my $vt = ${&_NS_uri2phpackage ($option{ns}).'::OPTION'}{value_type};
-   $self->{field}->[$i]->{body}
+     if (ref $vt) {
-    = $self->_field_body ($self->{field}->[$i]->{body}, $self->{field}->[$i]->{name});
+       $vtype = $vt->{$name} || $vt->{$self->{option}->{_VALTYPE_DEFAULT}};
-   $self->{field}->[$i]->{body};
- }
- sub _field_body ($$$) {
-   my $self = shift;
-   my ($body, $name) = @_;
-   unless (ref $body) {
-     my $type = $self->{option}->{field_type}->{$name}
-             || $self->{option}->{field_type}->{':DEFAULT'};
-     eval "require $type";
-     unless ($body) {
-       $body = $type->new (field_name => $name);
-     } else {
-       $body = $type->parse ($body, field_name => $name);
      }
+     ## For compatiblity.
+     unless (ref $vtype) { $vtype = $self->{option}->{value_type}->{$name}
+       || $self->{option}->{value_type}->{$self->{option}->{_VALTYPE_DEFAULT}} }
+   }
+   my $vpackage = $vtype->[0];
+   my %vopt = %{$vtype->[1]} if ref $vtype->[1];
+   if ($vpackage eq ':none:') {
+     return $value;
+   } elsif (defined $value) {
+     eval "require $vpackage" or Carp::croak qq{<parse>: $vpackage: Can't load package: $@};
+     return $vpackage->parse ($value,
+       -format   => $self->{option}->{format},
+       -field_ns => $option{ns},
+       -field_name       => $name,
+       -parse_all        => $self->{option}->{parse_all},
+     %vopt);
+   } else {
+     eval "require $vpackage" or Carp::croak qq{<parse>: $vpackage: Can't load package: $@};
+     return $vpackage->new (
+       -format   => $self->{option}->{format},
+       -field_ns => $option{ns},
+       -field_name       => $name,
+       -parse_all        => $self->{option}->{parse_all},
+     %vopt);
    }
-   $body;
  }
  =head2 $self->field_name_list ()
-Line 229 
 returns ALL names.)
+Line 378 
 returns ALL names.)
  sub field_name_list ($) {
    my $self = shift;
-   $self->_delete_empty_field ();
+   $self->_delete_empty ();
-   map {$_->{name}} @{$self->{field}};
+   map { $_->{name} . ':' . $_->{ns} } @{$self->{value}};
  }
- =head2 $self->add ($field_name, $field_body)
+ sub namespace_ph_default ($;$) {
+   my $self = shift;
+   if (defined $_[0]) {
+     no strict 'refs';
+     $self->{option}->{ns_default_phuri} = $_[0];
+     $self->_ns_load_ph (${&_NS_uri2phpackage ($self->{option}->{ns_default_phuri}).'::OPTION'}{namespace_phname});
+   }
+   $self->{option}->{ns_default_phuri};
+ }
+ =item $hdr->add ($field-name, $field-body, [$name, $body, ...])
+ Adds some field name/body pairs.  Even if there are
+ one or more fields named given C<$field-name>,
+ given name/body pairs are ADDed.  Use C<replace>
+ to remove same-name-fields.
- Adds an new C<field>.  It is not checked whether
+ Instead of field name-body pair, you might pass some options.
- the field which named $field_body is already exist or not.
+ Four options are available for this method.
- If you don't want duplicated C<field>s, use C<replace> method.
+ C<-parse>: Parses and validates C<field-body>, and returns
+ C<field-body> object.  (When multiple C<field-body>s are
+ added, returns only last one.)  (Default: C<defined wantarray>)
+ C<-prepend>: New fields are not appended,
+ but prepended to current fields.  (Default: C<0>)
+ C<-translate-underscore>: Do C<field-name> =~ tr/_/-/.  (Default: C<1>)
+ C<-validate>: Checks whether C<field-name> is valid or not.
  =cut
- sub add ($$;$%) {
+ ## [Name: Value] pair -> internal array item
+ ## $self->_value_to_arrayitem ($name => $value, {%options})
+ ## or
+ ## $self->_value_to_arrayitem ($name => [$value, %value_options], {%options})
+ ##
+ ## Return: ((1 = success / 0 = failue), $full_name, $arrayitem)
+ sub _value_to_arrayitem ($$$\%) {
    my $self = shift;
-   my ($name, $body) = (lc shift, shift);
+   my ($name, $value, $option) = @_;
-   my %option = @_;
+   my $value_option = {};
-   return 0 if $name =~ /$REG{UNSAFE_field_name}/;
+   if (ref $value eq 'ARRAY') {
-   $body = $self->_field_body ($body, $name);
+     ($value, %$value_option) = @$value;
-   if ($option{prepend}) {
+   }
-     unshift @{$self->{field}}, {name => $name, body => $body};
+   my $nsuri = $self->{option}->{ns_default_phuri};
-   } else {
-     push @{$self->{field}}, {name => $name, body => $body};
+   no strict 'refs';
+   if ($value_option->{ns}) {
+     $nsuri = $value_option->{ns};
+   } elsif ($option->{ns}) {
+     $nsuri = $option->{ns};
+   } elsif ($name =~ s/^([Xx]-[A-Za-z]+|[A-Za-z]+)-//) {
+     my $oprefix = $1;
+     my $prefix
+       = &{${&_NS_uri2phpackage ($nsuri).'::OPTION'}{n11n_prefix}}
+         ($self, &_NS_uri2phpackage ($nsuri), $oprefix);
+     $self->_ns_load_ph ($prefix);
+     $nsuri = $self->{ns}->{phname2uri}->{$prefix};
+     unless ($nsuri) {
+       $name = $oprefix . '-' . $name;
+       $nsuri = $self->{option}->{ns_default_phuri};
+     }
    }
-   $body;
+   $name
+     = &{${&_NS_uri2phpackage ($nsuri).'::OPTION'}{n11n_name}}
+       ($self, &_NS_uri2phpackage ($nsuri), $name);
+   Carp::croak "$name: invalid field-name"
+     if $option->{field_name_validation}
+       && $name =~ /$REG{$option->{field_name_unsafe_rule}}/;
+   $value = $self->_parse_value ($name => $value, ns => $nsuri)
+     if $$option{parse} || $$option{parse_all};
+   $$option{parse} = 0;
+   (1, $name.':'.$nsuri => {name => $name, body => $value, ns => $nsuri});
  }
+ *_add_hash_check = \&_value_to_arrayitem;
+ *_replace_hash_check = \&_value_to_arrayitem;
  =head2 $self->relace ($field_name, $field_body)
-Line 265 
 first one is used and the others are not
+Line 471 
 first one is used and the others are not
  =cut
- sub replace ($$$) {
+ sub _replace_hash_shift ($\%$\%) {
-   my $self = shift;
+   shift; my $r = shift;  my $n = $_[0]->{name} . ':' . $_[0]->{ns};
-   my ($name, $body) = (lc shift, shift);
+   if ($$r{$n}) {
-   return 0 if $name =~ /$REG{UNSAFE_field_name}/;
+     my $d = $$r{$n};
-   $body = $self->_field_body ($body, $name);
+     delete $$r{$n};
-   for my $field (@{$self->{field}}) {
+     return $d;
-     if ($field->{name} eq $name) {
-       $field->{body} = $body;
-       return $body;
-     }
    }
-   push @{$self->{field}}, {name => $name, body => $body};
+   undef;
-   $body;
  }
- =head2 $self->delete ($field_name, [$index])
+ =head2 $self->delete ($field-name, [$name, ...])
  Deletes C<field> named as $field_name.
- If $index is specified, only $index'th C<field> is deleted.
- If not, ($index == 0), all C<field>s that have the C<field-name>
- $field_name are deleted.
  =cut
- sub delete ($$;$) {
-   my $self = shift;
-   my ($name, $index) = (lc shift, shift);
-   my $i = 0;
-   for my $field (@{$self->{field}}) {
-     if ($field->{name} eq $name) {
-       $i++;
-       if ($index == 0 || $i == $index) {
-         undef $field;
-         return $self if $i == $index;
-       }
-     }
-   }
-   $self;
- }
  =head2 $self->count ([$field_name])
-Line 313 
 of fields.  (Same as $#$self+1)
+Line 496 
 of fields.  (Same as $#$self+1)
  =cut
- sub count ($;$) {
+ sub _count_by_name ($$\%) {
    my $self = shift;
-   my ($name) = (lc shift);
+   my ($array, $option) = @_;
-   unless ($name) {
+   my $name = $self->_n11n_field_name ($$option{-name});
-     $self->_delete_empty_field ();
+   my @a = grep {$_->{name} eq $name} @{$self->{$array}};
-     return $#{$self->{field}}+1;
+   $#a + 1;
-   }
-   my $count = 0;
-   for my $field (@{$self->{field}}) {
-     if ($field->{name} eq $name) {
-       $count++;
-     }
-   }
-   $count;
  }
- =head2 $self->stringify ([%option])
+ ## Delete empty items
+ sub _delete_empty ($) {
+   my $self = shift;
+   my $array = $self->{option}->{_HASH_NAME};
+   $self->{$array} = [grep {ref $_ && length $_->{name}} @{$self->{$array}}];
+ }
- Returns the C<header> as a string.
+ =head2 $self->rename ($field-name, $new-name, [$old, $new,...])
+ Renames C<$field-name> as C<$new-name>.
  =cut
- sub stringify ($;%) {
+ sub rename ($%) {
    my $self = shift;
-   my %OPT = @_;
+   my %params = @_;
-   my @ret;
+   my %option = %{$self->{option}};
-   $OPT{capitalize} ||= $self->{option}->{capitalize};
+   for (grep {/^-/} keys %params) {$option{substr ($_, 1)} = $params{$_}}
-   $OPT{mail_from} ||= $self->{option}->{mail_from};
+   my %new_name;
-   $OPT{output_bcc} ||= $self->{option}->{output_bcc};
+   for (grep {/^[^-]/} keys %params) {
-   push @ret, 'From '.$self->field ('mail-from') if $OPT{mail_from}>0;
+     my ($old => $new)
-   for my $field (@{$self->{field}}) {
+       = ($self->_n11n_field_name ($_) => $self->_n11n_field_name ($params{$_}));
-     my $name = $field->{name};
+     $old =~ tr/_/-/ if $option{translate_underscore};
-     next unless $name;
+     $new =~ tr/_/-/ if $option{translate_underscore};
-     next if $OPT{mail_from}<0 && $name eq 'mail-from';
+     Carp::croak "rename: $new: invalid field-name"
-     next if $OPT{output_bcc}<0 && ($name eq 'bcc' || $name eq 'resent-bcc');
+       if $option{field_name_validation}
-     my $fbody = scalar $field->{body};
+         && $new =~ /$REG{$option{field_name_unsafe_rule}}/;
-     next unless $fbody;
+     $new_name{$old} = $new;
-     $fbody =~ s/\x0D([^\x09\x0A\x20])/\x0D\x20$1/g;
+   }
-     $fbody =~ s/\x0A([^\x09\x20])/\x0A\x20$1/g;
+   for my $field (@{$self->{value}}) {
-     $name =~ s/((?:^|-)[a-z])/uc($1)/ge if $OPT{capitalize};
+     if (length $new_name{$field->{name}}) {
-     push @ret, $name.': '.$self->fold ($fbody);
+       $field->{name} = $new_name{$field->{name}};
+     }
    }
-   my $ret = join ("\n", @ret);
+   $self if defined wantarray;
-   $ret? $ret."\n": "";
  }
- =head2 $self->get_option ($option_name)
- Returns value of the option.
+ =item $self->scan(\&doit)
- =head2 $self->set_option ($option_name, $option_value)
+ Apply a subroutine to each header field in turn.  The callback routine is
+ called with two parameters; the name of the field and a single value.
- Set new value of the option.
+ If the header has more than one value, then the routine is called once
+ for each value.
  =cut
- sub get_option ($$) {
+ sub _scan_sort ($\@\%) {
    my $self = shift;
-   my ($name) = @_;
+   my ($array, $option) = @_;
-   $self->{option}->{$name};
+   my $sort;
+   $sort = \&_header_cmp if $option->{field_sort} eq 'good-practice';
+   $sort = {$a cmp $b} if $option->{field_sort} eq 'alphabetic';
+   return ( sort $sort @$array ) if ref $sort;
+   @$array;
  }
- sub set_option ($$$) {
+ sub _n11n_field_name ($$) {
    my $self = shift;
-   my ($name, $value) = @_;
+   my $s = shift;
-   $self->{option}->{$name} = $value;
+   $s =~ s/^$REG{WSP}+//; $s =~ s/$REG{WSP}+$//;
-   $self;
+   $s = lc $s unless ${&_NS_uri2phpackage ($self->{option}->{ns_default_phuri}).'::OPTION'}{case_sensible};
+   $s;
  }
- sub field_type ($$;$) {
+ # Compare function which makes it easy to sort headers in the
+ # recommended "Good Practice" order.
+ ## taken from HTTP::Header
+ sub _header_cmp
+ {
+   my ($na, $nb) = ($a->{name}, $b->{name});
+     # Unknown headers are assign a large value so that they are
+     # sorted last.  This also helps avoiding a warning from -w
+     # about comparing undefined values.
+     $header_order{$na} = 999 unless defined $header_order{$na};
+     $header_order{$nb} = 999 unless defined $header_order{$nb};
+     $header_order{$na} <=> $header_order{$nb} || $na cmp $nb;
+ }
+ =head2 $self->stringify ([%option])
+ Returns the C<header> as a string.
+ =cut
+ sub stringify ($;%) {
    my $self = shift;
-   my $field_name = shift;
+   my %params = @_;
-   my $new_field_type = shift;
+   my %option = %{$self->{option}};
-   if ($new_field_type) {
+   $option{format} = $params{-format} if $params{-format};
-     $self->{option}->{field_type}->{$field_name} = $new_field_type;
+   $self->_init_by_format ($option{format}, \%option);
+   for (grep {/^-/} keys %params) {$option{substr ($_, 1)} = $params{$_}}
+   my @ret;
+   my $_stringify = sub {
+     no strict 'refs';
+       my ($name, $body, $nsuri) = ($_[1]->{name}, $_[1]->{body}, $_[1]->{ns});
+       return unless length $name;
+       return if $option{output_mail_from} && $name eq 'mail-from';
+       return if !$option{output_bcc} && ($name eq 'bcc' || $name eq 'resent-bcc');
+       my $nspackage = &_NS_uri2phpackage ($nsuri);
+       my $oname;        ## Outputed field-name
+       my $prefix = ${$nspackage.'::OPTION'} {namespace_phname_goodcase}
+                 || $self->{ns}->{uri2phname}->{$nsuri};
+       $prefix = undef if $nsuri eq $self->{option}->{ns_default_phuri};
+       my $gc = ${$nspackage.'::OPTION'} {to_be_goodcase};
+       if (ref $gc) { $oname = &$gc ($self, $nspackage, $name, \%option) }
+       else { $oname = $name }
+       if ($prefix) { $oname = $prefix . '-' . $oname }
+       if ($option{format} =~ /uri-url-mailto/) {
+         return if (( ${$nspackage.'::OPTION'} {uri_mailto_safe}->{$name}
+                   || ${$nspackage.'::OPTION'} {uri_mailto_safe}->{':default'})
+                   < $option{uri_mailto_safe_level});
+         if ($name eq 'to') {
+           $body = $self->field ('to', -new_item_unless_exist => 0);
+           if (ref $body && $body->have_group) {
+             #
+           } elsif (ref $body && $body->count > 1) {
+             $body = $body->clone;
+             $body->delete ({-by => 'index'}, 0);
+           }
+         }
+       }
+       my $fbody;
+       if (ref $body) {
+         $fbody = $body->stringify (-format => $option{format});
+       } else {
+         $fbody = $body;
+       }
+       return unless length $fbody;
+       unless ($option{linebreak_strict}) {
+         ## bare \x0D and bare \x0A are unsafe
+         $fbody =~ s/\x0D(?=[^\x09\x0A\x20])/\x0D\x20/g;
+         $fbody =~ s/\x0A(?=[^\x09\x20])/\x0A\x20/g;
+       } else {
+         $fbody =~ s/\x0D\x0A(?=[^\x09\x20])/\x0D\x0A\x20/g;
+       }
+       if ($option{use_folding}) {
+         if (ref $option{output_folding}) {
+           $fbody = &{$option{output_folding}} ($self, $fbody,
+             -initial_length => length ($oname) +2);
+         } elsif ($option{output_folding}) {
+           $fbody = $self->_fold ($fbody, -initial_length => length ($oname) +2);
+         }
+       }
+       push @ret, sprintf $option{field_format_pattern}, $oname, $fbody;
+     };
+   if ($option{format} =~ /uri-url-mailto/) {
+     if ($option{format} =~ /uri-url-mailto-to/) {
+       my $to = $self->field ('to', -new_item_unless_exist => 0);
+       if ($to) {
+         unless ($to->have_group) {
+           my $fbody = $to->stringify (-format => $option{format}, -max => 1);
+           return &{$option{output_folding}} ($self, $fbody);
+         }
+       }
+       '';
+     } elsif ($option{format} =~ /uri-url-mailto-rfc1738/) {
+       my $to = $self->field ('to', -new_item_unless_exist => 0);
+       if ($to) {
+         my $fbody = $to->addr_spec (-format => $option{format});
+         return &{$option{output_folding}} ($self, $fbody);
+       }
+       '';
+     } else {
+       $self->scan ($_stringify);
+       my $ret = join ('&', @ret);
+       $ret;
+     }
+   } else {
+     if ($option{output_mail_from}) {
+       my $fromline = $self->field ('mail-from', -new_item_unless_exist => 0);
+       push @ret, 'From '.$fromline if $fromline;
+     }
+     $self->scan ($_stringify);
+     my $ret = join ("\x0D\x0A", @ret);
+     $ret? $ret."\x0D\x0A": '';
    }
-   $self->{option}->{field_type}->{$field_name}
-   || $self->{option}->{field_type}->{':DEFAULT'};
  }
+ *as_string = \&stringify;
+ =head2 $self->option ($option_name, [$option_value])
+ Set/gets new value of the option.
- sub _delete_empty_field ($) {
+ =cut
+ sub option ($@) {
    my $self = shift;
-   my @ret;
+   if (@_ == 1) {
-   for my $field (@{$self->{field}}) {
+     return $self->{option}->{ shift (@_) };
-     push @ret, $field if $field->{name};
+   }
+   while (my ($name, $value) = splice (@_, 0, 2)) {
+     $self->{option}->{$name} = $value;
+     if ($name eq 'format') {
+       for my $f (@{$self->{field}}) {
+         if (ref $f->{body}) {
+           $f->{body}->option (-format => $value);
+         }
+       }
+     }
    }
-   $self->{field} = \@ret;
-   $self;
  }
- sub fold ($$;$) {
+ sub field_type ($@) {shift->SUPER::value_type (@_)}
+ ## $self->_fold ($string, %option = (-max, -initial_length(for field-name)) )
+ sub _fold ($$;%) {
    my $self = shift;
    my $string = shift;
-   my $len = shift || $self->{option}->{fold_length};
+   my %option = @_;
-   $len = 60 if $len < 60;
+   my $max = $self->{option}->{line_length_max};
+   $max = 20 if $max < 20;
-   ## This code is taken from Mail::Header 1.43 in MailTools,
-   ## by Graham Barr (Maintained by Mark Overmeer <mailtools@overmeer.net>).
-   my $max = int($len - 5);         # 4 for leading spcs + 1 for [\,\;]
-   my $min = int($len * 4 / 5) - 4;
-   my $ml = $len;
-   if (length($string) > $ml) {
+   my $l = $option{-initial_length} || 0;
-      #Split the line up
+   $string =~ s{((?:^|[\x09\x20])[^\x09\x20]+)}{
-      # first bias towards splitting at a , or a ; >4/5 along the line
+     my $s = $1;
-      # next split a whitespace
+     if ($l + length $s > $max) {
-      # else we are looking at a single word and probably don't want to split
+       $s = "\x0D\x0A\x20" . $s;
-      my $x = "";
+       $l = length ($s) - 2;
-      $x .= "$1\n    "
+     } else { $l += length $s }
-        while($string =~ s/^$REG{WSP}*(
+     $s;
-                           [^"]{$min,$max}?[\,\;]
+   }gex;
-                           |[^"]{1,$max}$REG{WSP}
-                           |[^\s"]*(?:"[^"]*"[^\s"]*)+$REG{WSP}
-                           |[^\s"]+$REG{WSP}
-                           )
-                         //x);
-      $x .= $string;
-      $string = $x;
-      $string =~ s/(\A$REG{WSP}+|$REG{WSP}+\Z)//sog;
-      $string =~ s/\s+\n/\n/sog;
-   }
    $string;
  }
+ sub _ns_load_ph ($$) {
+   my $self = shift;
+   my $name = shift;     ## normalized prefix (without HYPHEN-MINUS)
+   return if $self->{ns}->{phname2uri}->{$name};
+   $self->{ns}->{phname2uri}->{$name} = $NS_phname2uri{$name};
+   return unless $self->{ns}->{phname2uri}->{$name};
+   $self->{ns}->{uri2phname}->{$self->{ns}->{phname2uri}->{$name}} = $name;
+ }
+ sub _NS_uri2phpackage ($) {
+   $NS_uri2phpackage{$_[0]}
+   || $NS_uri2phpackage{$Message::Header::Default::OPTION{namespace_uri}};
+ }
+ =head2 $self->clone ()
+ Returns a copy of Message::Header object.
+ =cut
+ ## Inhreited
+ =head1 NOTE
+ =head2 C<field-name>
+ The header field name is not case sensitive.  To make the life
+ easier for perl users who wants to avoid quoting before the => operator,
+ you can use '_' as a synonym for '-' in header field names
+ (this behaviour can be suppressed by setting
+ C<translate_underscore> option to C<0> value).
  =head1 EXAMPLE
    ## Print field list
-Line 443 
 sub fold ($$;$) {
+Line 769 
 sub fold ($$;$) {
    use Message::Header;
    my $header = Message::Header->parse ($header);
-   ## Next sample is better.
-   #for my $field (@$header) {
-   #  print $field->{name}, "\t=> ", $field->{body}, "\n";
-   #}
    for my $i (0..$#$header) {
      print $header->field_name ($i), "\t=> ", $header->field_body ($i), "\n";
    }
-Line 470 
 sub fold ($$;$) {
+Line 791 
 sub fold ($$;$) {
    $header->add ('References' => '<hoge.msgid%foo@foo.example>');
    print $header;
+ =head1 ACKNOWLEDGEMENTS
+ Some of codes are taken from other modules such as
+ HTTP::Header, Mail::Header.
  =head1 LICENSE
  Copyright 2002 wakaba E<lt>w@suika.fam.cxE<gt>.

 Legend:



Removed from v.1.10
 


changed lines


 
Added in v.1.26
 Legend:



Removed from v.1.10
 


changed lines


 
Added in v.1.26
-Removed from v.1.10
+Added in v.1.26

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24