Bug 2004984 - Review Request: ant-antunit - Unit Test Framework for Ant Tasks
Summary: Review Request: ant-antunit - Unit Test Framework for Ant Tasks
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Jerry James
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks: FE-JAVASIG 1987366
TreeView+ depends on / blocked
 
Reported: 2021-09-16 14:19 UTC by Didik Supriadi
Modified: 2021-12-16 04:23 UTC (History)
3 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2021-12-16 04:23:19 UTC
Type: ---
Embargoed:
loganjerry: fedora-review+


Attachments (Terms of Use)

Description Didik Supriadi 2021-09-16 14:19:59 UTC
Spec URL: https://didiksupriadi41.fedorapeople.org/ant-antunit.spec
SRPM URL: https://didiksupriadi41.fedorapeople.org/ant-antunit-1.4.1-1.fc34.src.rpm

Description:
This library contains tasks that enables Ant task developers to test their tasks
with Ant and without JUnit.  It contains a few assertion tasks and an antunit
task that runs build files instead of test classes and is modelled after the
JUnit task.

Fedora Account System Username: didiksupriadi41

Comment 1 Didik Supriadi 2021-09-16 14:20:02 UTC
This package built on koji:  https://koji.fedoraproject.org/koji/taskinfo?taskID=75790516

Comment 2 Didik Supriadi 2021-10-19 18:42:09 UTC
Spec URL: https://didiksupriadi41.fedorapeople.org/ant-antunit.spec
SRPM URL: https://didiksupriadi41.fedorapeople.org/ant-antunit-1.4.1-1.fc34.src.rpm

This package is a requirement for apache-rat that is currently FTBFS.

Comment 3 Jerry James 2021-12-12 17:28:06 UTC
I will take this review.

Comment 4 Jerry James 2021-12-12 17:30:16 UTC
Package Review
==============

Legend:
[x] = Pass, [!] = Fail, [-] = Not applicable, [?] = Not evaluated

Issues:
=======
- See the remark below: "Note: gpgverify is not the first command in %prep."
  If the source file fails to verify, then it shouldn't be unpacked.  Swap the
  order of %autosetup and %gpgverify.

- Is running the tests a possibility?

===== MUST items =====

Generic:
[x]: Package is licensed with an open-source compatible license and meets
     other legal requirements as defined in the legal section of Packaging
     Guidelines.
[x]: License field in the package spec file matches the actual license.
     Note: Checking patched sources after %prep for licenses. Licenses
     found: "Unknown or generated", "*No copyright* Apache License 2.0". 14
     files have unknown license.
[x]: Package contains no bundled libraries without FPC exception.
[x]: Changelog in prescribed format.
[x]: Sources contain only permissible code or content.
[-]: Package contains desktop file if it is a GUI application.
[-]: Development files must be in a -devel package
[x]: Package uses nothing in %doc for runtime.
[x]: Package consistently uses macros (instead of hard-coded directory
     names).
[x]: Package is named according to the Package Naming Guidelines.
[x]: Package does not generate any conflict.
[x]: Package obeys FHS, except libexecdir and /usr/target.
[-]: If the package is a rename of another package, proper Obsoletes and
     Provides are present.
[x]: Requires correct, justified where necessary.
[x]: Spec file is legible and written in American English.
[-]: Package contains systemd file(s) if in need.
[x]: Package is not known to require an ExcludeArch tag.
[x]: Package complies to the Packaging Guidelines
[x]: Package successfully compiles and builds into binary rpms on at least
     one supported primary architecture.
[x]: Package installs properly.
[x]: Rpmlint is run on all rpms the build produces.
     Note: There are rpmlint messages (see attachment).
[x]: If (and only if) the source package includes the text of the
     license(s) in its own file, then that file, containing the text of the
     license(s) for the package is included in %license.
[x]: Package requires other packages for directories it uses.
[x]: Package must own all directories that it creates.
[x]: Package does not own files or directories owned by other packages.
[x]: Package uses either %{buildroot} or $RPM_BUILD_ROOT
[x]: Package does not run rm -rf %{buildroot} (or $RPM_BUILD_ROOT) at the
     beginning of %install.
[x]: Macros in Summary, %description expandable at SRPM build time.
[x]: Dist tag is present.
[x]: Package does not contain duplicates in %files.
[x]: Permissions on files are set properly.
[x]: Package must not depend on deprecated() packages.
[x]: Package use %makeinstall only when make install DESTDIR=... doesn't
     work.
[x]: Package is named using only allowed ASCII characters.
[x]: Package is not relocatable.
[x]: Sources used to build the package match the upstream source, as
     provided in the spec URL.
