Bug 1062920 - Review Request: rubygem-amq-protocol - AMQP 0.9.1 encoder & decoder
Summary: Review Request: rubygem-amq-protocol - AMQP 0.9.1 encoder & decoder
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
unspecified
medium
Target Milestone: ---
Assignee: Mo Morsi
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2014-02-08 17:50 UTC by Nitesh Narayan Lal
Modified: 2015-03-18 06:21 UTC (History)
4 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2015-03-18 04:31:58 UTC
Type: ---
Embargoed:
niteshnarayanlalleo: fedora-review+


Attachments (Terms of Use)

Description Nitesh Narayan Lal 2014-02-08 17:50:30 UTC
Spec URL: https://fedoraproject.org/wiki/File:Rubygem-amq-protocol.spec
SRPM URL: https://fedoraproject.org/wiki/File:Rubygem-amq-protocol-1.9.2-1.fc19.src.rpm
Description: 
amq-protocol is an AMQP 0.9.1 serialization library for Ruby. It is not an AMQP client: amq-protocol only handles serialization and deserialization.
If you want to write your own AMQP client, this gem can help you with that.
Fedora Account System Username:
niteshnarayan

Comment 2 Mo Morsi 2014-02-14 21:25:01 UTC
Taking this one. Note Nitesh needs sponsorship.

Overall package looks good, some nits

- Please update this bug summary in include the package summary not the package description

- Also for your other submissions the bug summary needs to include the full package name, eg 'rubygem-foo' not just 'foo' (this one is fine)

- The %check section should appear after the %install section and before the %files section

- Consider adding the following to the %install section

> pushd %{buildroot}%{gem_instdir}/
> rm -rf Rakefile amq-protocol.gemspec benchmarks \
>        .gitignore .travis.yml .rspec codegen profiling \
>        generate.rb .gitmodules
> popd


and removing the following from the %files sections

< %exclude %{gem_instdir}/Rakefile
< %exclude %{gem_instdir}/amq-protocol.gemspec
< %exclude %{gem_instdir}/benchmarks/*
< %exclude %{gem_instdir}/.gitignore
< %exclude %{gem_instdir}/.travis.yml
< %exclude %{gem_instdir}/.rspec

< %{gem_instdir}/codegen/*
< %{gem_instdir}/profiling/*
< %{gem_instdir}/generate.rb
< %{gem_instdir}/.gitmodules


- Currently the spec suite pulls in bundler and effin_utf8, both of which are unecessary deps (and in the later case not in fedora). Please add to the %check section right after the pushd but before the rspec

> sed -i /effin_utf8/d Gemfile
> sed -i /effin_utf8/d spec/spec_helper.rb
> sed -i /bundler/d spec/spec_helper.rb


- The %{gem_cache} file needs to be marked as %exclude

- The LICENSE file should be in the main package (not the 'doc' subpackage and _not_ marked as %doc)

- Please add spacing in your changelog entry (eg between your name and email and between the '-' and 'initial package'). See other specs for the correct format. (may seem small but there are often tools that parse this stuff)


Other than that package looks good and was able to koji it up. Once you make these changes and post the updated spec and srpm (make sure to bump the release and add a new changelog entry) I'll do the official review using fedora-review.

http://koji.fedoraproject.org/koji/taskinfo?taskID=6532053

Comment 3 Achilleas Pipinellis 2014-02-20 21:39:18 UTC
(In reply to Mo Morsi from comment #2)
> - The LICENSE file should be in the main package (not the 'doc' subpackage
> and _not_ marked as %doc)
> 

Sorry for hijacking, but I noticed you wrote the license file should not marked as %doc. 

Currently, this is how I do it and how many others as well (from a quick look in rubygems at dist-git). Also, this is not documented anywhere I looked in packaging guidelines and all the packaging examples in the wiki put license under %doc. 

After reading the maximum rpm [0] though, I have to say that you have a point.

[0] http://www.rpm.org/max-rpm/s1-rpm-inside-files-list-directives.html

Comment 4 Mo Morsi 2014-02-21 12:54:59 UTC
Apologies, I misremembered and  got it backwards, it should be included as %doc:

https://fedoraproject.org/wiki/Packaging:ReviewGuidelines#Things_To_Check_On_Review (see the line about the license file)

Good catch

Comment 5 Achilleas Pipinellis 2014-02-21 14:33:50 UTC
Oh yeah, you're right I missed that page :)

Comment 6 Nitesh Narayan Lal 2014-02-22 15:37:47 UTC
SPEC:http://niteshnarayan.fedorapeople.org/SPECS/rubygem-amq-protocol-1.9.2-2.spec
SRPM: http://niteshnarayan.fedorapeople.org/SRPMS/rubygem-amq-protocol-1.9.2-1.fc19.src.rpm
Thanks for the comments, I had made the changes accordingly.

Comment 7 Achilleas Pipinellis 2014-02-22 17:12:15 UTC
(In reply to Nitesh Narayan Lal from comment #6)
> SPEC:http://niteshnarayan.fedorapeople.org/SPECS/rubygem-amq-protocol-1.9.2-
> 2.spec

Hmm, wrong SPEC url. I see that the correct one is http://niteshnarayan.fedorapeople.org/SPECS/rubygem-amq-protocol.spec

You may want to resubmit both the SPEC/SRPM in order for the fedora-review tool to pick them ;)

Also, as Mo suggested

> - Please update this bug summary in include the package summary not the package > description

I changed the bug summary for you to include the rubygem's Summary.

Comment 8 Mo Morsi 2014-03-02 11:36:07 UTC
Hey Nitesh, just getting back to this. Some more feedback.

- You added a new changelog entry for the release but didn't bump the release near the top. When you do so the SRPM that will be generated will be named "rubygem-amq-protocol-1.9.2-2.srpm"

- In the "%files doc" list there should be list line "%{gem_instdir}/spec/" instead of "%{gem_instdir}/spec/*". The former includes the directory and all files in it, the later just includes all files in it

- "Updated as per the comments" in your changelog entry is a bit ambiguous for future contributors / maintainers. Perhaps some like "updated from Fedora review feedback" would be more direct (people can search bugzilla from there)

Make sure to bump the release to '3' and add a new changelog entry after the above changes. Also like Achilleas mentioned, the links to the 'rubygem-amq-protocol.spec' and 'rubygem-amq-protocol-1.9.2-3.sprm' files should be in the comment so fedora-review will pick them up

https://fedorahosted.org/FedoraReview/

Thanks

Comment 9 Nitesh Narayan Lal 2015-03-18 04:31:58 UTC
I won't be able to work on this due to time deficiency, sorry for the delay.


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