rt/sbin/rt-attributes-viewer.in

   1 #!@PERL@
   2 # BEGIN BPS TAGGED BLOCK {{{
   3 #
   4 # COPYRIGHT:
   5 #
   6 # This software is Copyright (c) 1996-2014 Best Practical Solutions, LLC
   7 #                                          <sales@bestpractical.com>
   8 #
   9 # (Except where explicitly superseded by other copyright notices)
  10 #
  11 #
  12 # LICENSE:
  13 #
  14 # This work is made available to you under the terms of Version 2 of
  15 # the GNU General Public License. A copy of that license should have
  16 # been provided with this software, but in any event can be snarfed
  17 # from www.gnu.org.
  18 #
  19 # This work is distributed in the hope that it will be useful, but
  20 # WITHOUT ANY WARRANTY; without even the implied warranty of
  21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  22 # General Public License for more details.
  23 #
  24 # You should have received a copy of the GNU General Public License
  25 # along with this program; if not, write to the Free Software
  26 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  27 # 02110-1301 or visit their web page on the internet at
  28 # http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
  29 #
  30 #
  31 # CONTRIBUTION SUBMISSION POLICY:
  32 #
  33 # (The following paragraph is not intended to limit the rights granted
  34 # to you to modify and distribute this software under the terms of
  35 # the GNU General Public License and is only of importance to you if
  36 # you choose to contribute your changes and enhancements to the
  37 # community by submitting them to Best Practical Solutions, LLC.)
  38 #
  39 # By intentionally submitting any modifications, corrections or
  40 # derivatives to this work, or any other work intended for use with
  41 # Request Tracker, to Best Practical Solutions, LLC, you confirm that
  42 # you are the copyright holder for those contributions and you grant
  43 # Best Practical Solutions,  LLC a nonexclusive, worldwide, irrevocable,
  44 # royalty-free, perpetual, license to use, copy, create derivative
  45 # works based on those contributions, and sublicense and distribute
  46 # those contributions and any derivatives thereof.
  47 #
  48 # END BPS TAGGED BLOCK }}}
  49 use strict;
  50 use warnings;
  51
  52 # fix lib paths, some may be relative
  53 BEGIN {
  54     require File::Spec;
  55     my @libs = ("@RT_LIB_PATH@", "@LOCAL_LIB_PATH@");
  56     my $bin_path;
  57
  58     for my $lib (@libs) {
  59         unless ( File::Spec->file_name_is_absolute($lib) ) {
  60             unless ($bin_path) {
  61                 if ( File::Spec->file_name_is_absolute(__FILE__) ) {
  62                     $bin_path = ( File::Spec->splitpath(__FILE__) )[1];
  63                 }
  64                 else {
  65                     require FindBin;
  66                     no warnings "once";
  67                     $bin_path = $FindBin::Bin;
  68                 }
  69             }
  70             $lib = File::Spec->catfile( $bin_path, File::Spec->updir, $lib );
  71         }
  72         unshift @INC, $lib;
  73     }
  74 }
  75
  76 use Getopt::Long;
  77 my %opt;
  78 GetOptions( \%opt, 'help|h', );
  79
  80 my $id = shift;
  81
  82 if ( $opt{help} || !$id ) {
  83     require Pod::Usage;
  84     Pod::Usage::pod2usage({ verbose => 2 });
  85     exit;
  86 }
  87
  88 require RT;
  89 RT::LoadConfig();
  90 RT::Init();
  91
  92 require RT::Attribute;
  93 my $attr = RT::Attribute->new( RT->SystemUser );
  94 $attr->Load( $id );
  95 unless ( $attr->id ) {
  96     print STDERR "Couldn't load attribute #$id\n";
  97     exit 1;
  98 }
  99
 100 my %res = ();
 101 $res{$_} = $attr->$_() foreach qw(ObjectType ObjectId Name Description Content ContentType);
 102
 103 use Data::Dumper;
 104 print "Content of attribute #$id: ". Dumper( \%res );
 105
 106 __END__
 107
 108 =head1 NAME
 109
 110 rt-attributes-viewer - show the content of an attribute
 111
 112 =head1 SYNOPSIS
 113
 114     # show the content of attribute 2
 115     rt-attributes-viewer 2
 116
 117 =head1 DESCRIPTION
 118
 119 This script deserializes and print content of an attribute defined
 120 by <attribute id>. May be useful for developers and for troubleshooting
 121 problems.
 122