A Scalable, User-Friendly Source Control System.
Go to file
Evan Krause 418ccf5ffd Prevent diff statuses from flex shrinking, fix alignment
Summary:
After we added more responsive design in D45671035, some styling seems to have broken and gone unnoticed.

- diff badges are now more more likely to be flex-shrunk by being in a slightly too narrow display that's not narrow enough to fully wrap. We should prevent this text wrap so diff statuses ("landing" etc) never wrap their text
- The uncommit button was top-aligned, but I think center align makes more sense, especially when you see it next to other  elements that should be centered (diff badge row)
- In fixing the uncommit button alignment, it messed up commit avatars. However, this is a good opportunity to fix the commit avatar alignment. I noticed in the past they were sometimes askew anyway.
  - We instead align avatars to be centered as well (top & bottom : auto)
  - This then causes a new bug, where the commit graph line border may poke out above the commit avatar.
  - We can cover this up by re-adding the background perfectly aligned with the border, with the right height for the commit, but only do this for the topmost commit of a stack
  - Lastly, if its the head commit, then we shouldn't cover up with the background color, but rather the blue color used for "You are here" to blend in properly.

All these things taken together seem to give a good look.

Reviewed By: muirdm

Differential Revision: D45785794

fbshipit-source-id: 2ddb3c552a6d183ea5bc20ae0ba3b8aa32ec9845
2023-05-11 13:03:17 -07:00
.github/workflows bump macOS python CI to 3.11.3 (#605) 2023-04-18 10:12:23 -07:00
addons Prevent diff statuses from flex shrinking, fix alignment 2023-05-11 13:03:17 -07:00
build Updating submodules 2023-05-11 12:53:22 -07:00
ci fix compatibility with PEP 440 (#606) 2023-04-18 10:12:23 -07:00
CMake Add Blake3 support 2023-03-21 15:12:32 -07:00
common Back out "fbcode/fboss/common/" 2023-04-25 21:31:34 -07:00
configerator/structs/scm Add support for new database in repo config 2023-05-11 04:09:24 -07:00
eden disable response compression 2023-05-11 12:47:52 -07:00
website website: use consistent file name for curl and install 2023-05-08 11:10:58 -07:00
.gitignore mononoke: add README.md and the missing pieces for supporting cargo (#13) 2020-02-13 00:12:36 -08:00
.projectid replace the old getdeps.py script with a build.sh script 2020-03-30 19:27:54 -07:00
build.bat fs: fix license header 2022-01-04 15:00:07 -08:00
build.sh fs: fix license header 2022-01-04 15:00:07 -08:00
clippy.toml Add support for clippy.toml configuration file 2023-03-10 19:22:46 -08:00
CMakeLists.txt fs: fix license header 2022-01-04 15:00:07 -08:00
CODE_OF_CONDUCT.md Adopt Contributor Covenant 2019-08-29 23:23:31 -07:00
CONTRIBUTING.md fix CONTRIBUTING.md to reference main instead of master (#436) 2023-01-18 19:58:13 -08:00
LICENSE relicense to GPLv2 2019-06-19 17:02:45 -07:00
make-client.py fs: fix license header 2022-01-04 15:00:07 -08:00
README.md website: downplay Mononoke and EdenFS in readme.md 2022-11-15 09:02:28 -08:00
requirements_ubuntu.txt include oss installation instructions for ubuntu 2020-07-24 11:34:17 -07:00
rustfmt.toml rustfmt.toml: group_imports = StdExternalCrate 2022-08-06 12:33:42 -07:00
SAPLING_VERSION bump SAPLING_VERSION from 0.1 to 0.2 in preparation for the next release 2022-12-21 12:23:53 -08:00

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.