SOKRATES

Polyglot source code examination tool

"Talk is expensive. Show me the code."

― Željko Obrenović

What is Sokrates?

  • Sokrates is a tool built by Željko Obrenović. It implements his vision on how to document and analyze software architectures of complex systems.
  • Sokrates is provides a pragmatic, inexpensive way to extract rich data from any source code repositories. No need for long interviews and workshops. Just show the code.
  • Sokrates can help you to understand your code by making visible the size, complexity, and coupling of software, as well all people interactions and team topologies.
  • Sokrates borrows ideas from code spelunking tool, in particular grep, adding structure on top of regex source code searches.

Examples: Sokrates Analyses of Big Projects and Whole GitHub Organizations

Linux Source Code Landscape
23 MLOC, 17,000 contributors, 330K commits
Apache Software Foundation (ASF) Projects
1,100+ repos, 100 MLOC, 24,000 contributors, 2M commits
Amazon's OSS Projects
2,700 repos, 60 MLOC, 13,000 contributors, 600K commits
Google's OSS Projects
1,000 repos, 40 MLOC, 12,000+ contributors, 1.2M commits
Facebook/Meta's OSS Projects
150 repos, 37 MLOC, 14,000 contributors, 900K commits
Microsoft's OSS Projects
2,500 repos, 47 MLOC, 18,000 contributors, 1.2M commits
GitHub's OSS Projects
200 repos, 2 MLOC, 4,400 contributors, 1.2M commits
Twitter's OSS Projects
60 repos, 850 KLOC, 1,000 contributors, 45K commits
Spotify's OSS Projects
100+ repos, 1.7 MLOC, 2,000+ contributors, 95K commits
Apple's OSS Projects
100 repos, 4.5 MLOC, 1,700 contributors, 200K commits
Uber's OSS Projects
80 repos, 1.1 MLOC, 1,200 contributors, 48K commits
Netflix's OSS Projects
70 repos, 1.6 MLOC, 2,000 contributors, 80K commits
NOTE: If you want to perform similar landscape analyses of all repositories in a GitHub organization, take a look at this project github.com/zeljkoobrenovic/sokrates-oss-landscape-analysis

Examples: Sokrates Analyses of Individual Repositories

Tomcat
Apache Kafka
ActiveMQ

The Sokrates Book: A Collections of Articles on Sokrates

Sokrates in 5 minutes

See a 5 minutes video on using Sokrates CLI to analyze source code of Sokrates:

See a 5 minutes video on using Sokrates Explorer to analyze source code of JUnit4:

Background

Sokrates looks on the source code from a perspective of maintenance, making visible the size, complexity and coupling of software.

For more details see my O'Reilly Video Training (from my time at Software Improvement Group): Building Maintainable Software (4 hours), and O'Reilly Webcast: Building Maintainable Software (1 hour, together with Rob van der Leek).

The fragment of my training video on building maintainable software is freely avaliable at Youtube: