Skip to contentSkip to conversation

libcomps: put PV in filename

PATCH In review Ross Burton 5 participants 14 messages Mar 25, 2019 – Mar 29, 2019

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 libcomps: put PV in filename

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

---
 meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} | 1 -
 1 file changed, 1 deletion(-)
 rename meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} (98%)
meta/recipes-devtools/libcomps/libcomps_0.1.10.bb renamed from meta/recipes-devtools/libcomps/libcomps_git.bb +0 -1
similarity index 98%
rename from meta/recipes-devtools/libcomps/libcomps_git.bb
rename to meta/recipes-devtools/libcomps/libcomps_0.1.10.bb
index ff6820851fe..1c4f3bde65e 100644
@@ -9,7 +9,6 @@ SRC_URI = "git://github.com/rpm-software-management/libcomps.git \
            file://0001-Add-crc32.c-to-sources-list.patch \
            "
 
-PV = "0.1.10"
 SRCREV = "86a82fcd155c27092340d15a34f5c75c4da88243"
 
 S = "${WORKDIR}/git"
Signature · 1 line
2.11.0
#1 lore raw
Quoted 3 lines · Ross Burton

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

I think its better to keep it as it is. since its easy to trace git log history.

Quoted 30 lines
---
 meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} | 1 -
 1 file changed, 1 deletion(-)
 rename meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} (98%)
meta/recipes-devtools/libcomps/libcomps_0.1.10.bb renamed from meta/recipes-devtools/libcomps/libcomps_git.bb +0 -2
similarity index 98%
rename from meta/recipes-devtools/libcomps/libcomps_git.bb
rename to meta/recipes-devtools/libcomps/libcomps_0.1.10.bb
index ff6820851fe..1c4f3bde65e 100644
@@ -9,7 +9,6 @@ SRC_URI = "git://github.com/rpm-software-management/libcomps.git \
            file://0001-Add-crc32.c-to-sources-list.patch \
            "
 
-PV = "0.1.10"
 SRCREV = "86a82fcd155c27092340d15a34f5c75c4da88243"
 
 S = "${WORKDIR}/git"
--

2.11.0

--
_______________________________________________
Openembedded-core mailing list
[email protected]
http://lists.openembedded.org/mailman/listinfo/openembedded-core

#2 lore raw
Quoted 4 lines · Khem Raj
Quoted 2 lines

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

I think its better to keep it as it is. since its easy to trace git log history.

So should I be renaming gcc-8.3.bb to gcc_http.bb? If the argument is that the filename should contain the transport protocol and PV is embedded in the recipe so that git log is easier, we should be applying that rule consistently.

Ross

#3 lore raw
Quoted 10 lines · Ross
Quoted 4 lines · Khem Raj
Quoted 2 lines

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

I think its better to keep it as it is. since its easy to trace git log history.

So should I be renaming gcc-8.3.bb to gcc_http.bb? If the argument is that the filename should contain the transport protocol and PV is embedded in the recipe so that git log is easier, we should be applying that rule consistently.

FWIW: I agree with Khem.

http fetcher won't (usually) fetch different version just by changing 1 variable inside the recipe and vice versa, renaming the recipe won't fetch different SRCREV with git.

If someone wants to update SRCREV in libcoms to be 10 commits behind 0.1.10, is he expected to rename the recipe back to libcomps_git.bb and re-add the PV variable (with new +git${SRCPV} suffix)?

I got used to "+git${SRCPV}" being dropped when the SRCREV matches exactly the git tag, but renaming the recipe and removing the PV seems too much, what is the benefit of doing that? It's not for clarity or easier maintenance (at least for me), because PV next to SRCREV makes much more sense to me (and helps people not to forget updating both at the same time).

Regards,

Signature · 1 line
Martin 'JaMa' Jansa     jabber: [email protected]
#4 lore raw
Quoted 3 lines · Martin Jansa

http fetcher won't (usually) fetch different version just by changing 1 variable inside the recipe and vice versa, renaming the recipe won't fetch different SRCREV with git.

Sure it will. gcc_http.bb sets PV=8.3.0 in the recipe, and SRC_URI uses ${PV}. The only catch is that http fetches have a secondary layer of transport checksums that git doesn't have.

Quoted 3 lines

If someone wants to update SRCREV in libcoms to be 10 commits behind 0.1.10, is he expected to rename the recipe back to libcomps_git.bb and re-add the PV variable (with new +git${SRCPV} suffix)?

Yes. The recipe ships a release. If the recipe is changed from shipping a tested and maintainer approved release to a git snapshot, that definitely should not be trivial.

Quoted 6 lines

I got used to "+git${SRCPV}" being dropped when the SRCREV matches exactly the git tag, but renaming the recipe and removing the PV seems too much, what is the benefit of doing that? It's not for clarity or easier maintenance (at least for me), because PV next to SRCREV makes much more sense to me (and helps people not to forget updating both at the same time).

