briandfoy/sourcecode-linecounter-perl
GitHub: briandfoy/sourcecode-linecounter-perl
专为 Perl 源代码设计的行数与字符统计模块,能准确区分代码、注释、POD 文档和空白行。
Stars: 3 | Forks: 1
=pod
=encoding utf8
=for HTML
=for HTML
=for HTML
=for HTML
=for HTML
=for HTML
=for HTML
=head1 SourceCode::LineCounter::Perl 模块
这是 L Perl 模块的 I。你之所以看这个,大概是因为不知道去哪里找你要的东西。读一遍这个,你可能再也不用读任何 Perl 模块的 README 了。
=head2 文档
要了解 L,请查看模块本身的嵌入式文档。在发行版内部,你可以用 L 格式化查看:
```
% perldoc lib/SourceCode/LineCounter/Perl.pm
```
如果你已经安装了该模块,可以指定模块名而不是文件路径:
```
% perldoc SourceCode::LineCounter::Perl
```
你可以阅读文档并查阅 L 上的元数据。
标准模块文档在 SYNOPSIS 部分有示例用法,你也可以查看 I 目录(如果有),或者查看 I 中的测试文件。
=head2 安装
你可以使用 CPAN 客户端安装此模块,它会解析并安装依赖项:
```
% cpan SourceCode::LineCounter::Perl
% cpanm SourceCode::LineCounter::Perl
```
你也可以直接从分发目录安装,这同样会安装依赖项:
```
% cpan .
% cpanm .
```
你可以手动安装此模块:
```
% perl Makefile.PL
% make
% make test
% make install
```
除非你在折腾这个模块并且只想运行测试而不安装任何东西,否则你可能不想这么做。
=head2 源码位置
元数据(例如源仓库和 Bug 追踪器)位于 I 或它创建的 I 文件中。你可以在 CPAN Web 界面上找到这些信息,也可以直接在源仓库中查看文件:L
如果你发现问题,请在 L 中提交工单。
还有托管在其他服务上的备份仓库。这些反映了主仓库的状态,仅用于冗余:
=over 4
=item * L
=item * L
=item * L
=back
=head2 GitHub Attestations
此发行版现在使用 L ,它允许你验证你拥有的存档文件是否来自官方仓库。
你需要一个 GitHub 账户和 L。
```
# 从 GitHub、MetaCPAN 或 CPAN 镜像下载 distro 文件
$ gh auth login
...follow instructions...
$ gh attestation verify SourceCode-LineCounter-Perl-1.23.tar.gz --owner briandfoy
```
=head2 获取帮助
虽然我很乐意在私人邮件中听取模块用户的意见,但这对我来说是最容易忘记做事的方式。
除了 Issue 追踪器,你还可以在 L 或 L 寻求帮助,这两个地方都有很多能干的 Perl 程序员可以几乎实时地回答你的问题。
他们可能不知道这个模块的细节,但可以帮助你诊断问题。
你可能想读一读 L 。
=head2 版权和许可
你应该收到了一份 I 文件,但许可证也在模块文件中注明。你唯一不能做的就是假装你写了你没写的代码。
=head2 祝你好运!
享受吧,
brian d foy, briandfoy@pobox.com
=cut
标签:CPAN模块, Perl, SourceCode-LineCounter-Perl, 云安全监控, 代码度量, 代码统计, 文本处理, 源代码分析, 编程语言Perl, 行数计算, 解析器, 静态分析