[netmod] YANG module metada and impact analysis links in the datatracker (New datatracker release: v6.64.0)

Benoit Claise <bclaise@cisco.com> Sat, 11 November 2017 16:11 UTC

Return-Path: <bclaise@cisco.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 86E6D124319 for <netmod@ietfa.amsl.com>; Sat, 11 Nov 2017 08:11:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.519
X-Spam-Level:
X-Spam-Status: No, score=-14.519 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com
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 a-guEJkktfMQ for <netmod@ietfa.amsl.com>; Sat, 11 Nov 2017 08:11:32 -0800 (PST)
Received: from rcdn-iport-2.cisco.com (rcdn-iport-2.cisco.com [173.37.86.73]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 811A5129B02 for <netmod@ietf.org>; Sat, 11 Nov 2017 08:11:28 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=23602; q=dns/txt; s=iport; t=1510416688; x=1511626288; h=subject:references:from:to:cc:message-id:date: mime-version:in-reply-to; bh=i2Kex6AT9BdCYuZEa0LIuweeK5gM+KT89eY4t537wFs=; b=FM4cBzr+/vuno5ze8rMLZH8JHvE3KMEKQtCyfG1bDLvrX8Joiy7qXI96 yN7XRU91qfLw0ENW9LPA6ylWbQF4/l160w6tMu5QPj5p2RTgvn0HkNXEo 6fT8hLPB0Pvn1W04SqGvmFjdFR4wtb3qJvhs6v0ywgyFSwj7sHx+jr/Qf Q=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0DLAQDZIAda/4QNJK1CEAocAQEBBAEBC?= =?us-ascii?q?gEBgzVkbieOHY8rgX2RCIVIEIIBCh6BY4M6AoRGPxgBAQEBAQEBAQFrKIUeAQM?= =?us-ascii?q?DJ0cCCRAcAwECL08IBg0GAgEBih4QM6wCOiaKZgEBAQEBAQEBAQEBAQEBAQEBA?= =?us-ascii?q?QEBAR2DNIIHgVWCEoJMg3mBGwUBBwsBKxSFWAWMU4UVgRKGGokWh2uDaYkwgnS?= =?us-ascii?q?JCYdFjGiBSodygTkfOBkpQW80IQgdFUmCZAmCUB8ZgVs0NgEBAQGHSw0YB4IWA?= =?us-ascii?q?QEB?=
X-IronPort-AV: E=Sophos;i="5.44,378,1505779200"; d="scan'208,217";a="322436458"
Received: from alln-core-10.cisco.com ([173.36.13.132]) by rcdn-iport-2.cisco.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 11 Nov 2017 16:11:26 +0000
Received: from [10.24.18.179] ([10.24.18.179]) by alln-core-10.cisco.com (8.14.5/8.14.5) with ESMTP id vABGBOXd026347; Sat, 11 Nov 2017 16:11:25 GMT
References: <E1e9tCU-0006Ve-Dg@zinfandel.tools.ietf.org>
From: Benoit Claise <bclaise@cisco.com>
To: NETMOD Working Group <netmod@ietf.org>
Cc: Henrik Levkowetz <henrik@levkowetz.com>
X-Forwarded-Message-Id: <E1e9tCU-0006Ve-Dg@zinfandel.tools.ietf.org>
Message-ID: <386c91c0-6d87-0b64-30e8-4a29edb220cc@cisco.com>
Date: Sun, 12 Nov 2017 00:11:23 +0800
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.4.0
MIME-Version: 1.0
In-Reply-To: <E1e9tCU-0006Ve-Dg@zinfandel.tools.ietf.org>
Content-Type: multipart/alternative; boundary="------------2EB99F48DCAB62DA6C02067E"
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/s0ojSy93xiyEGYlbzZ9YAJGDChw>
Subject: [netmod] YANG module metada and impact analysis links in the datatracker (New datatracker release: v6.64.0)
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: Sat, 11 Nov 2017 16:11:35 -0000

Dear all,

Here are two useful URLs in the datatracker if you care about YANG modules.
This was announced in Henrik's email "New datatracker release: v6.64.0", 
but let me stress this again.

If you take for example this draft: draft-ietf-netmod-rfc7223bis
The tracker, at 
https://datatracker.ietf.org/doc/draft-ietf-netmod-rfc7223bis/, provides 
two "additional URLs":
     - Yang catalog entry for ietf-interfaces@2017-08-17.yang 
<https://www.yangcatalog.org/yang-search/module_details.php?module=ietf-interfaces@2017-08-17.yang> 

     - Yang impact analysis for draft-ietf-netmod-rfc7223bis 
<https://www.yangcatalog.org/yang-search/impact_analysis.php?modules[]=ietf-interfaces@2017-08-17.yang&recurse=0&rfcs=1&show_subm=1&show_dir=dependencies> 


The first entry provides a list of all metadata in the YANG module for 
the yangcatalog.org 
<https://datatracker.ietf.org/doc/draft-clacla-netmod-model-catalog/>

            |  +--rw module* [name revision organization]
            |     +--rw name                        yang:yang-identifier
            |     +--rw revision                    union
            |     +--rw organization                string
            |     +--rw ietf
            |     |  +--rw ietf-wg?   string
            |     +--rw namespace                   inet:uri
            |     +--rw schema?                     inet:uri
            |     +--rw generated-from?             enumeration
            |     +--rw maturity-level?             enumeration
            |     +--rw document-name?              string
            |     +--rw author-email?               yc:email-address
            |     +--rw reference?                  inet:uri
            |     +--rw module-classification       enumeration
            |     +--rw compilation-status?         enumeration
            |     +--rw compilation-result?         inet:uri
            |     +--rw prefix?                     string
            |     +--rw yang-version?               enumeration
            |     +--rw description?                string
            |     +--rw contact?                    string
            |     +--rw module-type?                enumeration
            |     +--rw belongs-to?                 yang:yang-identifier
            |     +--rw tree-type?                  enumeration
            |     +--rw submodule* [name revision]
            |     |  +--rw name        yang:yang-identifier
            |     |  +--rw revision    union
            |     |  +--rw schema?     inet:uri
            |     +--rw dependencies* [name]
            |     |  +--rw name        yang:yang-identifier
            |     |  +--rw revision?   union
            |     |  +--rw schema?     inet:uri
            |     +--rw dependents* [name]
            |     |  +--rw name        yang:yang-identifier
            |     |  +--rw revision?   union
            |     |  +--rw schema?     inet:uri
            |     +--rw semantic-version?           yc:semver
            |     +--rw derived-semantic-version?   yc:semver
            |     +--rw implementations
            |        +--rw implementation* [vendor platform software-version software-flavor]
            |           +--rw vendor              string
            |           +--rw platform            string
            |           +--rw software-version    string
            |           +--rw software-flavor     string
            |           +--rw os-version?         string
            |           +--rw feature-set?        string
            |           +--rw os-type?            string
            |           +--rw feature*            yang:yang-identifier
            |           +--rw deviation* [name revision]
            |           |  +--rw name        yang:yang-identifier
            |           |  +--rw revision    union
            |           +--rw conformance-type?   enumeration
            +--rw vendors
               +--rw vendor* [name]
                  +--rw name         string
                  +--rw platforms
                     +--rw platform* [name]
                        +--rw name                 string
                        +--rw software-versions
                           +--rw software-version* [name]
                              +--rw name                string
                              +--rw software-flavors
                                 +--rw software-flavor* [name]
                                    +--rw name         string
                                    +--rw protocols
                                    |  +--rw protocol* [name]
                                    |     +--rw name                identityref
                                    |     +--rw protocol-version*   string
                                    |     +--rw capabilities*       string
                                    +--rw modules
                                       +--rw module* [name revision organization]
                                          +--rw name                -> /catalog/modules/module/name
                                          +--rw revision            -> /catalog/modules/module/revision
                                          +--rw organization        -> /catalog/modules/module/organization
                                          +--rw os-version?         string
                                          +--rw feature-set?        string
                                          +--rw os-type?            string
                                          +--rw feature*            yang:yang-identifier
                                          +--rw deviation* [name revision]
                                          |  +--rw name        yang:yang-identifier
                                          |  +--rw revision    union
                                          +--rw conformance-type?   enumeration

I advice you to review the leave definitions at YANG module for the 
yangcatalog.org 
<https://datatracker.ietf.org/doc/draft-clacla-netmod-model-catalog/>, 
to understand the use cases.
The most useful leaves to start with are the validation-status and 
validation-report.

The second entry provides the impact analysis. There are thee options:

    1. dependents only: only show those modules that depend on the
    target module(s).
         use case: you want to see the impacted modules
    2. dependencies only: only show those modules that are imported by
    the target module(s).
         use case: you want to see the bottleneck for standardization
    3. both

Enjoy.

Regards, Benoit

-------- Forwarded Message --------
Subject: 	New datatracker release: v6.64.0
Date: 	Wed, 01 Nov 2017 06:36:58 -0700
From: 	Henrik Levkowetz <henrik@levkowetz.com>
To: 	codesprints@ietf.org, iesg@ietf.org, wgchairs@ietf.org



Hi,

This is an automatic notification about a new datatracker release,
v6.64.0, generated when running the mkrelease script.

Release notes:

ietfdb (6.64.0) ietf; urgency=medium

   **Yang resource links on yang draft pages**

   Drafts containing yang modules now get links pointing to the yang impact
   analysis, and to module metadata for each module.  Support has been added
   for ad-hoc trac instances, permitting automatic maintenance of role-based
   admin rights also for other trac instances than the WG, RG, and directorate
   wikis.  The draft submission automation API description is now referenced
   from the draft submission upload page.  'Additional URLs' for drafts are now
   sorted, rather than presented in random order.  Links pointing from draft
   review pages to mailing lists, for the full review text, are now validated
   in order to avoid presenting links to unavailable resources.  An issue with
   parameter expansion in a nomcom template has been fixed, as have various
   other issues.

   Details from the commit log:

   * Tweaked a page cache time to make newly uploaded session agendas visible
     with less delay.

   * Added a guard against iterating over None in stats.views.document_stats()

   * Added draft URLs pointing to Yang resources (impact analysis and model
     metadata) for submissions containing Yang modules.

   * Changed the submission checkers to return more information in the
     checker details json blob; in particular added information about individual
     extracted code modules associated with a draft.  This is used by the yang
     valididty checker to return a list of extracted yang modules.

   * Changed the SubmissionCheck.time field to use a default now value,
     instead of auto_now, to permit migrations without changing the timestamps.

   * Added some more debugging output for occasional author extraction
     failures during test.  See also [14226].

   * Added support for ad-hoc trac instances, with arbitrary names and
     filesystem paths, but still bound to a particular group's roles for
     management of trac admin rights.

   * Display document urls in alphabetical order

   * Permit document urls to be up to 512 bytes, rather than the default 200

   * New settings for adhoc wikis and yang document urls

   * Added a mention of the submission automation API on the submission
     upload page.

   * Added cleaning of review_url from the review completion form, to make
     sure it's retrievable.

   * Added some debugging code to help identify random test failures

   * Added a new field Meeting.days to capture the length of a meeting.
     This is necessary now that we have previous meetings officially starting
     Sunday, lasting to Friday, and future meetings starting Saturday, Lasting
     to Friday.  We use Meeting.days to calculate Meeting.end_date().
     Meeting.get_ietf_monday() and two cut_off() methods have also been updated
     to be instance methods instead of class methods, and to not assume that a
     meeting starts on Sunday.

   * Updated coverage data

   * Expanded one of the nomcom tests a bit, and updated a fixture to match
     the current /nomcom/default/email/feedback_receipt.txt template.

   * Don't blow up when checking if the logged-in user is a document author,
     if the user don't have a person record.

  -- Henrik Levkowetz <henrik@levkowetz.com>  30 Oct 2017 04:30:27 -0700

The new version is available for installation through SVN checkout, with
   'svn checkout https://svn.tools.ietf.org/svn/tools/ietfdb/tags/6.64.0'

For development, copy the new development version instead:
   'svn copy https://svn.tools.ietf.org/svn/tools/ietfdb/tags/dev/6.64.1.dev0' <YOURBRANCH>

Regards,

	Henrik
	(via the mkrelease script)

.