scripts/build_epydocs.sh
author Pawel Solyga <Pawel.Solyga@gmail.com>
Sun, 19 Oct 2008 13:06:20 +0000
changeset 388 699b206b64b7
parent 130 63248d9db484
permissions -rwxr-xr-x
Add pylint configuration file (pylintrc) and do_pylint.sh script which runs pylint checkers on Melange code using pylintrc file as config. do_pylint.sh as default shows additional information like reports, TODOs, code similarities and unused imports, but you can run it in silent mode (--silent) which disables all of that. The only problem with unused imports in pylint right now is that it doesn't work in the situation described in last example at http://code.google.com/p/soc/wiki/PythonStyleGuide#Packages, so sometimes we get unused import soc when we actually shouldn't. However this can be fixed by writing pylint plugins (our own checkers) in future. Patch by: Pawel Solyga Review by: to-be-reviewed
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
10
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     1
#!/bin/bash
130
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     2
# Generates epydoc for $target to $outdir, while ignoring $exclude
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     3
# WARNING: The contents of $outdir are -deleted- before the running epydoc
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     4
# This way there are no 'stale files' when the script finishes.
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     5
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     6
 outdir="../../wiki/html/epydoc"
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     7
 target="../app ../tests"
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     8
exclude="django"
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
     9
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    10
echo "Cleaning out $outdir..."
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    11
rm -f $outdir/*
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    12
echo "Done."
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    13
echo
10
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    14
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    15
echo "Running epydoc..."
130
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    16
echo "$target -> $outdir"
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    17
echo "================="
10
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    18
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    19
epydoc --html -v --show-private --inheritance=included --graph=all \
130
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    20
  --parse-only --exclude=$exclude -o $outdir $target
10
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    21
130
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    22
echo "================="
10
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    23
echo "Done."
130
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    24
echo
10
56109601507d Script to generate epydoc documents in wiki/html/epydoc.
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    25
130
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    26
echo "Goodbye."
63248d9db484 Updated the script to:
Sverre Rabbelier <srabbelier@gmail.com>
parents: 10
diff changeset
    27