# Earthly lib

The Earthly [lib](https://github.com/earthly/lib) is a collection of reusable functions for common operations to be used in Earthfiles.

Earthly lib is split across multiple packages, each of which can be imported separately. The packages are:

* [billing](https://github.com/earthly/lib/tree/main/billing) - functions for estimating billing
* [rust](https://github.com/earthly/lib/tree/main/rust) - functions for working with Rust
* [utils/dind](https://github.com/earthly/lib/tree/main/utils/dind) - functions for working with Docker-in-Docker
* [utils/git](https://github.com/earthly/lib/tree/main/utils/git) - functions for working with Git
* [utils/ssh](https://github.com/earthly/lib/tree/main/utils/ssh) - functions for working with SSH

See the individual packages for more information.

Additional language-specific functions are currently planned for later in 2024.

## Usage

To use Earthly lib, import the package you want to use in your Earthfile:

```dockerfile
IMPORT github.com/earthly/lib/utils/git:2.2.11 AS git
```

Then, call the function you want to use:

```dockerfile
DO git+DEEP_CLONE --GIT_URL=...
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.earthly.dev/docs/earthly-lib.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.