A Scalable, User-Friendly Source Control System.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Egor Tkachenko bdd11d99e8 Add logging when service requests remote derivation
Summary: After enabling remote derivation we've lost related to derivation logging in the parent scuba table (like SCS server). This diffs add log tags, which indicates when we requested remoted derivation and when it was finished. In case of the error we already had the logging in place.

Reviewed By: Croohand

Differential Revision: D44297304

fbshipit-source-id: 1e2f6e279e111ce01b2feaf950a11c7b69a314cf
3 hours ago
.github/workflows ci: downgrade openssl from 1.1.1t to 1.1.1s 4 weeks ago
CMake Add Blake3 support 6 days ago
addons VS Code extension 0.1.11 3 days ago
build Updating submodules 5 hours ago
ci ci: downgrade openssl from 1.1.1t to 1.1.1s 4 weeks ago
common Add NetworkUtil stub function to fix FBOSS OSS build 3 weeks ago
configerator/structs/scm enable `futures-03` feature 2 weeks ago
eden Add logging when service requests remote derivation 3 hours ago
website website: submoudle -> submodule 2 weeks ago
.gitignore mononoke: add README.md and the missing pieces for supporting cargo (#13) 3 years ago
.projectid replace the old getdeps.py script with a build.sh script 3 years ago
CMakeLists.txt fs: fix license header 1 year ago
CODE_OF_CONDUCT.md Adopt Contributor Covenant 4 years ago
CONTRIBUTING.md fix CONTRIBUTING.md to reference main instead of master (#436) 2 months ago
LICENSE relicense to GPLv2 4 years ago
README.md website: downplay Mononoke and EdenFS in readme.md 4 months ago
SAPLING_VERSION bump SAPLING_VERSION from 0.1 to 0.2 in preparation for the next release 3 months ago
build.bat fs: fix license header 1 year ago
build.sh fs: fix license header 1 year ago
clippy.toml Add support for clippy.toml configuration file 2 weeks ago
make-client.py fs: fix license header 1 year ago
requirements_ubuntu.txt include oss installation instructions for ubuntu 3 years ago
rustfmt.toml rustfmt.toml: group_imports = StdExternalCrate 8 months ago

README.md

Sapling SCM

Sapling SCM is a cross-platform, highly scalable, Git-compatible source control system.

It aims to provide both user-friendly and powerful interfaces for users, as well as extreme scalability to deal with repositories containing many millions of files and many millions of commits.

Using Sapling

To start using Sapling, see the Getting Started page for how to clone your existing Git repositories. Checkout the Overview for a peek at the various features. Coming from Git? Checkout the Git Cheat Sheet.

Sapling also comes with an Interactive Smartlog (ISL) web UI for seeing and interacting with your repository, as well as a VS Code integrated Interactive Smartlog.

The Sapling Ecosystem

Sapling SCM is comprised of three main components:

  • The Sapling client: The client-side sl command line and web interface for users to interact with Sapling SCM.
  • Mononoke: A highly scalable distributed source control server. (Not yet supported publicly.)
  • EdenFS: A virtual filesystem for efficiently checking out large repositories. (Not yet supported publicly.)

Sapling SCM's scalability goals are to ensure that all source control operations scale with the number of files in use by a developer, and not with the size of the repository itself. This enables fast, performant developer experiences even in massive repositories with millions of files and extremely long commit histories.

Sapling CLI

The Sapling CLI, sl, was originally based on Mercurial, and shares various aspects of the UI and features of Mercurial.

The CLI code can be found in the eden/scm subdirectory.

Mononoke

Mononoke is the server-side component of Sapling SCM.

While it is used in production within Meta, it currently does not build in an open source context and is not yet supported for external usage.

EdenFS

EdenFS is a virtual file system for managing Sapling checkouts.

While it is used in production within Meta, it currently does not build in an open source context and is not yet supported for external usage.

EdenFS speeds up operations in large repositories by only populating working directory files on demand, as they are accessed. This makes operations like checkout much faster, in exchange for a small performance hit when first accessing new files. This is quite beneficial in large repositories where developers often only work with a small subset of the repository at a time.

More detailed EdenFS design documentation can be found at eden/fs/docs/Overview.md.

Building the Sapling CLI

The Sapling CLI currently builds and runs on Linux, Mac, and Windows. It can be built by running make oss in the eden/scm directory and running the resulting sl executable.

Building the Sapling CLI requires Python 3.8, Rust, cmake, and OpenSSL for the main cli, and Node and Yarn for the ISL web UI.

License

See LICENSE.