Bug 1353606 - Review Request: python-pytoml - Parser for TOML
Summary: Review Request: python-pytoml - Parser for TOML
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: mulhern
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-07-07 14:35 UTC by Julien Enselme
Modified: 2016-07-23 00:19 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-07-22 18:23:09 UTC
Type: ---
Embargoed:
amulhern: fedora-review+


Attachments (Terms of Use)
review file (6.54 KB, text/plain)
2016-07-11 16:53 UTC, mulhern
no flags Details

Description Julien Enselme 2016-07-07 14:35:58 UTC
Spec URL: http://dl.jujens.eu/SPECS/python-pytoml.spec
SRPM URL: http://dl.jujens.eu/SRPMS/python-pytoml-0.1.10-1.gitd883c7c.fc24.src.rpm
Description:
A parser for TOML-0.4.0

Fedora Account System Username: jujens

Comment 1 mulhern 2016-07-07 16:05:56 UTC
Hi!

Why is this desirable when there is python-toml package in Fedora currently?

(I'm looking to do a review swap for https://bugzilla.redhat.com/show_bug.cgi?id=1343608, but I want to make sure that this isn't just an oversight.)

Thanks,

- mulhern

Comment 2 Julien Enselme 2016-07-07 16:48:09 UTC
> I want to make sure that this isn't just an oversight.

It's not an oversight. I am the maintainer of python-toml.

> Why is this desirable when there is python-toml package in Fedora currently?

I initially used python-toml in my applications. But the support for TOML 4 is not complete. I tried to improve it (I contributed for inline object support) but the maintainer is slow to respond and still hasn't published a new version with this support. Furthermore, I find the code hard to read and modify. From what I looked at pytoml, it is better written, has a better support of toml including edge cases.

I'd recommend python-pytoml but for some usage, python-toml will do the trick just fine (I find it a little easier to use). That's why I'll keep maintaining it for the foreseeable future.

Comment 3 Julien Enselme 2016-07-07 16:48:28 UTC
Forgot to mention, I am OK for the review swap.

