maxjhandsome
/
llvm-project
forked from OSchip/llvm-project
1
0
Fork 0
Code Issues Pull Requests Packages Releases Wiki Activity
llvm-project/clang/bindings/python/README.txt

19 lines
607 B
Plaintext
Raw Normal View History

Initial checkin of CIndex Python bindings, by Andrew Sutton! - Some tweaks by me for API changes, Darwin, and x86_64 support. Still needs substantial updating to match recent CIndex API changes. llvm-svn: 94349
2010-01-24 10:02:07 +08:00
//===----------------------------------------------------------------------===//
// Clang Python Bindings
//===----------------------------------------------------------------------===//
Rename 'CIndex' to 'libclang', since it has basically become our stable public (C) API, and will likely grow further in this direction in the future. llvm-svn: 102779
2010-05-01 05:51:10 +08:00
This directory implements Python bindings for Clang.
Initial checkin of CIndex Python bindings, by Andrew Sutton! - Some tweaks by me for API changes, Darwin, and x86_64 support. Still needs substantial updating to match recent CIndex API changes. llvm-svn: 94349
2010-01-24 10:02:07 +08:00
[python] [tests] Support overriding library path via environment Support a new CLANG_LIBRARY_PATH environment variable for the Python binding tests. This variable can be used to force the bindings to load libclang.* from a specific directory. I plan to use this when integrating Python binding tests with the CMake build system. Currently, those tests load libclang.so from default search paths, so I would have to rely on platform-specific mechanics such as LD_LIBRARY_PATH. Instead of copying the whole logic necessary to handle platform differences into yet another place, it's easier to just add a dedicated variable for this purpose. Differential Revision: https://reviews.llvm.org/D52806 llvm-svn: 344240
2018-10-11 19:58:07 +08:00
You may need to set CLANG_LIBRARY_PATH so that the Clang library can be
[python] [tests] Rewrite to use standard unittest module Rewrite the tests from using plain 'assert' mixed with some nosetests methods to the standard unittest module layout. Improve the code to use the most canonical assertion methods whenever possible. This has a few major advantages: - the code uses standard methods now, resulting in a reduced number of WTFs whenever someone with basic Python knowledge gets to read it, - completely unnecessary dependency on nosetests is removed since the standard library supplies all that is necessary for the tests to run, - the tests can be run via any test runner, including the one built-in in Python, - the failure output for most of the tests is improved from 'assertion x == y failed' to actually telling the values. Differential Revision: https://reviews.llvm.org/D39763 llvm-svn: 317897
2017-11-11 00:44:12 +08:00
found. The unit tests are designed to be run with any standard test
runner. For example:
Initial checkin of CIndex Python bindings, by Andrew Sutton! - Some tweaks by me for API changes, Darwin, and x86_64 support. Still needs substantial updating to match recent CIndex API changes. llvm-svn: 94349
2010-01-24 10:02:07 +08:00
--
$ env PYTHONPATH=$(echo ~/llvm/tools/clang/bindings/python/) \
[python] [tests] Support overriding library path via environment Support a new CLANG_LIBRARY_PATH environment variable for the Python binding tests. This variable can be used to force the bindings to load libclang.* from a specific directory. I plan to use this when integrating Python binding tests with the CMake build system. Currently, those tests load libclang.so from default search paths, so I would have to rely on platform-specific mechanics such as LD_LIBRARY_PATH. Instead of copying the whole logic necessary to handle platform differences into yet another place, it's easier to just add a dedicated variable for this purpose. Differential Revision: https://reviews.llvm.org/D52806 llvm-svn: 344240
2018-10-11 19:58:07 +08:00
CLANG_LIBRARY_PATH=$(llvm-config --libdir) \
[python] [tests] Rewrite to use standard unittest module Rewrite the tests from using plain 'assert' mixed with some nosetests methods to the standard unittest module layout. Improve the code to use the most canonical assertion methods whenever possible. This has a few major advantages: - the code uses standard methods now, resulting in a reduced number of WTFs whenever someone with basic Python knowledge gets to read it, - completely unnecessary dependency on nosetests is removed since the standard library supplies all that is necessary for the tests to run, - the tests can be run via any test runner, including the one built-in in Python, - the failure output for most of the tests is improved from 'assertion x == y failed' to actually telling the values. Differential Revision: https://reviews.llvm.org/D39763 llvm-svn: 317897
2017-11-11 00:44:12 +08:00
python -m unittest discover -v
Initial checkin of CIndex Python bindings, by Andrew Sutton! - Some tweaks by me for API changes, Darwin, and x86_64 support. Still needs substantial updating to match recent CIndex API changes. llvm-svn: 94349
2010-01-24 10:02:07 +08:00
tests.cindex.test_index.test_create ... ok
...
OK
--