Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(248)

Side by Side Diff: sdk/lib/_internal/dartdoc/bin/dartdoc.dart

Issue 19500013: Use path package in dartdoc (Closed) Base URL: http://dart.googlecode.com/svn/branches/bleeding_edge/dart/
Patch Set: Created 7 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
2 // for details. All rights reserved. Use of this source code is governed by a 2 // for details. All rights reserved. Use of this source code is governed by a
3 // BSD-style license that can be found in the LICENSE file. 3 // BSD-style license that can be found in the LICENSE file.
4 4
5 /** 5 /**
6 * To generate docs for a library, run this script with the path to an 6 * To generate docs for a library, run this script with the path to an
7 * entrypoint .dart file, like: 7 * entrypoint .dart file, like:
8 * 8 *
9 * $ dart dartdoc.dart foo.dart 9 * $ dart dartdoc.dart foo.dart
10 * 10 *
(...skipping 27 matching lines...) Expand all
38 mainWithOptions(Options options) { 38 mainWithOptions(Options options) {
39 // Need this because ArgParser.getUsage doesn't show command invocation. 39 // Need this because ArgParser.getUsage doesn't show command invocation.
40 final USAGE = 'Usage dartdoc [options] <entrypoint(s)>\n[options] include:'; 40 final USAGE = 'Usage dartdoc [options] <entrypoint(s)>\n[options] include:';
41 41
42 final args = options.arguments; 42 final args = options.arguments;
43 43
44 final dartdoc = new Dartdoc(); 44 final dartdoc = new Dartdoc();
45 45
46 final argParser = new ArgParser(); 46 final argParser = new ArgParser();
47 47
48 Path libPath = scriptDir.append('../../../../'); 48 Path libPath = path.join(scriptDir, '..', '..', '..', '..');
49 49
50 String packageRoot; 50 String packageRoot;
51 51
52 argParser.addFlag('no-code', 52 argParser.addFlag('no-code',
53 help: 'Do not include source code in the documentation.', 53 help: 'Do not include source code in the documentation.',
54 defaultsTo: false, negatable: false, 54 defaultsTo: false, negatable: false,
55 callback: (noCode) => dartdoc.includeSource = !noCode); 55 callback: (noCode) => dartdoc.includeSource = !noCode);
56 56
57 argParser.addOption('mode', abbr: 'm', 57 argParser.addOption('mode', abbr: 'm',
58 help: 'Define how HTML pages are generated.', 58 help: 'Define how HTML pages are generated.',
(...skipping 129 matching lines...) Expand 10 before | Expand all | Expand 10 after
188 188
189 // TODO(amouravski): This method is deprecated. Remove on April 22. 189 // TODO(amouravski): This method is deprecated. Remove on April 22.
190 argParser.addOption('pkg', 190 argParser.addOption('pkg',
191 help: 'Deprecated: same as --package-root.', 191 help: 'Deprecated: same as --package-root.',
192 callback: (packageDir) { 192 callback: (packageDir) {
193 if(packageDir != null) { 193 if(packageDir != null) {
194 packageRoot = packageDir; 194 packageRoot = packageDir;
195 } 195 }
196 }); 196 });
197 197
198 dartdoc.dartdocPath = libPath.append('lib/_internal/dartdoc'); 198 dartdoc.dartdocPath = path.join(libPath, 'lib', '_internal', 'dartdoc');
199 199
200 if (args.isEmpty) { 200 if (args.isEmpty) {
201 print('No arguments provided.'); 201 print('No arguments provided.');
202 print(USAGE); 202 print(USAGE);
203 print(argParser.getUsage()); 203 print(argParser.getUsage());
204 exit(1); 204 exit(1);
205 } 205 }
206 206
207 final entrypoints = <Uri>[]; 207 final entrypoints = <Uri>[];
208 try { 208 try {
(...skipping 32 matching lines...) Expand 10 before | Expand all | Expand 10 after
241 241
242 cleanOutputDirectory(dartdoc.outputDir); 242 cleanOutputDirectory(dartdoc.outputDir);
243 243
244 // Start the analysis and documentation. 244 // Start the analysis and documentation.
245 dartdoc.documentLibraries(entrypoints, libPath, packageRoot) 245 dartdoc.documentLibraries(entrypoints, libPath, packageRoot)
246 // Prepare the dart2js script code and copy static resources. 246 // Prepare the dart2js script code and copy static resources.
247 // TODO(amouravski): move compileScript out and pre-generate the client 247 // TODO(amouravski): move compileScript out and pre-generate the client
248 // scripts. This takes a long time and the js hardly ever changes. 248 // scripts. This takes a long time and the js hardly ever changes.
249 .then((_) => compileScript(dartdoc.mode, dartdoc.outputDir, libPath, 249 .then((_) => compileScript(dartdoc.mode, dartdoc.outputDir, libPath,
250 dartdoc.tmpPath)) 250 dartdoc.tmpPath))
251 .then((_) => copyDirectory(libPath.append('lib/_internal/dartdoc/static'), 251 .then((_) => copyDirectory(
252 dartdoc.outputDir)) 252 path.join(libPath, 'lib', '_internal', 'dartdoc', 'static'),
253 dartdoc.outputDir))
253 .then((_) { 254 .then((_) {
254 print(dartdoc.status); 255 print(dartdoc.status);
255 if (dartdoc.totals == 0) { 256 if (dartdoc.totals == 0) {
256 exit(1); 257 exit(1);
257 } 258 }
258 }) 259 })
259 .catchError((e) { 260 .catchError((e) {
260 print('Error: generation failed: ${e}'); 261 print('Error: generation failed: ${e}');
261 var trace = getAttachedStackTrace(e); 262 var trace = getAttachedStackTrace(e);
262 if (trace != null) print("StackTrace: $trace"); 263 if (trace != null) print("StackTrace: $trace");
(...skipping 17 matching lines...) Expand all
280 // If there is not, then check if the entrypoint is somewhere in a `lib` 281 // If there is not, then check if the entrypoint is somewhere in a `lib`
281 // directory. 282 // directory.
282 var parts = path.split(path.dirname(script)); 283 var parts = path.split(path.dirname(script));
283 var libDir = parts.lastIndexOf('lib'); 284 var libDir = parts.lastIndexOf('lib');
284 if (libDir > 0) { 285 if (libDir > 0) {
285 return path.join(path.joinAll(parts.take(libDir)), 'packages'); 286 return path.join(path.joinAll(parts.take(libDir)), 'packages');
286 } else { 287 } else {
287 return null; 288 return null;
288 } 289 }
289 } 290 }
OLDNEW
« no previous file with comments | « no previous file | sdk/lib/_internal/dartdoc/lib/dartdoc.dart » ('j') | sdk/lib/_internal/dartdoc/lib/dartdoc.dart » ('J')

Powered by Google App Engine
This is Rietveld 408576698