sapling/eden/scm/lib/README.md
Adam Simpkins ab3a7cb21f Move fb-mercurial sources into an eden/scm subdirectory.
Summary:
In preparation for merging fb-mercurial sources to the Eden repository,
move everything from the top-level directory into an `eden/scm`
subdirectory.
2019-11-13 16:04:48 -08:00

21 lines
791 B
Markdown

lib
===
Any native code (C/C++/Rust) that Mercurial (either core or extensions)
depends on should go here. Python code, or native code that depends on
Python code (e.g. `#include <Python.h>` or `use cpython`) is disallowed.
As we start to convert more of Mercurial into Rust, and write new paths
entrirely in native code, we'll want to limit our dependency on Python, which is
why this barrier exists.
See also `hgext/extlib/README.md`, `mercurial/cext/README.mb`.
How do I choose between `lib` and `extlib` (and `cext`)?
--------------------------------------------------------
If your code is native and doesn't depend on Python (awesome!), it goes here.
Otherwise, put it in `hgext/extlib` (if it's only used by extensions) or
`mercurial/cext` (if it's used by extensions or core).