For clarity and consistency: by convention recipes that ship releases put the PV in the filename.

Ross

#5 lore raw
Quoted 8 lines · Ross
Quoted 3 lines · Martin Jansa

http fetcher won't (usually) fetch different version just by changing 1 variable inside the recipe and vice versa, renaming the recipe won't fetch different SRCREV with git.

Sure it will. gcc_http.bb sets PV=8.3.0 in the recipe, and SRC_URI uses ${PV}. The only catch is that http fetches have a secondary layer of transport checksums that git doesn't have.

I'm sorry, that's not what I meant.

git fetcher fetches whatever SRCREV is defined in the recipe, no matter what PV says, I've seen enough recipe upgrades which just renamed the recipe to have new version in filename updating SRCREV and even claimed that the upgrade was properly tested, because nothing got broken :).

In webOS we got a bit further and PV+SRCREV are defined in one variable WEBOS_VERSION and do_fetch qa check tests that the SRCREV points to matching annotated version tag in the component.

Quoted 7 lines
Quoted 3 lines

If someone wants to update SRCREV in libcoms to be 10 commits behind 0.1.10, is he expected to rename the recipe back to libcomps_git.bb and re-add the PV variable (with new +git${SRCPV} suffix)?

Yes. The recipe ships a release. If the recipe is changed from shipping a tested and maintainer approved release to a git snapshot, that definitely should not be trivial.

Next time someone needs to include few bugfixes from stable branch included just after the release, should he update the SRCREV or add them as .patch files?

Quoted 9 lines
Quoted 6 lines

I got used to "+git${SRCPV}" being dropped when the SRCREV matches exactly the git tag, but renaming the recipe and removing the PV seems too much, what is the benefit of doing that? It's not for clarity or easier maintenance (at least for me), because PV next to SRCREV makes much more sense to me (and helps people not to forget updating both at the same time).

For clarity and consistency: by convention recipes that ship releases put the PV in the filename.

FWIW: in webOS we don't use any version in filename, most recipes are called just PN.bb and it works fine as well for us, less renames and version consistently defined inside the recipes.

Signature · 1 line
Martin 'JaMa' Jansa     jabber: [email protected]
#6 lore raw
Quoted 8 lines · Martin Jansa

git fetcher fetches whatever SRCREV is defined in the recipe, no matter what PV says, I've seen enough recipe upgrades which just renamed the recipe to have new version in filename updating SRCREV and even claimed that the upgrade was properly tested, because nothing got broken :).

In webOS we got a bit further and PV+SRCREV are defined in one variable WEBOS_VERSION and do_fetch qa check tests that the SRCREV points to matching annotated version tag in the component.

Agreed that is a genuine problem and is definitely something patchtest should be catching these days.

Quoted 3 lines

Next time someone needs to include few bugfixes from stable branch included just after the release, should he update the SRCREV or add them as .patch files?

Patches ideally, as we can pick them without other unintended changes.

Quoted 3 lines

FWIW: in webOS we don't use any version in filename, most recipes are called just PN.bb and it works fine as well for us, less renames and version consistently defined inside the recipes.

That makes complete sense, PV in filename is pretty much legacy from the old days, along with recipes split into a bb/inc where there's only one recipe.

Ross

#7 lore raw
In reply to Martin Jansa
Quoted 12 lines · Martin Jansa
Quoted 10 lines · Ross
Quoted 4 lines · Khem Raj
Quoted 2 lines

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

I think its better to keep it as it is. since its easy to trace git log history.

So should I be renaming gcc-8.3.bb to gcc_http.bb? If the argument is that the filename should contain the transport protocol and PV is embedded in the recipe so that git log is easier, we should be applying that rule consistently.

Quoted 5 lines

FWIW: I agree with Khem.

http fetcher won't (usually) fetch different version just by changing 1 variable inside the recipe and vice versa, renaming the recipe won't fetch different SRCREV with git.

Why should the name of the recipe depend on whatever fetcher is currently used?

If the same gcc release would be fetched from the upstream SVN, would you argue that the recipe has to be renamed to gcc_svn.bb?

Quoted 7 lines

If someone wants to update SRCREV in libcoms to be 10 commits behind 0.1.10, is he expected to rename the recipe back to libcomps_git.bb and re-add the PV variable (with new +git${SRCPV} suffix)?

I got used to "+git${SRCPV}" being dropped when the SRCREV matches exactly the git tag, but renaming the recipe and removing the PV seems too much, what is the benefit of doing that?

Is it actually a benefit to make it easy to switch from a release to some random git snapshot?

This is not something that should happen frequently.

Quoted 4 lines

It's not for clarity or
easier maintenance (at least for me), because PV next to SRCREV makes much more sense to me (and helps people not to forget updating both at the same time).

