Re: [netmod] Revision label in filename

Jan Lindblad <janl@tail-f.com> Thu, 11 June 2020 08:21 UTC

Return-Path: <janl@tail-f.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5B9843A176C for <netmod@ietfa.amsl.com>; Thu, 11 Jun 2020 01:21:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id bUwQT4Ou1wtP for <netmod@ietfa.amsl.com>; Thu, 11 Jun 2020 01:21:23 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id 2A13A3A1768 for <netmod@ietf.org>; Thu, 11 Jun 2020 01:21:23 -0700 (PDT)
Received: from [192.168.1.121] (213-67-237-150-no99.tbcn.telia.com [213.67.237.150]) by mail.tail-f.com (Postfix) with ESMTPSA id 1866B1AE02C9; Thu, 11 Jun 2020 10:21:19 +0200 (CEST)
Content-Type: text/plain; charset="us-ascii"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.80.23.2.2\))
From: Jan Lindblad <janl@tail-f.com>
In-Reply-To: <6BAF901C-D86C-418E-A2B9-EEB9D1C734BE@cisco.com>
Date: Thu, 11 Jun 2020 10:21:18 +0200
Cc: tom petch <ietfc@btconnect.com>, "netmod@ietf.org" <netmod@ietf.org>, Martin Björklund <mbj+ietf@4668.se>
Content-Transfer-Encoding: quoted-printable
Message-Id: <E242966C-BDE7-47A1-A4D8-FA95C27161FC@tail-f.com>
References: <E42934AA-A95D-4BC3-A9F9-F940734EA84F@cisco.com> <AM6PR07MB4520D033C8F8F32FD72F464DA0A30@AM6PR07MB4520.eurprd07.prod.outlook.com> <6BAF901C-D86C-418E-A2B9-EEB9D1C734BE@cisco.com>
To: "Reshad Rahman (rrahman)" <rrahman=40cisco.com@dmarc.ietf.org>
X-Mailer: Apple Mail (2.3608.80.23.2.2)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/iLr9gim_KN8nSGFstNkLaLDNmm0>
Subject: Re: [netmod] Revision label in filename
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 11 Jun 2020 08:21:26 -0000

Hi,

> I understand the requirement to not break what's currently working for date in the filename. However we do need something similar to work for revision-label. Having another file with the revision-label embedded in the filename should work. 
> 
> We discussed this issue in yesterday's weekly meeting and a proposal was made to use '@@' as delimiter for revision-label. # was turned down because of its impact on bash.

I did a quick check, and # is only treated as a comment character by bash when preceded by whitespace, i.e. not when used in the middle of a filename => I think we can drop the comment above.

If we want a filename to include multiple kinds of revision markings while keeping the existing tools afloat, implementing the @ notation, that might be achievable by picking some delimiter that is treated as a filename character by existing tools and placing the version label before the @. I.e. with # as the delimiter:

module-or-submodule-name['#'revision-label]['@'date].yang

Many other (combinations of) symbols could work, but they all run the risk of interfering with some tool or vendor internal CI/CD convention. A few examples: double underscore __, tripple dots ..., _ver_, ~, :

/jan


> So:
> module-or-submodule-name['@'date].yang (unchanged)
> module-or-submodule-name['@@'revision-label].yang
> 
> A symlink could be used, or we could have duplicate file contents.
> 
> Regards,
> Reshad.