mirror of
https://github.com/llvm/llvm-project.git
synced 2025-04-25 23:56:05 +00:00

Summary: modify-python-lldb.py had code to insert python equality operators to some classes. Some of those classes already had c++ equality operators, and some didn't. This makes the situation more consistent, by removing all equality handilng from modify-python-lldb. Instead, I add c++ operators to classes where they were missing, and expose them in the swig interface files so that they are available to python too. The only tricky case was the SBAddress class, which had an operator== defined as a free function, which is not handled by swig. This function cannot be removed without breaking ABI, and we cannot add an extra operator== member, as that would make equality comparisons ambiguous. For this class, I define a python __eq__ function by hand and have it delegate to the operator!=, which I have defined as a member function. This isn't fully NFC, as the semantics of some equality functions in python changes slightly, but I believe it changes for the better (e.g., previously SBBreakpoint.__eq__ would consider two breakpoints with the same ID as equal, even if they belonged to different targets; now they are only equal if they belong to the same target). Reviewers: jingham, clayborg, zturner Subscribers: jdoerfert, JDevlieghere, lldb-commits Differential Revision: https://reviews.llvm.org/D59819 llvm-svn: 357463
112 lines
3.5 KiB
C++
112 lines
3.5 KiB
C++
//===-- SWIG Interface for SBFileSpec ---------------------------*- C++ -*-===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
namespace lldb {
|
|
|
|
%feature("docstring",
|
|
"Represents a file specification that divides the path into a directory and
|
|
basename. The string values of the paths are put into uniqued string pools
|
|
for fast comparisons and efficient memory usage.
|
|
|
|
For example, the following code
|
|
|
|
lineEntry = context.GetLineEntry()
|
|
self.expect(lineEntry.GetFileSpec().GetDirectory(), 'The line entry should have the correct directory',
|
|
exe=False,
|
|
substrs = [self.mydir])
|
|
self.expect(lineEntry.GetFileSpec().GetFilename(), 'The line entry should have the correct filename',
|
|
exe=False,
|
|
substrs = ['main.c'])
|
|
self.assertTrue(lineEntry.GetLine() == self.line,
|
|
'The line entry's line number should match ')
|
|
|
|
gets the line entry from the symbol context when a thread is stopped.
|
|
It gets the file spec corresponding to the line entry and checks that
|
|
the filename and the directory matches what we expect.
|
|
") SBFileSpec;
|
|
class SBFileSpec
|
|
{
|
|
public:
|
|
SBFileSpec ();
|
|
|
|
SBFileSpec (const lldb::SBFileSpec &rhs);
|
|
|
|
SBFileSpec (const char *path);// Deprecated, use SBFileSpec (const char *path, bool resolve)
|
|
|
|
SBFileSpec (const char *path, bool resolve);
|
|
|
|
~SBFileSpec ();
|
|
|
|
bool operator==(const SBFileSpec &rhs) const;
|
|
|
|
bool operator!=(const SBFileSpec &rhs) const;
|
|
|
|
bool
|
|
IsValid() const;
|
|
|
|
explicit operator bool() const;
|
|
|
|
bool
|
|
Exists () const;
|
|
|
|
bool
|
|
ResolveExecutableLocation ();
|
|
|
|
const char *
|
|
GetFilename() const;
|
|
|
|
const char *
|
|
GetDirectory() const;
|
|
|
|
void
|
|
SetFilename(const char *filename);
|
|
|
|
void
|
|
SetDirectory(const char *directory);
|
|
|
|
uint32_t
|
|
GetPath (char *dst_path, size_t dst_len) const;
|
|
|
|
static int
|
|
ResolvePath (const char *src_path, char *dst_path, size_t dst_len);
|
|
|
|
bool
|
|
GetDescription (lldb::SBStream &description) const;
|
|
|
|
void
|
|
AppendPathComponent (const char *file_or_directory);
|
|
|
|
%pythoncode %{
|
|
def __get_fullpath__(self):
|
|
spec_dir = self.GetDirectory()
|
|
spec_file = self.GetFilename()
|
|
if spec_dir and spec_file:
|
|
return '%s/%s' % (spec_dir, spec_file)
|
|
elif spec_dir:
|
|
return spec_dir
|
|
elif spec_file:
|
|
return spec_file
|
|
return None
|
|
|
|
__swig_getmethods__["fullpath"] = __get_fullpath__
|
|
if _newclass: fullpath = property(__get_fullpath__, None, doc='''A read only property that returns the fullpath as a python string.''')
|
|
|
|
__swig_getmethods__["basename"] = GetFilename
|
|
if _newclass: basename = property(GetFilename, None, doc='''A read only property that returns the path basename as a python string.''')
|
|
|
|
__swig_getmethods__["dirname"] = GetDirectory
|
|
if _newclass: dirname = property(GetDirectory, None, doc='''A read only property that returns the path directory name as a python string.''')
|
|
|
|
__swig_getmethods__["exists"] = Exists
|
|
if _newclass: exists = property(Exists, None, doc='''A read only property that returns a boolean value that indicates if the file exists.''')
|
|
%}
|
|
|
|
};
|
|
|
|
} // namespace lldb
|