Sourcetrail alternatives and similar libraries
Based on the "Code Analysis" category.
Alternatively, view Sourcetrail alternatives based on common mentions on social networks and blogs.
-
Checkstyle
Checkstyle is a development tool to help programmers write Java code that adheres to a coding standard. By default it supports the Google Java Style Guide and Sun Code Conventions, but is highly configurable. It can be invoked with an ANT task and a command line program. -
NullAway
A tool to help eliminate NullPointerExceptions (NPEs) in your Java code with low build-time overhead -
Spoon
Spoon is a metaprogramming library to analyze and transform Java source code. :spoon: is made with :heart:, :beers: and :sparkles:. It parses source files to build a well-designed AST with powerful analysis and transformation API.
CodeRabbit: AI Code Reviews for Developers
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Sourcetrail or a related project?
README
Sourcetrail
Sourcetrail is a free and open-source cross-platform source explorer that helps you get productive on unfamiliar source code.
Links
- Website
- Download
- Quick Start Guide
- Documentation
- [Changelog](CHANGELOG.md)
- Slack Channel
- Mailing List
- Patreon
["Sourcetrail User Interface"](docs/readme/user_interface.png "Sourcetrail User Interface")
Sourcetrail is:
- free
- working offline
- operating on Windows, macOS and Linux
- supporting C, C++, Java and Python
- offering an SDK (SourcetrailDB) to write custom language extensions
Support Sourcetrail via Patreon
The ongoing development and regular software releases are made possible entirely by the support of [these awesome patrons](SPONSORS.md)! If you'd like to join them, please consider becoming a patron of Sourcetrail.
Using Sourcetrail
To setup Sourcetrail on your machine, you can either download the respective build for your operating system from our list of Releases and install it on your machine, or use one of the following package managers:
- Use the Chocolatey package with
choco install sourcetrail
After your installation is complete, follow our Quick Start Guide to get to know Sourcetrail.
How to Report Issues
You can post all your feature requests and bug reports on our issue tracker.
Reporting
Use the following template:
- platform version:
- Sourcetrail version:
- description of the problem:
- steps to reproduce the problem:
Supporting
If you want to support a certain feature request or you have the same bug that another user already reported, please let us know:
- post a comment with "+1" to the issue
- or send an email to [email protected] with the issue ID
How to Contribute
- Please read and follow the steps in [CONTRIBUTING.md](CONTRIBUTING.md) file.
- You may want to look out for issues labeled good first issue to find some initial tasks to tackle.
- If you are looking for more information about Sourcetrail software development, please refer to our wiki.
How to Build
Building Sourcetrail requires several dependencies to be in place on your machine. However, our CMake based setup allows to disable indexing support for specific languages which reduces the number of dependencies to a minimum.
Building the Base Application
Required Tools
CMake v3.12 (required for Windows, Linux and MacOS)
- Reason: Used to generate a build configuration for your build system
- Download: https://cmake.org/download
Git (required for Windows, Linux and MacOS)
- Reason: Used for version control and to automatically generate the Sourcetrail version number from commits and tags
- Download: https://git-scm.com/download
- Remarks: Make sure
git
is added to yourPATH
environment variable before running CMake
Visual Studio (required for Windows)
- Reason: Used for building Sourcetrail
- Download: https://visualstudio.microsoft.com/downloads/
ccache (optional for Linux and MacOS)
- Reason: Used to speed up rebuilds if found in
PATH
- Download: https://ccache.dev/download.html
- Reason: Used to speed up rebuilds if found in
Required dependencies
Boost 1.67
- Reason: Used for file system access and interprocess communication
- Prebuilt Download for Windows: https://sourceforge.net/projects/boost/files/boost-binaries/
- Building for Unix:
$ ./bootstrap.sh --with-libraries=filesystem,program_options,system,date_time $ ./b2 --link=static --variant=release --threading=multi --runtime-link=static --cxxflags=-fPIC
Qt 5.12.3
- Reason: Used for rendering the GUI and for starting additional (indexer) processes.
- Prebuilt Download: http://download.qt.io/official_releases/qt/
Building
On Windows
To set up your build environment run:
$ git clone https://github.com/CoatiSoftware/Sourcetrail.git $ cd Sourcetrail $ mkdir -p build/win64 $ cd build/win64 $ cmake -G "Visual Studio 15 2017 Win64" -DBOOST_ROOT=<path/to/boost_1_67_0> -DQt5_DIR=<path/to/Qt/version/platform/compiler/lib/cmake/Qt5> ../..
Hint: If you are using the CMake GUI, we recommend that you activate advanced mode. Also you may be required to add some of the defines via the "Add Entry" button.
After generating the build configuration, just open the Sourcetrail.sln file that was generated by CMake and build the Sourcetrail project.
On Unix
- To set up your build environment run:
$ cd Sourcetrail $ mkdir -p build/Release $ cd build/Release $ cmake -DCMAKE_BUILD_TYPE="Release" -DBOOST_ROOT=<path/to/boost_1_67_0> -DQt5_DIR=<path/to/Qt/version/platform/compiler/lib/cmake/Qt5> ../..
- Now start the build with:
$ make Sourcetrail
Running
- Run Sourcetrail from within the build directory. During execution Sourcetrail needs resources from
bin/app/data
andbin/app/user
. CMake creates symlinks within the build directory that make these directories accessible.
Enable C/C++ Language Support
Required dependencies
- LLVM/Clang 11.0.0
- Reason: Used for running the preprocessor on the indexed source code, building and traversing an Abstract Syntax Tree and generating error messages.
- Building: Make sure to check out the correct tag:
git checkout llvmorg-11.0.0
- Building for Windows: Follow these steps to build the project. Run the cmake command exactly as described.
- Building for Unix: Follow this installation guide to build the project. Make sure to build with
-DLLVM_ENABLE_RTTI=ON
.
Building
- Run CMake with these additional options:
-DClang_DIR=<path/to/llvm_build>/lib/cmake/clang -DBUILD_CXX_LANGUAGE_PACKAGE=ON
- Build Sourcetrail as described above.
Enable Java Language Support
Required dependencies
JDK 1.8
- Reason: Used to build the Java indexer and make it callable from the C++ code via JNI.
- Remarks: Make sure that
<jdk_root>/bin
is available in yourPATH
environment variable and that theJAVA_HOME
environment variable is set:JAVA_HOME=<path/to/Java>/jdk1.x.x_xxx
Maven
- REASON: Used within Sourcetrail's automated tests.
- Remarks: Make sure
.../apache-maven-x.x.x/bin
is available in yourPATH
environment variable and that bothM2_HOME
andMAVEN_HOME
environment variables are set:M2_HOME=.../apache-maven-x.x.x MAVEN_HOME=.../apache-maven-x.x.x
Building
- Run CMake with these additional options:
-DBUILD_JAVA_LANGUAGE_PACKAGE=ON
- Build Sourcetrail as described above.
Enable Python Language Support
Required Tools
- 7z (required for Windows)
- REASON: Used to extract the prebuilt SourcetrailPythonIndexer which is downloaded automatically during build execution.
Building
- Run CMake with these additional options:
-DBUILD_PYTHON_LANGUAGE_PACKAGE=ON
- Build Sourcetrail as described above.
Creating the deployment Package
Windows
Required Tools
Visual Studio (required for Windows)
- Reason: Used for building the Sourcetrail Windows installer.
- Remarks: Make sure to install the
.Net desktop development
workload. - Download: https://visualstudio.microsoft.com/downloads/
Wix 3.11
- Reason: Used to build the
sourcetrail.msi
Windows installer. - Remarks: Make sure to add
<path/to>/WiX Toolset v3.11/bin
to yourPATH
environment variable. - Download: https://wixtoolset.org/releases/
- Reason: Used to build the
Wix extension for Visual Studio
- Reason: Used to run Wix from the Visual Studio build environment.
- Download: https://marketplace.visualstudio.com/items?itemName=WixToolset.WixToolsetVisualStudio2017Extension
JRE
- Reason: Used for indexing the java sample project that ships with the package.
WinRAR
- Reason: Used for creating the final zip files for the installer and the portable package.
- Remarks: Make sure to add
<path/to>/WinRAR
to yourPATH
environment variable.
Building
- Run
./script/deploy_windows.sh
from your Developer Command Prompt for Visual Studio. The script which will generate a 64bit build and packages it into a portable.zip
file and a Wix-based Windows installer, each.
macOS
After building, run the bundle_install.sh
script within the build directory which will create a Sourcetrail.app
bundle and generate a Sourcetrail_<version>.dmg
container.
Linux
Run ./setup/Linux/createPackages.sh
from the main directory, which creates both a .tar.gz
and a .AppImage
package in the main directory. Packaging depends on linuxdeployqt.
How to Run the Tests
The automated test suite of Sourcetrail is powered by Catch2. To run the tests, simply execute the Sourcetrail_test
binary. Before executing, please make sure to set the working directory to ./bin/test
.
License
Sourcetrail is licensed under the [GNU General Public License Version 3](LICENSE.txt).
Trademark
The "Sourcetrail" name is a trademark owned by Coati Software and is not included within the assets licensed under the GNU GPLv3.
*Note that all licence references and agreements mentioned in the Sourcetrail README section above
are relevant to that project's source code only.