view release on metacpan or  search on metacpan

t/aion/annotation.t  view on Meta::CPAN

use common::sense; use open qw/:std :utf8/;  use Carp qw//; use Cwd qw//; use File::Basename qw//; use File::Find qw//; use File::Slurper qw//; use File::Spec qw//; use File::Path qw//; use Scalar::Util qw//;  use Test::More 0.98;  use String::Diff q...
# # NAME
# 
# Aion::Annotation - обрабатывает аннотации в модулях perl
# 
# # VERSION
# 
# 0.0.2-prealpha
# 
# # SYNOPSIS
# 
# Файл lib/For/Test.pm:
#@> lib/For/Test.pm
#>> package For::Test;
#>> # The package for testing
#>> #@deprecated for_test
#>> 
#>> #@deprecated
#>> #@todo add1
#>> # Is property
#>> #   readonly
#>> has abc => (is => 'ro');
#>> 
#>> #@todo add2
#>> #@param Int $a
#>> #@param Int[] $r
#>> sub xyz {}
#>> 
#>> 1;
#@< EOF
# 
subtest 'SYNOPSIS' => sub { 
use Aion::Annotation;

Aion::Annotation->new->scan;

open my $f, '<', 'var/cache/modules.mtime.ini' or die $!; my @modules_mtime = <$f>; chop for @modules_mtime; close $f;
open my $f, '<', 'etc/annotation/remarks.ini' or die $!; my @remarks = <$f>; chop for @remarks; close $f;
open my $f, '<', 'etc/annotation/todo.ann' or die $!; my @todo = <$f>; chop for @todo; close $f;
open my $f, '<', 'etc/annotation/deprecated.ann' or die $!; my @deprecated = <$f>; chop for @deprecated; close $f;
open my $f, '<', 'etc/annotation/param.ann' or die $!; my @param = <$f>; chop for @param; close $f;

local ($::_g0 = do {0+@modules_mtime}, $::_e0 = do {1}); ::ok defined($::_g0) == defined($::_e0) && $::_g0 eq $::_e0, '0+@modules_mtime  # -> 1' or ::diag ::_struct_diff($::_g0, $::_e0); undef $::_g0; undef $::_e0;
::like scalar do {$modules_mtime[0]}, qr{^For::Test=\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d$}, '$modules_mtime[0] # ~> ^For::Test=\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d$'; undef $::_g0; undef $::_e0;
local ($::_g0 = do {\@remarks}, $::_e0 = do {['For::Test#,4=The package for testing', 'For::Test#abc,9=Is property\n  readonly']}); ::is_deeply $::_g0, $::_e0, '\@remarks         # --> [\'For::Test#,4=The package for testing\', \'For::Test#abc,9=Is p...
local ($::_g0 = do {\@todo}, $::_e0 = do {['For::Test#abc,6=add1', 'For::Test#xyz,11=add2']}); ::is_deeply $::_g0, $::_e0, '\@todo            # --> [\'For::Test#abc,6=add1\', \'For::Test#xyz,11=add2\']' or ::diag ::_struct_diff($::_g0, $::_e0); undef...
local ($::_g0 = do {\@deprecated}, $::_e0 = do {['For::Test#,3=for_test', 'For::Test#abc,5=']}); ::is_deeply $::_g0, $::_e0, '\@deprecated      # --> [\'For::Test#,3=for_test\', \'For::Test#abc,5=\']' or ::diag ::_struct_diff($::_g0, $::_e0); undef $...
local ($::_g0 = do {\@param}, $::_e0 = do {['For::Test#xyz,12=Int $a', 'For::Test#xyz,13=Int[] $r']}); ::is_deeply $::_g0, $::_e0, '\@param           # --> [\'For::Test#xyz,12=Int $a\', \'For::Test#xyz,13=Int[] $r\']' or ::diag ::_struct_diff($::_g0,...

# 
# # DESCRIPTION
# 
# `Aion::Annotation` сканирует модули perl в каталоге **lib** и распечатывает их в соответстующие файлы в каталоге **etc/annotation**.
# 
# Сменить **lib** можно через конфиг `LIB`, а **etc/annotation** через конфиг `INI`.
# 
# 1. В **modules.mtime.ini** хранятся времена последнего обновления модулей.
# 2. В **remarks.ini** сохраняются комментарии к подпрограммам, свойствам и пакетам.
# 3. В файлах **имя.ann** сохраняются аннотации по своим именам.
# 
# # SUBROUTINES/METHODS