Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -302,6 +302,25 @@ target_link_libraries(${MY_TARGET_NAME} argh)

```

## Tipi.build

`argh` can be easily used in [tipi.build](https://tipi.build) projects simply by adding the following entry to your `.tipi/deps`:

```json
{
"adishavit/argh": { "x": [ "*.cpp" ]}
}
```

> `argh` itself is a header-only library hence the exclusion of all `.cpp` files above. This isn't stricly required to inlcude `argh` but speeds up the build.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do you say it "speeds up the build."?
There are no .cpp files - it is a header only library.
The .cpp files are only for testing and the example files. You do not need them for using argh.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In tipi we use a source scan based approach to dependency management, instead of having you provide some type of script to make argh usable in someone else's project. Basically when someone adds that line to his .tipi/deps files, tipi will pull argh straight from Github and install it in a project specific sysroot.

By excluding the *.cpp files that are not actually part of argh (but rather only test cases and examples) these files are not being scanned or compiled which can save a bit of time.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't completely understand.

So is adding that json snippet with the *.cpp needed or not?
Is there some way or a need to exclude stuff?


To try this you can run the following command in `/test_package` (change the target name appropriately to `linux` or `macos` or `windows`):

```bash=
tipi . -t <target>
./build/linux-cxx17/bin/test_package -v
```

## Buck

The [Buck](https://buckbuild.com/) build system is also supported.
Expand Down
3 changes: 3 additions & 0 deletions test_package/.tipi/deps
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"adishavit/argh": { "x": [ "*.cpp" ]}
}