[x]: Spec file name must match the spec package %{name}, in the format
     %{name}.spec.
[x]: File names are valid UTF-8.
[x]: Large documentation must go in a -doc subpackage. Large could be size
     (~1MB) or number of files.
     Note: Documentation size is 0 bytes in 0 files.
[x]: Packages must not store files under /srv, /opt or /usr/local

Java:
[x]: Bundled jar/class files should be removed before build
[x]: Packages have proper BuildRequires/Requires on javapackages-tools
     (jpackage-utils)
     Note: Maven packages do not need to (Build)Require jpackage-utils. It
     is pulled in by maven-local

Maven:
[x]: If package contains pom.xml files install it (including metadata) even
     when building with ant
[x]: POM files have correct Maven mapping
[x]: Maven packages should use new style packaging
[x]: Old add_to_maven_depmap macro is not being used
[x]: Packages DO NOT have Requires(post) and Requires(postun) on jpackage-
     utils for %update_maven_depmap macro
[x]: Package DOES NOT use %update_maven_depmap in %post/%postun
[x]: Packages use .mfiles file list instead of %{_datadir}/maven2/poms

===== SHOULD items =====

Generic:
[-]: If the source package does not include license text(s) as a separate
     file from upstream, the packager SHOULD query upstream to include it.
[x]: Final provides and requires are sane (see attachments).
[?]: Package functions as described.
[x]: Latest version is packaged.
[x]: Package does not include license text files separate from upstream.
[x]: Sources are verified with gpgverify first in %prep if upstream
     publishes signatures.
     Note: gpgverify is not the first command in %prep.
[-]: Description and summary sections in the package spec file contains
     translations for supported Non-English languages, if available.
[x]: Package should compile and build into binary rpms on all supported
     architectures.
[!]: %check is present and all tests pass.
[x]: Packages should try to preserve timestamps of original installed
     files.
[x]: Reviewer should test that the package builds in mock.
[x]: Buildroot is not present
[x]: Package has no %clean section with rm -rf %{buildroot} (or
     $RPM_BUILD_ROOT)
[x]: No file requires outside of /etc, /bin, /sbin, /usr/bin, /usr/sbin.
[x]: Packager, Vendor, PreReq, Copyright tags should not be in spec file
[x]: Sources can be downloaded from URI in Source: tag
[x]: SourceX is a working URL.
[x]: Spec use %global instead of %define unless justified.

Java:
[x]: Package uses upstream build method (ant/maven/etc.)
[x]: Packages are noarch unless they use JNI

===== EXTRA items =====

Generic:
[x]: Rpmlint is run on all installed packages.
     Note: There are rpmlint messages (see attachment).
[x]: Spec file according to URL is the same as in SRPM.


Rpmlint
-------
================================================ rpmlint session starts ================================================
rpmlint: 2.1.0
configuration:
    /usr/lib/python3.10/site-packages/rpmlint/configdefaults.toml
    /etc/xdg/rpmlint/fedora.toml
    /etc/xdg/rpmlint/licenses.toml
    /etc/xdg/rpmlint/scoring.toml
    /etc/xdg/rpmlint/users-groups.toml
    /etc/xdg/rpmlint/warn-on-functions.toml
checks: 31, packages: 3

ant-antunit-javadoc.noarch: W: package-with-huge-docs:  99%
ant-antunit.noarch: W: no-documentation
ant-antunit-javadoc.noarch: E: files-duplicated-waste 287630
ant-antunit-javadoc.noarch: W: files-duplicate /usr/share/javadoc/ant-antunit/jquery/jquery-3.5.1.js /usr/share/javadoc/ant-antunit/jquery/external/jquery/jquery.js
ant-antunit-javadoc.noarch: W: file-not-utf8 /usr/share/javadoc/ant-antunit/member-search-index.zip
ant-antunit-javadoc.noarch: W: file-not-utf8 /usr/share/javadoc/ant-antunit/package-search-index.zip
ant-antunit-javadoc.noarch: W: file-not-utf8 /usr/share/javadoc/ant-antunit/type-search-index.zip
================= 2 packages and 1 specfiles checked; 1 errors, 6 warnings, 1 badness; has taken 0.2 s =================


Rpmlint (installed packages)
----------------------------
================================================ rpmlint session starts ================================================
rpmlint: 2.2.0
configuration:
    /usr/lib/python3.10/site-packages/rpmlint/configdefaults.toml
    /etc/xdg/rpmlint/fedora.toml
    /etc/xdg/rpmlint/licenses.toml
    /etc/xdg/rpmlint/scoring.toml
    /etc/xdg/rpmlint/users-groups.toml
    /etc/xdg/rpmlint/warn-on-functions.toml
