// $Id$ /* * WorldEditLibrary * Copyright (C) 2010 sk89q * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ package com.sk89q.worldedit.dev; import java.io.*; import java.lang.reflect.Method; import java.util.ArrayList; import java.util.List; import com.sk89q.minecraft.util.commands.Command; import com.sk89q.minecraft.util.commands.CommandPermissions; import com.sk89q.util.StringUtil; public class DocumentationPrinter { public static void main(String[] args) throws IOException { File commandsDir = new File(args[0]); List> commandClasses = getCommandClasses(commandsDir); System.out.println("Writing permissions wiki table..."); writePermissionsWikiTable(commandClasses); System.out.println("Writing Bukkit plugin.yml..."); writeBukkitYAML(commandClasses); System.out.println("Done!"); } private static List> getCommandClasses(File dir) { List> classes = new ArrayList>(); for (File f : dir.listFiles()) { if (!f.getName().matches("^.*\\.java$")) { continue; } String className = "com.sk89q.worldedit.commands." + f.getName().substring(0, f.getName().lastIndexOf(".")); Class cls; try { cls = Class.forName(className, true, Thread.currentThread().getContextClassLoader()); } catch (ClassNotFoundException e) { continue; } classes.add(cls); } return classes; } private static void writePermissionsWikiTable(List> commandClasses) throws IOException { FileOutputStream stream = null; try { stream = new FileOutputStream("wiki_permissions.txt"); PrintStream print = new PrintStream(stream); _writePermissionsWikiTable(print, commandClasses); } finally { if (stream != null) { stream.close(); } } } private static void _writePermissionsWikiTable(PrintStream stream, List> commandClasses) { for (Class cls : commandClasses) { for (Method method : cls.getMethods()) { if (!method.isAnnotationPresent(Command.class)) { continue; } Command cmd = method.getAnnotation(Command.class); stream.println("|-"); stream.print("| /" + cmd.aliases()[0]); stream.print(" || "); if (method.isAnnotationPresent(CommandPermissions.class)) { CommandPermissions perms = method.getAnnotation(CommandPermissions.class); String[] permKeys = perms.value(); for (int i = 0; i < permKeys.length; i++) { if (i > 0) { stream.print(", "); } stream.print(permKeys[i]); } } stream.println(); } } } private static void writeBukkitYAML(List> commandClasses) throws IOException { FileOutputStream stream = null; try { stream = new FileOutputStream("plugin.yml"); PrintStream print = new PrintStream(stream); _writeBukkitYAML(print, commandClasses); } finally { if (stream != null) { stream.close(); } } } private static void _writeBukkitYAML(PrintStream stream, List> commandClasses) { stream.println("name: WorldEdit"); stream.println("main: com.sk89q.worldedit.bukkit.WorldEditPlugin"); stream.println("version: \"WEVERSIONMACRO\""); stream.println("commands:"); for (Class cls : commandClasses) { for (Method method : cls.getMethods()) { if (!method.isAnnotationPresent(Command.class)) { continue; } Command cmd = method.getAnnotation(Command.class); stream.println(" " + cmd.aliases()[0] + ":"); stream.println(" description: " + cmd.desc()); stream.println(" usage: / " + (cmd.flags().length() > 0 ? "[-" + cmd.flags() + "] " : "") + cmd.usage()); if (cmd.aliases().length > 1) { stream.println(" aliases: [" + StringUtil.joinQuotedString(cmd.aliases(), ", ", 1, "'") + "]"); } } } } }