There are not only developers, but also users.

It is valuable to see from the filename whether it is a release (and which release it is) or some VCS snapshot.

Not having the release there also loses the ability to use either gcc_%.bbappend or gcc_8.3.0.bbappend, which are suitable for different situations.

Quoted 1 line

Regards,

cu
Adrian

Signature · 4 lines
       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed
#8 lore raw
Quoted 19 lines · Adrian Bunk
Quoted 12 lines · Martin Jansa
Quoted 10 lines · Ross
Quoted 4 lines · Khem Raj
Quoted 2 lines

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

I think its better to keep it as it is. since its easy to trace git log history.

So should I be renaming gcc-8.3.bb to gcc_http.bb? If the argument is that the filename should contain the transport protocol and PV is embedded in the recipe so that git log is easier, we should be applying that rule consistently.

Quoted 5 lines

FWIW: I agree with Khem.

http fetcher won't (usually) fetch different version just by changing 1 variable inside the recipe and vice versa, renaming the recipe won't fetch different SRCREV with git.

Quoted 5 lines

Why should the name of the recipe depend on whatever fetcher is currently used?

If the same gcc release would be fetched from the upstream SVN, would you argue that the recipe has to be renamed to gcc_svn.bb?

It's quite common use case to override SRCREV outside the recipe (at least during the development) to newer SRCREV or even AUTOREV.

Using _git or _svn in recipe filename was good indicator that this might be happening.

With e.g. http fetcher the PV is usually used in SRC_URI, so it's less likely to be inconsistent between what version the recipe (and enduser visible packages) say and what is actually downloaded and built.

Quoted 4 lines
Quoted 4 lines

If someone wants to update SRCREV in libcoms to be 10 commits behind 0.1.10, is he expected to rename the recipe back to libcomps_git.bb and re-add the PV variable (with new +git${SRCPV} suffix)?

Quoted 8 lines
Quoted 3 lines

I got used to "+git${SRCPV}" being dropped when the SRCREV matches exactly the git tag, but renaming the recipe and removing the PV seems too much, what is the benefit of doing that?

Is it actually a benefit to make it easy to switch from a release to some random git snapshot?

This is not something that should happen frequently.

It's not about easy switching, it's about making sure that SRCREV is updated at the same time as PV. Which is easier to notice when the 2 variables are set next to each other, than when PV is taken from the recipe filename and SRCREV (which is the only one which matters when downloading the source) is set inside the renamed recipe file.

Quoted 9 lines
Quoted 4 lines

It's not for clarity or
easier maintenance (at least for me), because PV next to SRCREV makes much more sense to me (and helps people not to forget updating both at the same time).

There are not only developers, but also users.

It is valuable to see from the filename whether it is a release (and which release it is) or some VCS snapshot.

That's why bitbake shows not only the filename (which isn't really important for users) but also the PV set in the recipe (either through the recipe filename or through PV variable set inside the recipe).

Quoted 3 lines

Not having the release there also loses the ability to use either gcc_%.bbappend or gcc_8.3.0.bbappend, which are suitable for different situations.

There is usually just one version per recipe and even with _git.bb suffix you can easily do gcc_7+git.bb and gcc_8+git.bb if you need to.

Signature · 1 line
Martin 'JaMa' Jansa     jabber: [email protected]
#9 lore raw
Quoted 8 lines · Martin Jansa

On Tue, Mar 26, 2019 at 12:42:12PM +0200, Adrian Bunk wrote:
...

Quoted 3 lines

Not having the release there also loses the ability to use either gcc_%.bbappend or gcc_8.3.0.bbappend, which are suitable for different situations.

There is usually just one version per recipe and even with _git.bb suffix you can easily do gcc_7+git.bb and gcc_8+git.bb if you need to.

Thud contains 8.2 today, but might have 8.3 tomorrow.

A layer might want to append only to one of them,
or have different appends for different versions.

That's trivial with gcc_8.2.bb and gcc_8.3.bb,
and harder with gcc_8+svn.bb.

cu
Adrian

Signature · 4 lines
       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed
#10 lore raw
Quoted 10 lines · Adrian Bunk
Quoted 8 lines · Martin Jansa

On Tue, Mar 26, 2019 at 12:42:12PM +0200, Adrian Bunk wrote:
...

Quoted 3 lines

Not having the release there also loses the ability to use either gcc_%.bbappend or gcc_8.3.0.bbappend, which are suitable for different situations.

There is usually just one version per recipe and even with _git.bb suffix you can easily do gcc_7+git.bb and gcc_8+git.bb if you need to.

Quoted 7 lines

Thud contains 8.2 today, but might have 8.3 tomorrow.

A layer might want to append only to one of them,
or have different appends for different versions.

That's trivial with gcc_8.2.bb and gcc_8.3.bb,
and harder with gcc_8+svn.bb.

