Re: [netmod] Proposal to enhance the YANG tree output

Martin Bjorklund <mbj@tail-f.com> Fri, 15 September 2017 13:00 UTC

Return-Path: <mbj@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 19DD11332CD for <netmod@ietfa.amsl.com>; Fri, 15 Sep 2017 06:00:35 -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_PASS=-0.001, URIBL_BLOCKED=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 sQ3J0-3R0DFp for <netmod@ietfa.amsl.com>; Fri, 15 Sep 2017 06:00:34 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id B84ED133211 for <netmod@ietf.org>; Fri, 15 Sep 2017 06:00:33 -0700 (PDT)
Received: from localhost (h-40-225.A165.priv.bahnhof.se [94.254.40.225]) by mail.tail-f.com (Postfix) with ESMTPSA id CCB861AE00A0; Fri, 15 Sep 2017 15:00:32 +0200 (CEST)
Date: Fri, 15 Sep 2017 15:01:19 +0200 (CEST)
Message-Id: <20170915.150119.392876131973300261.mbj@tail-f.com>
To: bclaise@cisco.com
Cc: jclarke@cisco.com, andy@yumaworks.com, netmod@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <748ca881-2180-3096-750d-44d28aa1b7ce@cisco.com>
References: <20170914.195037.593298963545596882.mbj@tail-f.com> <5721c564-48e9-299e-5ada-b272b00716cf@cisco.com> <748ca881-2180-3096-750d-44d28aa1b7ce@cisco.com>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/dIRyBijLkWBF_CXm-j0XYIgyKyo>
Subject: Re: [netmod] Proposal to enhance the YANG tree output
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
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: Fri, 15 Sep 2017 13:00:35 -0000

Benoit Claise <bclaise@cisco.com> wrote:
> Hi Joe,
> > On 9/14/17 13:50, Martin Bjorklund wrote:
> >> Andy Bierman <andy@yumaworks.com> wrote:
> >>> Hi,
> >>>
> >>>
> >>> Actually I liked the early pyang output that was concise and easy to
> >>> remember.
> >>> The current format gets very cluttered and there are too many little
> >>> symbols
> >>> to remember them all.
> >> I agree with Andy.  I also did some experiments with printing
> >> enumerations, and they work ok for small enums.  But once you have
> >> more than a handful they do tend to clutter the output.  Even worse so
> >> for trees that go into RFCs (where lines need to be < 70 characters).
> > What about protecting this with an optional parameter?  I certainly
> > appreciate the output could be large, but I think it does have its
> > uses
> > sometimes.
> I would agree it has its uses sometimes.
> And it helps the broader community with understanding YANG, this is
> good.
> Now, if you are already a YANG expert, I guess you don't use the tree
> output much.

Personally, I use it all the time, it is extremely useful for
understanding the module.  But if it has too much details it becomes
less useful.


/martin