llvm-project/lldb/examples/customization/pwd-cd-and-system
Kate Stone b9c1b51e45 *** This commit represents a complete reformatting of the LLDB source code
*** to conform to clang-format’s LLVM style.  This kind of mass change has
*** two obvious implications:

Firstly, merging this particular commit into a downstream fork may be a huge
effort.  Alternatively, it may be worth merging all changes up to this commit,
performing the same reformatting operation locally, and then discarding the
merge for this particular commit.  The commands used to accomplish this
reformatting were as follows (with current working directory as the root of
the repository):

    find . \( -iname "*.c" -or -iname "*.cpp" -or -iname "*.h" -or -iname "*.mm" \) -exec clang-format -i {} +
    find . -iname "*.py" -exec autopep8 --in-place --aggressive --aggressive {} + ;

The version of clang-format used was 3.9.0, and autopep8 was 1.2.4.

Secondly, “blame” style tools will generally point to this commit instead of
a meaningful prior commit.  There are alternatives available that will attempt
to look through this change and find the appropriate prior commit.  YMMV.

llvm-svn: 280751
2016-09-06 20:57:50 +00:00
..
.lldbinit
README
utils.py *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00

README

Files in this directory:

o .lldbinit:

An example lldb init file that imports the utils.py module and adds the
following commands: 'pwd', 'cd', and 'system'.

o utils.py:

Python module which provides implementation for the 'cd' and 'system' commands.

o README:

The file you are reading now.

================================================================================
The following terminal output shows an interaction with lldb using the .lldbinit
and the utils.py files which are located in my HOME directory.  The lldb init
file imports the utils Python module and adds the 'pwd', 'cd', and 'system'
commands.

Johnnys-MacBook-Pro:multiple_threads johnny$ pwd
/Volumes/data/lldb/svn/trunk/test/functionalities/watchpoint/multiple_threads
Johnnys-MacBook-Pro:multiple_threads johnny$ lldb
(lldb) pwd
/Volumes/data/lldb/svn/trunk/test/functionalities/watchpoint/multiple_threads
(lldb) cd ..
Current working directory: /Volumes/data/lldb/svn/trunk/test/functionalities/watchpoint
(lldb) help system

Execute the command (a string) in a subshell.
Syntax: system
(lldb) system ls -l
total 0
drwxr-xr-x  7 johnny  admin  238 Oct 11 17:24 hello_watchlocation
drwxr-xr-x  7 johnny  admin  238 Oct 11 17:24 hello_watchpoint
drwxr-xr-x  7 johnny  admin  238 Oct 11 17:24 multiple_threads
drwxr-xr-x  7 johnny  admin  238 Oct 11 17:24 watchpoint_commands

retcode: 0
(lldb)