Re: [spdx-tech] Short question about downwards and upwards compatibility

[Kate Stewart]

On Tue, Sep 12, 2017 at 11:31 AM, W. Trevor King  wrote:

> On Tue, Sep 12, 2017 at 07:54:31AM -0500, Kate Stewart wrote:
> > Of concern, there are new fields added in 2.1 that are
> > not present in 2.0 (backwards compatibility), its best
> > the file is correctly labeled.
>
> If you use the new-in-2.1 properties [1], you need to declare 2.1.
> But if you don't use them, you can safely declare 2.0 and support both
> older parsers that only handle 2.0 and new parsers that understand all
> of 2.1.
>

Agree.   Depends what's easiest of the tool I guess.  :-)

>
> As a useful alternative/supplement to the current release-notes
> approach [1], I like the “New in {version}” annotations that Python
> has for its properties (e.g. [2]).  That makes it easy to discover
> compat implications as you fill in a property, without having to jump
> back and forth between the property definitions and the release notes.
>

Nice.   Will look into this,  as we've been doing this highlighting manually
in presentations, but  incorporating it into the spec going forward,
seems like an positive enhancement now that we have it online.

What do others think?

Kate


>
> Cheers,
> Trevor
>
> [1]: https://spdx.org/spdx-specification-21-web-version#h.1sh8jn1fc5zw
> [2]: https://docs.python.org/3.5/library/unittest.html#
> unittest.TestCase.skipTest
>
> Cheers,
> Trevor
>
> --
> This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
> For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy
>
___
Spdx-tech mailing list
Spdx-tech@lists.spdx.org
https://lists.spdx.org/mailman/listinfo/spdx-tech

Re: [spdx-tech] Short question about downwards and upwards compatibility

[W. Trevor King]

On Tue, Sep 12, 2017 at 07:54:31AM -0500, Kate Stewart wrote:
> Of concern, there are new fields added in 2.1 that are
> not present in 2.0 (backwards compatibility), its best
> the file is correctly labeled.

If you use the new-in-2.1 properties [1], you need to declare 2.1.
But if you don't use them, you can safely declare 2.0 and support both
older parsers that only handle 2.0 and new parsers that understand all
of 2.1.

As a useful alternative/supplement to the current release-notes
approach [1], I like the “New in {version}” annotations that Python
has for its properties (e.g. [2]).  That makes it easy to discover
compat implications as you fill in a property, without having to jump
back and forth between the property definitions and the release notes.

Cheers,
Trevor

[1]: https://spdx.org/spdx-specification-21-web-version#h.1sh8jn1fc5zw
[2]: 
https://docs.python.org/3.5/library/unittest.html#unittest.TestCase.skipTest

Cheers,
Trevor

-- 
This email may be signed or encrypted with GnuPG (http://www.gnupg.org).
For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy


signature.asc
Description: OpenPGP digital signature
___
Spdx-tech mailing list
Spdx-tech@lists.spdx.org
https://lists.spdx.org/mailman/listinfo/spdx-tech

Re: [spdx-tech] Short question about downwards and upwards compatibility

[Kate Stewart]

Hi Maximilian,
If you're recognizing and generating SPDX 2.1,
its best to mark the generated file as SPDX 2.1.

If an older parser encounters the file and version number
and doesn't recognize it,  its a bug on that parser.
Of concern, there are new fields added in 2.1 that are
not present in 2.0 (backwards compatibility), its best
the file is correctly labeled.

Hope this helps,  Kate


On Tue, Sep 12, 2017 at 7:39 AM, Maximilian Huber <
maximilian.hu...@tngtech.com> wrote:

> Hello spdx-tech@,
>
> In FOSSology we generate SPDX reports which are compatible with the
> 2.0 and the 2.1 specification and we are now discussing, which version
> to specify in the created document.
>
> It might be a good idea to stay on version 2.0 since parsers, which
> read 2.1, might probably also be able to understand 2.0. But older
> parses fail if they see the new version.
>
> What would you recommend? What is the status on downwards and upwards
> compatibility on common parser implementations and tooling?
>
> Best regards
> Maximilian
>
> --
> Maximilian Huber * maximilian.hu...@tngtech.com * +49-174-3410223
> TNG Technology Consulting GmbH, Betastr. 13a, 85774 Unterföhring
> Geschäftsführer: Henrik Klagges, Dr. Robert Dahlke, Gerhard Müller
> Sitz: Unterföhring * Amtsgericht München * HRB 135082
>
> ___
> Spdx-tech mailing list
> Spdx-tech@lists.spdx.org
> https://lists.spdx.org/mailman/listinfo/spdx-tech
>
>
___
Spdx-tech mailing list
Spdx-tech@lists.spdx.org
https://lists.spdx.org/mailman/listinfo/spdx-tech