From 78ad977bb7fdb6b77232e16a6f25b36ee35755e7 Mon Sep 17 00:00:00 2001 From: Emile Anclin Date: Mon, 8 Sep 2008 17:03:54 +0200 Subject: adapt pyreverse for inclusion into pylint --- man/pyreverse.1 | 105 ++++++++++++++++++++++++++++---------------------------- 1 file changed, 53 insertions(+), 52 deletions(-) (limited to 'man') diff --git a/man/pyreverse.1 b/man/pyreverse.1 index f28dd9f..8fa24b6 100644 --- a/man/pyreverse.1 +++ b/man/pyreverse.1 @@ -5,76 +5,77 @@ them. .SH SYNOPSIS .B pyreverse -.I {diagram|test|xmi} .I [options] .SH DESCRIPTION .B pyreverse - is a python source analyzer. It can parse a python package and produce UML - diagrams in different output formats. (dot, all formats available for dot, -and vcg). (For now, the 'xmi' and 'tests' commands are not under developpement.) - - With different options, you can have fine tuning on what and how modules, - classes and attributes will be shown in the diagram. - You can combine several modules in one project (except with +is a python source analyzer. It parses a python packages and produces UML +diagrams in different output formats. (dot, all formats available for dot, +and vcg). +With different options, you can have fine tuning on what and how modules, +classes and attributes will be shown in the diagram. +You can combine several modules in one project (except with .B -c ). -.SH COMMON OPTIONS +If no -c and no --diadefs option specified, +.B pyreverse +will create + - a diagram 'classes_' for the classes in and + ( if there is more than one module in ) + - a diagram 'packages_' for the package dependencies in + +With -c , +.B pyreverse +creates a diagram for that with filename .. +You can do -c , -c . + +.SH OPTIONS .IP "-h, --help" - show this help message and exit +show this help message and exit .IP "-p, --project=" - set project name to if not using -c option. (default:'No Name') +set project name to if not using -c option. (default:'No Name') .IP "-i, --ignore=" - add (may be a directory) to the black list (not parsed) +add (may be a directory) to the black list (not parsed) .IP "-f, --filter-mode=" - filter attributes and functions according to . You can combine - modes using '+' like 'SPECIAL+OTHER'. Correct modes are : - 'PUB_ONLY' filter all non public attributes (default) - 'ALL' no filter - 'SPECIAL' filter Python special functions except constructor - 'OTHER' filter protected and private attributes [currentt: PUB_ONLY] +filter attributes and functions according to . You can combine +modes using '+' like 'SPECIAL+OTHER'. Correct modes are : + - 'PUB_ONLY' : filter all non public attributes (default) + - 'ALL' : no filter + - 'SPECIAL' : filter Python special functions except constructor + - 'OTHER' : filter protected and private attributes [currentt: PUB_ONLY] .IP "-d, --diadefs=" - create diagram according to the diagrams definitions in +create diagram according to the diagrams definitions in .IP "-c , --class=" - create a class diagram with all classes related to [current: none] - the class must be in the file . By default, this will include all - ancestors and associated classes of and include module names - (i.e. '-ASmy' ). +create a class diagram with all classes related to [current: none] +the class must be in the file . By default, this will include all +ancestors and associated classes of and include module names +(i.e. '-ASmy' ). .IP -a , --show-ancestors= - show generations of ancestor classes not in +show generations of ancestor classes not in .IP -A, --all-ancestors=[yn] - show all ancestors off all classes in [current: none] +show all ancestors off all classes in [current: none] .IP -s , --show-associated= - show associated classes. =1 will only take classes - directly related to the classes in the project, while =2 - will also take all classes related to those fecthed by=1. +show associated classes. =1 will only take classes +directly related to the classes in the project, while =2 +will also take all classes related to those fecthed by=1. .IP -S, --all-associated=[yn] - show recursively all associated off all associated classes [current: none] +show recursively all associated off all associated classes [current: none] .IP "-b, --builtin" - include builtin objects in representation of classes [current: False] +include builtin objects in representation of classes [current: False] .IP "-m [yn], --module-names=[yn]" - include module name in representation of classes. This will include full - module path in the class name. [current: none] +include module name in representation of classes. This will include full +module path in the class name. [current: none] .IP "-k, --only-classnames" - don't show attributes and methods in the class boxes; - this disables -f values [current: False] +don't show attributes and methods in the class boxes; +this disables -f values [current: False] -.SH PYREVERSE DIAGRAM - If no -c and no --diadefs option specified, -.B pyreverse diagram -will create - \- a diagram 'classes_' for the classes in and - \- a diagram 'packages_' for the packages in . - With -c, -.B pyreverse diagram -creates a diagram for each with same name (adding an output file extension). .IP "-o , --output=" create a *. output file if format available. Available formats are all formats that dot can produce and @@ -84,22 +85,22 @@ are all formats that dot can produce and .SH EXAMPLES Here are some examples for command line options : -.IP "pyreverse diagram -a1 -s1 -m" +.IP "pyreverse -a1 -s1 -m" - -a1 -s1 will include one level of ancestor and associated classes in the - diagram of the modules, while -m will show the full module - path of each class. You can use the same way the +-a1 -s1 will include one level of ancestor and associated classes in the +diagram of the modules, while -m will show the full module +path of each class. You can use the same way the .B -a, -s, -A, -S options. - Note that on class diagrams (using +Note that on class diagrams (using .B -c ) -a and -s will rather reduce than enlarge your diagram. -.IP "pyreverse diagram mod/foo.py mod/fee.py -k" +.IP "pyreverse mod/foo.py mod/fee.py -k" - This is interesting if the diagram for =mod is too complicated: - you can show only the class names (no attributes or methods, option -k); - or take only the modules you are interested in (here fee.py and foo.py). +This is interesting if the diagram for =mod is too complicated: +you can show only the class names (no attributes or methods, option -k); +or take only the modules you are interested in (here fee.py and foo.py). .SH REQUIRES Python -- cgit v1.2.1