Using termcolor with tipi.build

.github/workflows/tipi.yml

@@ -0,0 +1,28 @@
+name: Tipi
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:  
+  tipi-build-linux:
+    runs-on: ubuntu-latest
+    container: tipibuild/tipi-ubuntu
+
+    env:
+      HOME: /root
+
+    steps:
+      - uses: actions/checkout@v2
+      - run: mkdir -p ~/.tipi
+
+      # checking if the termcolor project itself builds and passes tests
+      - run: tipi . --dont-upgrade --verbose --test all -t linux-cxx17
+      - run: tipi . --dont-upgrade --verbose --test all -t linux-cxx20
+      - run: rm -r ./build
+
+      # trying if pulling the dependency with tipi works properly
+      - run: tipi ./examples/tipi-simple --dont-upgrade --verbose -t linux-cxx17
+      - run: ./examples/tipi-simple/build/linux-cxx17/bin/example

.tipi/deps

@@ -0,0 +1 @@
+{}

.tipi/opts.vs-16-2019-win64-cxx17

@@ -0,0 +1,2 @@
+# As per README, probably a sane default
+add_compile_definitions( NOMINMAX=1 )

.tipi/opts.windows

@@ -0,0 +1,2 @@
+# As per README, probably a sane default
+add_compile_definitions( NOMINMAX=1 )

README.rst

@@ -37,6 +37,20 @@ Installation
 * Add ``termcolor.hpp`` (grab it from ``include/termcolor/termcolor.hpp``) to
   the project and use stream manipulators from the ``termcolor`` namespace.
 
+
+* You can also use tipi.build_ to use the library. Just add to your ``.tipi/deps``:
+
+  .. code:: json
+
+       {
+          "ikalnytskyi/termcolor": { "@": "v2.0.0" }
+       }
+
+  .. _tipi.build: https://tipi.build/
+
+  Replace the content of the ``@`` section to fetch another tag/branch/release or remove it completely to *live at HEAD*. 
+  A sample project can be found in the ``/examples`` folder of this project.
+
 * You can also use vcpkg_ to install the library:
 
   .. code:: sh

examples/tipi-simple/.tipi/deps

@@ -0,0 +1,3 @@
+{
+    "ikalnytskyi/termcolor": { "@": "v2.0.0" }
+}

examples/tipi-simple/README.rst

@@ -0,0 +1,22 @@
+Termcolor example with tipi.build
+=================================
+
+This example shows how Termcolor_ can be easily used with tipi.build_.
+
+.. _Termcolor: https://github.com/ikalnytskyi/termcolor
+.. _tipi.build: https://tipi.build/
+
+Building the example
+--------------------
+
+You can build the example using one of the following commands (depending on your host OS):
+
+  .. code:: sh
+
+      $ tipi . -t linux
+      $ tipi . -t macos
+      $ tipi . -t windows
+      $ tipi . -t vs-16-2019-win64-cxx17
+
+
+Use the command ``tipi build . -t <target>`` to execute remote builds for targets not supported by your host OS using tipi.

examples/tipi-simple/example.cpp

@@ -0,0 +1,11 @@
+#include <iostream>
+#include <termcolor/termcolor.hpp>
+
+int main(int /* argc */, char** /* argv */) {
+    std::cout
+        << termcolor::yellow << "Warm welcome to "
+        << termcolor::blue << termcolor::underline << "TERMCOLOR"
+        << termcolor::bold << termcolor::bright_red << "+tipi.build"
+        << termcolor::reset << std::endl;
+    return 0;
+}