What is this?
Sapling is a cross-platform, Git-compatible source control system built by Meta, designed to scale to repositories with millions of files and commits while staying user-friendly.
Sapling is a cross-platform, Git-compatible source control system built by Meta, designed to scale to repositories with millions of files and commits while staying user-friendly.Is this just a CLI, or more than that?It is an ecosystem of three parts: the sl command-line client (and its web-based Interactive Smartlog UI), the Mononoke server, and the EdenFS virtual filesystem for checkouts.
It is an ecosystem of three parts: the sl command-line client (and its web-based Interactive Smartlog UI), the Mononoke server, and the EdenFS virtual filesystem for checkouts.How do I get the Sapling CLI running?Build it by running 'make oss' inside the eden/scm directory, then run the resulting sl executable. There is also a Getting Started guide for cloning existing Git repositories.
Build it by running 'make oss' inside the eden/scm directory, then run the resulting sl executable. There is also a Getting Started guide for cloning existing Git repositories.What do I need installed to build it?You need Python 3.8, Rust, CMake, and OpenSSL for the main CLI, plus Node and Yarn if you also want to build the Interactive Smartlog (ISL) web UI.
You need Python 3.8, Rust, CMake, and OpenSSL for the main CLI, plus Node and Yarn if you also want to build the Interactive Smartlog (ISL) web UI.Can I actually use Mononoke and EdenFS myself?Not for production use outside Meta — both are used internally at Meta but only buildable as OSS for unsupported experimentation; only the sl CLI is intended for general external use.
Not for production use outside Meta — both are used internally at Meta but only buildable as OSS for unsupported experimentation; only the sl CLI is intended for general external use.Does the CLI work on all my machines?Yes, the Sapling CLI builds and runs on Linux, Mac, and Windows.
Yes, the Sapling CLI builds and runs on Linux, Mac, and Windows.How is Sapling related to Git?Sapling is Git-compatible — you clone your existing Git repositories into it, and it offers a Git Cheat Sheet for people switching from Git.
Sapling is Git-compatible — you clone your existing Git repositories into it, and it offers a Git Cheat Sheet for people switching from Git.Why does EdenFS make large repos faster?EdenFS populates working directory files on demand as they are accessed instead of checking out everything upfront, which speeds up operations like checkout at the cost of a small first-access penalty per file.
EdenFS populates working directory files on demand as they are accessed instead of checking out everything upfront, which speeds up operations like checkout at the cost of a small first-access penalty per file.Is there a GUI, or is it command-line only?Sapling includes the Interactive Smartlog (ISL), a web UI for viewing and interacting with your repository, plus a VS Code-integrated version of it.
Sapling includes the Interactive Smartlog (ISL), a web UI for viewing and interacting with your repository, plus a VS Code-integrated version of it.Where does Sapling's CLI code come from?The sl CLI was originally based on Mercurial and still shares much of its UI and feature set; the code lives in the eden/scm subdirectory.
The sl CLI was originally based on Mercurial and still shares much of its UI and feature set; the code lives in the eden/scm subdirectory.Which topics is it in?version-control, webui, gplv2, vscode, monorepo, git, distributed-systems, performance, rust, command-line-tool, terminal, server
version-control, webui, gplv2, vscode, monorepo, git, distributed-systems, performance, rust, command-line-tool, terminal, server