checks: 32, packages: 2

ant-antunit-javadoc.noarch: W: package-with-huge-docs:  99%
ant-antunit.noarch: W: no-documentation
ant-antunit-javadoc.noarch: E: files-duplicated-waste 287630
ant-antunit-javadoc.noarch: W: files-duplicate /usr/share/javadoc/ant-antunit/jquery/jquery-3.5.1.js /usr/share/javadoc/ant-antunit/jquery/external/jquery/jquery.js
ant-antunit-javadoc.noarch: W: file-not-utf8 /usr/share/javadoc/ant-antunit/member-search-index.zip
ant-antunit-javadoc.noarch: W: file-not-utf8 /usr/share/javadoc/ant-antunit/package-search-index.zip
ant-antunit-javadoc.noarch: W: file-not-utf8 /usr/share/javadoc/ant-antunit/type-search-index.zip
================= 2 packages and 0 specfiles checked; 1 errors, 6 warnings, 1 badness; has taken 0.1 s =================



Source checksums
----------------
https://archive.apache.org/dist/ant/KEYS :
  CHECKSUM(SHA256) this package     : c4bb9a81a4330dfed089afb72975fdc1d71f77760db64b03317121d831157987
  CHECKSUM(SHA256) upstream package : c4bb9a81a4330dfed089afb72975fdc1d71f77760db64b03317121d831157987
https://archive.apache.org/dist/ant/antlibs/antunit/source/apache-ant-antunit-1.4.1-src.tar.bz2.asc :
  CHECKSUM(SHA256) this package     : d7893f613bd648134b008f7f71b34abcaaee0b58f79e5397e4064bbfe5b8f883
  CHECKSUM(SHA256) upstream package : d7893f613bd648134b008f7f71b34abcaaee0b58f79e5397e4064bbfe5b8f883
https://archive.apache.org/dist/ant/antlibs/antunit/source/apache-ant-antunit-1.4.1-src.tar.bz2 :
  CHECKSUM(SHA256) this package     : 84afe6ee3c42b2165aa129f3730972634b9d3d8d774e5cf1fcccc739cec42e2f
  CHECKSUM(SHA256) upstream package : 84afe6ee3c42b2165aa129f3730972634b9d3d8d774e5cf1fcccc739cec42e2f


Requires
--------
ant-antunit (rpmlib, GLIBC filtered):
    (java-headless or java-11-headless)
    javapackages-filesystem
    mvn(org.apache.ant:ant)



Provides
--------
ant-antunit:
    ant-antunit
    mvn(org.apache.ant:ant-antunit)
    mvn(org.apache.ant:ant-antunit:pom:)



Generated by fedora-review 0.7.6 (b083f91) last change: 2020-11-10
Command line :/usr/bin/fedora-review -b 2004984 -m fedora-rawhide-x86_64
Buildroot used: fedora-rawhide-x86_64
Active plugins: Shell-api, Java, Generic
Disabled plugins: Haskell, PHP, Ocaml, SugarActivity, R, Python, Perl, fonts, C/C++, Ruby
Disabled flags: EPEL6, EPEL7, DISTTAG, BATCH, EXARCH

Comment 5 Fabio Valentini 2021-12-12 18:06:58 UTC
Sorry for a possibly unrelated comment here. But I just noticed in the rpmlint output that the javadoc packages seen to bundle jQuery? Does that happen with every Java package or only here? And it should probably be either switched out with system jQuery or be declared as bundled.

Comment 6 Jerry James 2021-12-12 19:48:34 UTC
That's an artifact of using the javadoc tool.  Several of our document generators (javadoc, python3-sphinx, and doxygen, at least) bundle jQuery into their output.  At this point the number of documentation packages that contain a bundled copy of jQuery is quite large.

Where to find jQuery in the sources:
- OpenJDK: src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/resources/jquery
- Sphinx: sphinx/themes/basic/static
- doxygen: jquery

Comment 7 Didik Supriadi 2021-12-13 14:24:32 UTC
Spec URL: https://didiksupriadi41.fedorapeople.org/ant-antunit.spec
SRPM URL: https://didiksupriadi41.fedorapeople.org/ant-antunit-1.4.1-2.fc35.src.rpm

Changelog:
- Swap the order of gpgverify and autosetup
- Enable tests


The tests are executed individually because I don't know how to configure maven-surefire-plugin of this project.

Comment 8 Jerry James 2021-12-13 18:53:55 UTC
That's fine.  This package is APPROVED.

Comment 9 Didik Supriadi 2021-12-13 19:34:58 UTC
Thanks for the review, Jerry!


Note You need to log in before you can comment on or make changes to this bug.