If your layer has gcc_8.2.bbappend and the recipe in oe-core gets renamed from gcc_8.2.bb to gcc_8.3.bb in newer thud revision, then your bbappend will not apply and bitbake will complain that there is no recipe for your gcc_8.2.bbappend.

Layer which doesn't even parse correctly with different revisions of the same thud branch isn't really something we should encourage.

gcc_8%.bbappend with some logic inside (e.g. adding some .patch file only when PV starts with 8.2) will be compatible with both newer and older revision of thud.

Signature · 1 line
Martin 'JaMa' Jansa     jabber: [email protected]
#11 lore raw
In reply to Burton, Ross
Quoted 11 lines · Ross
Quoted 4 lines · Khem Raj
Quoted 2 lines

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

I think its better to keep it as it is. since its easy to trace git log history.

So should I be renaming gcc-8.3.bb to gcc_http.bb? If the argument is that the filename should contain the transport protocol and PV is embedded in the recipe so that git log is easier, we should be applying that rule consistently.

I would agree on ( foo.bb) for that as well if we do not maintain several copies of recipes and fetch from SCMs directly, which is more and more the case these days

Quoted 2 lines

Ross

#12 lore raw
In reply to Ross Burton

2019. 03. 26. 0:44 keltezéssel, Ross Burton írta:

Quoted 17 lines

This isn't a git snapshot recipe but a release that is fetched over it. For clarity, put the PV in the filename.

---
  meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} | 1 -
  1 file changed, 1 deletion(-)

rename meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} (98%)

meta/recipes-devtools/libcomps/libcomps_0.1.10.bb renamed from meta/recipes-devtools/libcomps/libcomps_git.bb +0 -0
similarity index 98%
rename from meta/recipes-devtools/libcomps/libcomps_git.bb
rename to meta/recipes-devtools/libcomps/libcomps_0.1.10.bb
index ff6820851fe..1c4f3bde65e 100644

meta/recipes-devtools/libcomps/libcomps_0.1.10.bb SRC_URI = "git://github.com/rpm-software-management/libcomps.git \ · line 12

Quoted 4 lines
meta/recipes-devtools/libcomps/libcomps_0.1.10.bb renamed from meta/recipes-devtools/libcomps/libcomps_git.bb +0 -1
@@ -9,7 +9,6 @@ SRC_URI = "git://github.com/rpm-software-management/libcomps.git \
             file://0001-Add-crc32.c-to-sources-list.patch \
             "
 
-PV = "0.1.10"
# opkg compare-version git "<=" 0.1.10 ; echo $?
1
# opkg compare-version git "<=" 1:0.1.10 ; echo $?
0

You need to increase PE to be able to upgrade the new recipe in case you publish this package in a repository.

Best regards,
Zoltán Böszörményi

Quoted 4 lines
meta/recipes-devtools/libcomps/libcomps_0.1.10.bb renamed from meta/recipes-devtools/libcomps/libcomps_git.bb +0 -0
  SRCREV = "86a82fcd155c27092340d15a34f5c75c4da88243"
 
  S = "${WORKDIR}/git"
#13 lore raw

2019. 03. 29. 19:45 keltezéssel, Böszörményi Zoltán írta:

Quoted 27 lines

2019. 03. 26. 0:44 keltezéssel, Ross Burton írta:

Quoted 18 lines

This isn't a git snapshot recipe but a release that is fetched over it.  For clarity, put the PV in the filename.

---
  meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} | 1 -

  1 file changed, 1 deletion(-)

  rename meta/recipes-devtools/libcomps/{libcomps_git.bb => libcomps_0.1.10.bb} (98%)

meta/recipes-devtools/libcomps/libcomps_0.1.10.bb renamed from meta/recipes-devtools/libcomps/libcomps_git.bb +0 -0
similarity index 98%
rename from meta/recipes-devtools/libcomps/libcomps_git.bb
rename to meta/recipes-devtools/libcomps/libcomps_0.1.10.bb
index ff6820851fe..1c4f3bde65e 100644
@@ -9,7 +9,6 @@ SRC_URI = "git://github.com/rpm-software-management/libcomps.git \
              file://0001-Add-crc32.c-to-sources-list.patch \
Quoted 2 lines

             "
-PV = "0.1.10"

# opkg compare-version git "<=" 0.1.10 ; echo $?
1
# opkg compare-version git "<=" 1:0.1.10 ; echo $?
0
Quoted 2 lines

You need to increase PE to be able to upgrade the new recipe in case you publish this package in a repository.

Sorry, dumb comment, ignore it. PV was overridden inside the recipe.

Quoted 8 lines

Best regards,
Zoltán Böszörményi

Quoted 3 lines

  SRCREV = "86a82fcd155c27092340d15a34f5c75c4da88243" S = "${WORKDIR}/git"