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 Coverage Status =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, 行数计算, 解析器, 静态分析