path: root/build/cli/rule.cxx

// file      : build/cli/rule.cxx -*- C++ -*-
// copyright : Copyright (c) 2014-2015 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

#include <build/cli/rule>

#include <butl/process>

#include <build/scope>
#include <build/target>
#include <build/context>
#include <build/algorithm>
#include <build/diagnostics>

#include <build/cli/target>

#include <build/config/utility>

using namespace std;
using namespace butl;

namespace build
{
  namespace cli
  {
    using config::append_options;

    match_result compile::
    match (action a, target& xt, const std::string&) const
    {
      tracer trace ("cli::compile::match");

      if (cli_cxx* pt = xt.is_a<cli_cxx> ())
      {
        cli_cxx& t (*pt);

        // See if we have a .cli source file.
        //
        match_result r;
        for (prerequisite_member p: group_prerequisite_members (a, t))
        {
          if (p.is_a<cli> ())
          {
            //@@ Need to verify input and output stems match.
            r = p;
            break;
          }
        }

        if (!r)
        {
          level3 ([&]{trace << "no .cli source file for target " << t;});
          return nullptr;
        }

        // If we still haven't figured out the member list, we can do
        // that now. Specifically, at this stage no further changes to
        // cli.options are possible and we can determine whether the
        // --suppress-inline option is present.
        //
        if (t.h == nullptr)
        {
          t.h = &search<cxx::hxx> (t.dir, t.name, nullptr, nullptr);
          t.h->group = &t;

          t.c = & search<cxx::cxx> (t.dir, t.name, nullptr, nullptr);
          t.c->group = &t;

          bool inl (true);
          if (auto val = t["cli.options"])
          {
            for (const name& n: val.template as<const list_value&> ())
            {
              if (n.value == "--suppress-inline")
              {
                inl = false;
                break;
              }
            }
          }

          if (inl)
          {
            t.i = &search<cxx::ixx> (t.dir, t.name, nullptr, nullptr);
            t.i->group = &t;
          }
        }

        return r;
      }
      else
      {
        // One of the ?xx{} members.
        //
        target& t (xt);

        // First see if we are already linked-up to the cli.cxx{} group.
        // If it is some other group, then we are definitely not a match.
        //
        if (t.group != nullptr)
          return t.group->is_a<cli_cxx> ();

        // Then see if there is a corresponding cli.cxx{} group.
        //
        cli_cxx* g (targets.find<cli_cxx> (t.dir, t.name));

        // Finally, if this target has a cli{} prerequisite, synthesize
        // the group.
        //
        if (g == nullptr)
        {
          for (prerequisite_member p: group_prerequisite_members (a, t))
          {
            if (p.is_a<cli> ()) // @@ Need to check that stems match.
            {
              g = &targets.insert<cli_cxx> (t.dir, t.name, trace);
              g->prerequisites.emplace_back (p.as_prerequisite (trace));
              break;
            }
          }
        }

        if (g != nullptr)
        {
          // Resolve the group's members. This should link us up to
          // the group.
          //
          resolve_group_members (a, *g);

          // For ixx{}, verify it is part of the group.
          //
          if (t.is_a<cxx::ixx> () && g->i == nullptr)
          {
            level3 ([&]{trace << "generation of inline file " << t
                              << " is disabled with --suppress-inline";});
            g = nullptr;
          }
        }

        assert (t.group == g);
        return g;
      }
    }

    recipe compile::
    apply (action a, target& xt, const match_result& mr) const
    {
      if (cli_cxx* pt = xt.is_a<cli_cxx> ())
      {
        cli_cxx& t (*pt);

        // Derive file names for the members.
        //
        t.h->derive_path ();
        t.c->derive_path ();
        if (t.i != nullptr)
          t.i->derive_path ();

        // Inject dependency on the output directory.
        //
        inject_parent_fsdir (a, t);

        // Search and match prerequisite members.
        //
        search_and_match_prerequisite_members (a, t);

        switch (a)
        {
        case perform_update_id: return &perform_update;
        case perform_clean_id: return &perform_clean;
        default: return default_recipe; // Forward to prerequisites.
        }
      }
      else
      {
        cli_cxx& g (*static_cast<cli_cxx*> (mr.target));
        build::match (a, g);
        return group_recipe;
      }
    }

    static void
    append_extension (vector<const char*>& args,
                      path_target& t,
                      const char* opt,
                      const char* def)
    {
      assert (t.ext != nullptr); // Should have been figured out in apply().

      if (*t.ext != def)
      {
        // CLI needs the extension with the leading dot (unless it is empty)
        // while we store the extension without. But if there is an extension,
        // then we can get it (with the dot) from the file name.
        //
        args.push_back (opt);
        args.push_back (t.ext->empty ()
                        ? t.ext->c_str ()
                        : t.path ().extension () - 1);
      }
    }

    target_state compile::
    perform_update (action a, target& xt)
    {
      cli_cxx& t (static_cast<cli_cxx&> (xt));

      // Execute our prerequsites and check if we are out of date.
      //
      cli* s (execute_prerequisites<cli> (a, t, t.mtime ()));

      if (s == nullptr)
        return target_state::unchanged;

      // Translate source path to relative (to working directory). This
      // results in easier to read diagnostics.
      //
      path relo (relative (t.dir));
      path rels (relative (s->path ()));

      scope& rs (t.root_scope ());
      const string& cli (rs["config.cli"].as<const string&> ());

      vector<const char*> args {cli.c_str ()};

      // See if we need to pass any --?xx-suffix options.
      //
      append_extension (args, *t.h, "--hxx-suffix", "hxx");
      append_extension (args, *t.c, "--cxx-suffix", "cxx");
      if (t.i != nullptr)
        append_extension (args, *t.i, "--ixx-suffix", "ixx");

      append_options (args, t, "cli.options");

      if (!relo.empty ())
      {
        args.push_back ("-o");
        args.push_back (relo.string ().c_str ());
      }

      args.push_back (rels.string ().c_str ());
      args.push_back (nullptr);

      if (verb)
        print_process (args);
      else
        text << "cli " << *s;

      try
      {
        process pr (args.data ());

        if (!pr.wait ())
          throw failed ();

        t.mtime (system_clock::now ());
      }
      catch (const process_error& e)
      {
        error << "unable to execute " << args[0] << ": " << e.what ();

        if (e.child ())
          exit (1);

        throw failed ();
      }

      return target_state::changed;
    }

    target_state compile::
    perform_clean (action a, target& xt)
    {
      cli_cxx& t (static_cast<cli_cxx&> (xt));

      // The reverse order of update: first delete the files, then clean
      // prerequisites. Also update timestamp in case there are operations
      // after us that could use the information.
      //
      //
      bool r (false);

      if (t.i != nullptr)
        r = rmfile (t.i->path (), *t.i) || r;
      r = rmfile (t.c->path (), *t.c) || r;
      r = rmfile (t.h->path (), *t.h) || r;

      t.mtime (timestamp_nonexistent);

      // Clean prerequisites.
      //
      target_state ts (reverse_execute_prerequisites (a, t));

      return r ? target_state::changed : ts;
    }
  }
}