Comment 4 mulhern 2016-07-07 18:39:13 UTC
(In reply to Julien Enselme from comment #2)
> > I want to make sure that this isn't just an oversight.
> 
> It's not an oversight. I am the maintainer of python-toml.
>
> > Why is this desirable when there is python-toml package in Fedora currently?
> 
> I initially used python-toml in my applications. But the support for TOML 4
> is not complete. I tried to improve it (I contributed for inline object
> support) but the maintainer is slow to respond and still hasn't published a
> new version with this support. Furthermore, I find the code hard to read and
> modify. From what I looked at pytoml, it is better written, has a better
> support of toml including edge cases.
> 
> I'd recommend python-pytoml but for some usage, python-toml will do the
> trick just fine (I find it a little easier to use). That's why I'll keep
> maintaining it for the foreseeable future.

Great, that makes sense.

And thanks for agreeing to the swap!

Comment 5 mulhern 2016-07-11 15:17:51 UTC
I think it would be helpful to put what you told me in Comment #2 in the spec file as a comment, to make it as clear as possible why there are two packages that seem to provide the same functionality in Fedora.

Comment 6 mulhern 2016-07-11 16:24:19 UTC
Typo: ^unversinned^unversioned

Comment 7 mulhern 2016-07-11 16:46:18 UTC
Would be good to justify git release, as opposed to taking a published release from pypi: https://pypi.python.org/pypi/pytoml. I can't see any reason, actually.

Comment 8 mulhern 2016-07-11 16:53:39 UTC
Created attachment 1178487 [details]
review file

Completed review template.

Comment 9 mulhern 2016-07-11 16:55:34 UTC
Other than Comment #5, Comment #6, Comment #7 it looks good.

Comment 10 Igor Gnatenko 2016-07-11 17:09:18 UTC
(In reply to mulhern from comment #7)
> Would be good to justify git release, as opposed to taking a published
> release from pypi: https://pypi.python.org/pypi/pytoml. I can't see any
> reason, actually.
always better to take "real source" from github, not "precompiled source" from PyPI.

Comment 11 mulhern 2016-07-11 17:31:07 UTC
(In reply to Igor Gnatenko from comment #10)
> (In reply to mulhern from comment #7)
> > Would be good to justify git release, as opposed to taking a published
> > release from pypi: https://pypi.python.org/pypi/pytoml. I can't see any
> > reason, actually.
> always better to take "real source" from github, not "precompiled source"
> from PyPI.

I have been taught other way. Could you point me at docs/explanation?

Comment 12 mulhern 2016-07-11 17:45:39 UTC
Actually, if doing the install from github, it should be easy to run the tests as a %check using the instructions in the upstream README.

Comment 13 Julien Enselme 2016-07-11 18:54:32 UTC
> I think it would be helpful to put what you told me in Comment #2 in the spec file as a comment, to make it as clear as possible why there are two packages that seem to provide the same functionality in Fedora.

Done.

> Typo: ^unversinned^unversioned

In fact, this comment is useless here. I did a copy/paste from another SPEC in which it was. I'll correct the type there. Comment removed.

> Would be good to justify git release, as opposed to taking a published release from pypi: https://pypi.python.org/pypi/pytoml.

I tend to prefer pypi (no need to bother about commits) and remove pre built egg-info. However, here the license file was missing in the zip file from pypi. So I chose github. I just added a comment for that.

> Actually, if doing the install from github, it should be easy to run the tests as a %check using the instructions in the upstream README.

Sadly no. We can't just use git submodules because it requires network access and pull code that is not from the package. The good way to do this would be to package the go program that include the tests file. I did that for python-toml that rely on golang-github-BurntSushi-toml-test. The problem is pytoml cannot pass this suite since it is outdated. The maintainer of pytoml uses his own fork of golang-github-BurntSushi-toml-test which has no release. So until improvement on that side, I think it's better not to run check within %check and trust the upstream maintainer not to release broken stuff.

Adding a comment about that in the SPEC for future information.

SPEC: http://dl.jujens.eu/SPECS/python-pytoml.spec
SRPM: http://dl.jujens.eu/SRPMS/python-pytoml-0.1.10-2.gitd883c7c.fc24.src.rpm

Comment 14 Igor Gnatenko 2016-07-11 19:30:34 UTC
(In reply to mulhern from comment #11)
> (In reply to Igor Gnatenko from comment #10)
> > (In reply to mulhern from comment #7)
> > > Would be good to justify git release, as opposed to taking a published
> > > release from pypi: https://pypi.python.org/pypi/pytoml. I can't see any
> > > reason, actually.
> > always better to take "real source" from github, not "precompiled source"
> > from PyPI.
> 
> I have been taught other way. Could you point me at docs/explanation?

let me show example:
we have some module which uses Cython which means real source is *.pyx and *.pxi, but usually maintainer of module uploads archive just with already cythonized version (auto-generated *.c files) which can contain bugs due to broken cython on developer machine. sometimes they ship *.pyx files as well, but often I have to manually remove *.c files to really use my Cython.

Comment 15 mulhern 2016-07-13 15:58:07 UTC
All set. Thanks for the swap!

Comment 16 Julien Enselme 2016-07-13 16:46:16 UTC
Thanks!

Comment 17 Gwyn Ciesla 2016-07-13 16:56:10 UTC
Package request has been approved: https://admin.fedoraproject.org/pkgdb/package/rpms/python-pytoml

Comment 18 Fedora Update System 2016-07-13 19:14:46 UTC
python-pytoml-0.1.10-2.gitd883c7c.fc24 has been submitted as an update to Fedora 24. https://bodhi.fedoraproject.org/updates/FEDORA-2016-21c1d3a893

Comment 19 Fedora Update System 2016-07-13 19:23:46 UTC
python-pytoml-0.1.10-2.gitd883c7c.fc23 has been submitted as an update to Fedora 23. https://bodhi.fedoraproject.org/updates/FEDORA-2016-001c6c5a66

Comment 20 Fedora Update System 2016-07-14 15:53:00 UTC
python-pytoml-0.1.10-2.gitd883c7c.fc23 has been pushed to the Fedora 23 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2016-001c6c5a66

Comment 21 Fedora Update System 2016-07-14 22:28:17 UTC
python-pytoml-0.1.10-2.gitd883c7c.fc24 has been pushed to the Fedora 24 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2016-21c1d3a893

Comment 22 Fedora Update System 2016-07-22 18:23:07 UTC
python-pytoml-0.1.10-2.gitd883c7c.fc24 has been pushed to the Fedora 24 stable repository. If problems still persist, please make note of it in this bug report.

Comment 23 Fedora Update System 2016-07-23 00:19:01 UTC
python-pytoml-0.1.10-2.gitd883c7c.fc23 has been pushed to the Fedora 23 stable repository. If problems still persist, please make note of it in this bug report.


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