Re: [Anima] [netmod] looking for practical advice on managing YANG source in XML format RFCs

Christian Hopps <chopps@chopps.org> Mon, 14 June 2021 18:38 UTC

Return-Path: <chopps@chopps.org>
X-Original-To: anima@ietfa.amsl.com
Delivered-To: anima@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B31133A2DBC; Mon, 14 Jun 2021 11:38:19 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_NONE=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 cdYl8XySKo3T; Mon, 14 Jun 2021 11:38:15 -0700 (PDT)
Received: from smtp.chopps.org (smtp.chopps.org [54.88.81.56]) by ietfa.amsl.com (Postfix) with ESMTP id E92C03A2D6C; Mon, 14 Jun 2021 11:38:14 -0700 (PDT)
Received: from smtpclient.apple (047-026-251-217.res.spectrum.com [47.26.251.217]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by smtp.chopps.org (Postfix) with ESMTPSA id 04789811F1; Mon, 14 Jun 2021 18:38:13 +0000 (UTC)
From: Christian Hopps <chopps@chopps.org>
Message-Id: <6CA55CB9-CBF9-48C7-B925-892020D2ED72@chopps.org>
Content-Type: multipart/alternative; boundary="Apple-Mail=_447CE31D-42C5-404F-89C7-41AF110B8409"
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.100.0.2.22\))
Date: Mon, 14 Jun 2021 14:38:12 -0400
In-Reply-To: <16776.1623679777@localhost>
Cc: Carsten Bormann <cabo@tzi.org>, anima@ietf.org, tools-discuss@ietf.org, netmod@ietf.org
To: Michael Richardson <mcr+ietf@sandelman.ca>
References: <6795.1623632992@localhost> <D907A27E-2A70-4292-ADFA-5D8B350E676C@tzi.org> <16776.1623679777@localhost>
X-Mailer: Apple Mail (2.3654.100.0.2.22)
Archived-At: <https://mailarchive.ietf.org/arch/msg/anima/Aorn7Gq0uOSlJHl7SbWCbut4V5A>
Subject: Re: [Anima] [netmod] looking for practical advice on managing YANG source in XML format RFCs
X-BeenThere: anima@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Autonomic Networking Integrated Model and Approach <anima.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/anima>, <mailto:anima-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/anima/>
List-Post: <mailto:anima@ietf.org>
List-Help: <mailto:anima-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/anima>, <mailto:anima-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 14 Jun 2021 18:38:20 -0000

I didn’t think you were actually looking for a non-xml solution, but as you mentioned in an earlier mail there’s my org-rfc setup which makes all this yang stuff pretty simple. The source of the YANG module is in the single org-mode formatted draft source, along with support for YANG validation of the module and examples, generating YANG trees, downloading YANG dependencies etc.. :)

An example use: https://github.com/choppsv1/draft-chopps-netmod-geo-location <https://github.com/choppsv1/draft-chopps-netmod-geo-location>

Thanks,
Chris.

> On Jun 14, 2021, at 10:09 AM, Michael Richardson <mcr+ietf@sandelman.ca> wrote:
> 
> 
> Carsten Bormann <cabo@tzi.org> wrote:
>> On 14. Jun 2021, at 03:09, Michael Richardson <mcr+ietf@sandelman.ca> wrote:
>>> 
>>> 1) how to process yang files with YYYY-DD-MM into XML.
>>> 2) how to generate yang tree files.
>>> 3) how do I get my YANG includes downloaded, and do I put them into my repo?
>>> 4) how to do this with MT Makefiles?
> 
>> I people could tell me what they need, we could develop a feature in
>> kramdown-rfc to handle this.
> 
> One possibility is that kramdown-rfc ought to look for, and include the
> latest foo-YYYY-MM-DD.yang file, when told to ::include foo.yang.
> Alternatively, it could perhaps do the YYYY-MM-DD substitution itself.
> 
>> (This would presumably also include support for YANG-SID files.)
> 
> That's mostly just a question about including the results, and it's not that
> hard thing to add to the main Makefile.
> 
> But, as I said, I xml2rfc doesn't have a useful include functionality, for
> when not working with kramdown.
> 
> --
> Michael Richardson <mcr+IETF@sandelman.ca>   . o O ( IPv6 IøT consulting )
>           Sandelman Software Works Inc, Ottawa and Worldwide
> 
> 
> 
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod