README.md.html

__NAME
======

General purpose dependency manager, with a slight focus on static C libraries

Summary
-------

```
<!-- #include "src/command/help/topic/global.txt" -->
```

Installation
------------

To install __NAME, simply download [dist/dep](dist/dep) and place it in your
`/usr/local/bin` directory or anywhere else that's included in your `$PATH`.

By default, no default repositories are enabled, so it's advisable to run the
following to enable the official repository:

```sh
__NAME repository add finwo https://github.com/finwo/dep-repository/archive/refs/heads/main.tar.gz
```

Usage
-----

#### Update repositories

__NAME keeps local cache of the repositories you have enabled. To update this
cache, run the following command

```sh
__NAME repository update
```

#### Adding a dependency to your project

To add a package, you can call the following command to install a specific
version of the package:

```sh
__NAME add package/identifier@version
```

If you have package.channel set in your project's package.ini, you can also
leave the version from the command to automatically select the version you've
set there.

```ini
[package]
channel=edge
```

```sh
__NAME add package/identifier
```

For example, if you'd want to install the [finwo/palloc][palloc] package, you
could use the following comamnd:

```sh
__NAME add finwo/palloc@edge # with version specifier
__NAME add finwo/palloc      # without version specifier
```

Building
--------

Building this dependency manager requires
[preprocess](https://pypi.org/project/preprocess/) which you can install by
running `pip install preprocess`.

After fetching the preprocess dependency, you can build & install dep by running
the following commands:

```sh
make
sudo make install
```

To install the binary in a location other than `/usr/local/bin`, pass the
`DESTDIR` definition to the `make install` command (default: `/usr/local`).

License
-------

This project falls under the [MIT license](LICENSE)

[palloc]: https://github.com/finwo/palloc.c