| Index: utils/apidoc/html_diff_dump.dart
|
| ===================================================================
|
| --- utils/apidoc/html_diff_dump.dart (revision 11903)
|
| +++ utils/apidoc/html_diff_dump.dart (working copy)
|
| @@ -1,121 +0,0 @@
|
| -// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
|
| -// for details. All rights reserved. Use of this source code is governed by a
|
| -// BSD-style license that can be found in the LICENSE file.
|
| -
|
| -/**
|
| - * A script for printing a JSON dump of HTML diff data. In particular,
|
| - * this lists a map of `dart:dom_deprecated` methods that have been
|
| - * renamed to `dart:html` methods without changing their semantics,
|
| - * and `dart:dom_deprecated` methods that have been removed in
|
| - * `dart:html`. As a heuristic, a `dart:html` method doesn't change
|
| - * the semantics of the corresponding `dart:dom_deprecated` method if
|
| - * it's the only corresponding HTML method and it has the
|
| - * corresponding return type.
|
| - *
|
| - * The format of the output is as follows:
|
| - *
|
| - * {
|
| - * "renamed": { domName: htmlName, ... },
|
| - * "removed": [name, ...]
|
| - * }
|
| - *
|
| - * Note that the removed members are listed with the names they would have in
|
| - * HTML where possible; e.g. `HTMLMediaElement.get:textTracks` is listed as
|
| - * `MediaElement.get:textTracks`.
|
| - */
|
| -#library('html_diff_dump');
|
| -
|
| -#import('dart:json');
|
| -#import('dart:io');
|
| -#import('html_diff.dart');
|
| -#import('../../pkg/dartdoc/mirrors/mirrors.dart');
|
| -#import('../../pkg/dartdoc/mirrors/mirrors_util.dart');
|
| -
|
| -HtmlDiff diff;
|
| -
|
| -/** Whether or not a domType represents the same type as an htmlType. */
|
| -bool sameType(MemberMirror domMember, MemberMirror htmlMember) {
|
| - TypeMirror domType = domMember is FieldMirror
|
| - ? domMember.type
|
| - : domMember.returnType;
|
| - TypeMirror htmlType = htmlMember is FieldMirror
|
| - ? htmlMember.type
|
| - : htmlMember.returnType;
|
| - if (domType.isVoid || htmlType.isVoid) {
|
| - return domType.isVoid && htmlType.isVoid;
|
| - }
|
| -
|
| - final htmlTypes = diff.domTypesToHtml[domType.qualifiedName];
|
| - return htmlTypes != null && htmlTypes.some((t) => t == htmlType);
|
| -}
|
| -
|
| -/** Returns the name of a member, including `get:` if it's a field. */
|
| -String memberName(MemberMirror m) => m.simpleName;
|
| -
|
| -/**
|
| - * Returns a string describing the name of a member. If [type] is passed, it's
|
| - * used in place of the member's real type name.
|
| - */
|
| -String memberDesc(MemberMirror m, [ObjectMirror type = null]) {
|
| - if (type == null) type = m.surroundingDeclaration;
|
| - return '${type.simpleName}.${memberName(m)}';
|
| -}
|
| -
|
| -/**
|
| - * Same as [memberDesc], but if [m] is a `dart:dom_deprecated` type
|
| - * its `dart:html` typename is used instead.
|
| - */
|
| -String htmlishMemberDesc(MemberMirror m) {
|
| - var type = m.surroundingDeclaration;
|
| - final htmlTypes = diff.domTypesToHtml[type.qualifiedName];
|
| - if (htmlTypes != null && htmlTypes.length == 1) {
|
| - type = htmlTypes.iterator().next();
|
| - }
|
| - return memberDesc(m, type);
|
| -}
|
| -
|
| -/**
|
| - * Add an entry to the map of `dart:dom_deprecated` names to
|
| - * `dart:html` names if [domMember] was renamed to [htmlMembers] with
|
| - * the same semantics.
|
| - */
|
| -void maybeAddRename(Map<String, String> renamed,
|
| - MemberMirror domMember,
|
| - Collection<MemberMirror> htmlMembers) {
|
| - if (htmlMembers.length != 1) return;
|
| - final htmlMember = htmlMembers.iterator().next();
|
| - if (memberName(domMember) != memberName(htmlMember) &&
|
| - sameType(domMember, htmlMember)) {
|
| - renamed[memberDesc(domMember)] = memberDesc(htmlMember);
|
| - }
|
| -}
|
| -
|
| -void main() {
|
| - var libPath = const Path('../../');
|
| - HtmlDiff.initialize(libPath);
|
| - diff = new HtmlDiff();
|
| - diff.run();
|
| -
|
| - final renamed = <String, String>{};
|
| - diff.domToHtml.forEach((MemberMirror domMember,
|
| - Set<MemberMirror> htmlMembers) {
|
| - maybeAddRename(renamed, domMember, htmlMembers);
|
| - });
|
| -
|
| - final removed = <String>[];
|
| -
|
| - for (InterfaceMirror type in HtmlDiff.dom.types.getValues()) {
|
| - if (type.declaredMembers.getValues().every((m) =>
|
| - !diff.domToHtml.containsKey(m))) {
|
| - removed.add('${type.simpleName}.*');
|
| - } else {
|
| - for (MemberMirror member in type.declaredMembers.getValues()) {
|
| - if (!diff.domToHtml.containsKey(member)) {
|
| - removed.add(htmlishMemberDesc(member));
|
| - }
|
| - }
|
| - }
|
| - }
|
| -
|
| - print(JSON.stringify({'renamed': renamed, 'removed': removed}));
|
| -}
|
|
|