Package: pycscope
========PyCscope========:Copyright: Copyright 2013 Peter Portante.  See LICENSE for details.:Author: Peter Portante:Release: 1.2.1:Date: 2013/03/16Purpose-------A python script to generate a cscope index from a Python sourcetree.  `pycscope` uses Python's own parser and (C)oncrete (S)yntax(T)ree to generate the index, so it is a bit more accurate thanplain cscope.Usage-----::pycscope.py [-D] [-R] [-S] [-V] [-f reffile] [-i srclistfile] [files ...]-D              Dump the (C)oncrete (S)yntax (T)ree generated by the parser for each file-R              Recurse directories for files-S              Interpret simple strings as symbols-V              Print version and exit-f reffile      Use 'reffile' as cross-ref file name instead of 'cscope.out'-i srclistfile  Use the contents of 'srclistfile' as the list of source files to scanLicense-------Copyright 2013 Peter PortanteThis program is free software; you can redistribute it and/ormodify it under the terms of version 2 of the GNU GeneralPublic License as published by the Free Software Foundation.This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See theGNU General Public License for more details.You should have received a copy of the GNU General PublicLicense along with this program; if not, write to the FreeSoftware Foundation, Inc., 51 Franklin Street, Fifth Floor,Boston, MA  02110-1301, USAInstall-------PyCscope uses Python's distutils package for installation.Use the following command to install this package::% python setup.py installFeatures--------PyCscope has the following features:- Supports both Python 2.7 and Python 3- Command line interface- Output can be used by the `CscopeFinder` plugin for jEdit- Marks for all files ending in `.py`- Marks for all `class` definitions- Marks for all defined functions- Marks for function calls (algorithm is not perfect)- Marks for end-of-function (no search uses this mark yet)- Marks for imported modules (use the search for #include)- Marks for symbol assignmentA *mark* is an indicator to the cscope utility that somethingof interest follows.History-------pycscope 0.3a and later are written and copyright Peter Portante.pycscope 0.1 - 0.3 were originally written and copyright Dean Hall.Status------It works well enough to generate an index file that can be usedby the `CscopeFinder` plugin for jEdit.  Other editors are not tested.Release Notes-------------This is PyCscope release 1.2.1==========  ========= ======  ====================================================Date        Release   Trac    Changes==========  ========= ======  ====================================================2013/03/16  1.2.1     N/A     Fix strings-as-symbols support (really).----------  --------- ------  ----------------------------------------------------2013/03/16  1.2       N/A     Fix strings-as-symbols support; fix end of functionmarking; add the ability to only run the indexer;remove the threading support that was broken.----------  --------- ------  ----------------------------------------------------2012/10/01  1.1       N/A     Fix Python3 support; enhance unit tests to run usingnose, generating coverage by default; fix brokenunit tests that were not properly run before theswitch to nose; add contrib area containing thepyxcscope integration for (X)Emacs.----------  --------- ------  ----------------------------------------------------2012/09/20  1.0       N/A     Call it 1.0; update to use setuptools; drop .py frominstalled script name; transition authorship fromDean Hall to Peter Portante.----------  --------- ------  ----------------------------------------------------2012/09/19  0.3e-pajp N/A     Fix issues #7 and #8: we now properly handle symbolsclosest to the assignment itself (rather than thefirst one), and replace the crazy comma countingmethod with a more stable pattern recognition methodthat explicitly records which tuples should receivethe assignment mark; fixed handling of import state-ments of the form, "from . import moda"----------  --------- ------  ----------------------------------------------------2012/09/18  0.3d-pajp N/A     Implement debugging help from Issue #9: dumpCst nowworks on subtrees of tuples, not just lists.----------  --------- ------  ----------------------------------------------------2012/09/17  0.3c-pajp N/A     First pass fix of Issue #6 removing errant assertionthus allowing symbol assignment marking to work ascoded (if not correctly, see Issue #7).----------  --------- ------  ----------------------------------------------------2012/09/11  0.3b-pajp N/A     Include changes from fspeech to get it working forPython 3; add proper support for yield expressionfollowing an augmented assignment; added supportfor filename and line numbers when assertions fire;fixed handling of commas on the left hand side ofassignment statements; gracefully handle errorsopening files.GitHub issues: #5----------  --------- ------  ----------------------------------------------------2012/04/29  0.3a-pajp N/A     (NOTE: Failed to update version!)Fix handling of DOS style line endings.GitHub issues: #4----------  --------- ------  ----------------------------------------------------2012/04/13  0.3a-pajp N/A     (NOTE: Failed to update version!)Fix handling of function definition decoratorsGitHub issues: #2, #3----------  --------- ------  ----------------------------------------------------2012/03/11  0.3a-pajp N/A     (NOTE: Failed to update version!)Change references from abstract syntax tree toconcrete syntax tree; fix handling of trailingcommas.----------  --------- ------  ----------------------------------------------------2012/03/05  0.3a-pajp N/A     Updated changes to support symbol assignment,enhance unit test coverage, prepare code for PyConposter session.----------  --------- ------  ----------------------------------------------------2007/12/25  0.3       N/A     Included changes submitted by K. Rader of Google:- Added the `-i` argument to specify a file-listfile- Fixups to the header and footer to make a validfile that cscope can read----------  --------- ------  ----------------------------------------------------2006/08/12  0.2       #33     Create 0.2 release.#34     Change all "pyscope" to "pycscope"#29     Make error reports less vague.#23     Create distutils files.#20     Create unit tests.----------  --------- ------  ----------------------------------------------------2006/08/02  0.1       None    Released to interested party byemail.#19     Observe newlines even withoutNEWLINE token.#18     Newlines before MARK_FILE causesexception.#16     Work on "." default directory.#10     Exception: TypeError in format.#8     Class mark is incorrect.#6     Create project space.==========  ========= ======  ====================================================