base.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
#ifndef TVM_SCRIPT_IR_BUILDER_BASE_H_
#define TVM_SCRIPT_IR_BUILDER_BASE_H_
 
#include <tvm/ffi/reflection/registry.h>
#include <tvm/ir/expr.h>
#include <tvm/ir/function.h>
#include <tvm/ir/object_functor.h>
 
#include <vector>
 
namespace tvm {
namespace script {
namespace ir_builder {
 
 
class IRBuilderFrameObj : public ffi::Object {
 public:
  IRBuilderFrameObj();
  std::vector<ffi::TypedFunction<void()>> callbacks;
  mutable Location loc = UnknownLoc();
 
  static void RegisterReflection() {
    namespace refl = tvm::ffi::reflection;
    refl::ObjectDef<IRBuilderFrameObj>().def_ro("loc", &IRBuilderFrameObj::loc);
    // `callbacks` is not registered as it's not visited.
  }
 
  static constexpr const bool _type_mutable = true;
  TVM_FFI_DECLARE_OBJECT_INFO("script.ir_builder.IRBuilderFrame", IRBuilderFrameObj, ffi::Object);
 
 public:
  virtual ~IRBuilderFrameObj() = default;
  virtual void EnterWithScope();
  virtual void ExitWithScope();
  void AddCallback(ffi::TypedFunction<void()> callback);
};
 
class IRBuilderFrame : public ffi::ObjectRef {
 public:
  TVM_FFI_DEFINE_OBJECT_REF_METHODS_NOTNULLABLE(IRBuilderFrame, ffi::ObjectRef, IRBuilderFrameObj);
 
 protected:
  IRBuilderFrame() = default;
  explicit IRBuilderFrame(ffi::ObjectPtr<IRBuilderFrameObj> data) : ffi::ObjectRef(data) {}
 
 public:
  inline void EnterWithScope() {
    TVM_FFI_ICHECK(data_ != nullptr);
    static_cast<IRBuilderFrameObj*>(data_.get())->EnterWithScope();
  }
  inline void ExitWithScope() {
    TVM_FFI_ICHECK(data_ != nullptr);
    static_cast<IRBuilderFrameObj*>(data_.get())->ExitWithScope();
    data_.reset();
  }
};
 
 
class IRBuilderObj : public ffi::Object {
 public:
  ffi::Array<IRBuilderFrame> frames;
  ffi::Optional<ffi::ObjectRef> result;
  std::vector<Location> locs;
 
  static void RegisterReflection() {
    namespace refl = tvm::ffi::reflection;
    refl::ObjectDef<IRBuilderObj>()
        .def_ro("frames", &IRBuilderObj::frames)
        .def_ro("result", &IRBuilderObj::result);
  }
 
  static constexpr const bool _type_mutable = true;
  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("script.ir_builder.IRBuilder", IRBuilderObj, ffi::Object);
 
 public:
  template <typename TFrame>
  inline ffi::Optional<TFrame> FindFrame() const;
  template <typename TFrame>
  inline ffi::Optional<TFrame> GetLastFrame() const;
  template <typename TObjectRef>
  inline TObjectRef Get() const;
  void PushLoc(Location loc);
  void PopLoc();
  Location GetCurrentLoc(Location location = UnknownLoc()) const;
  ffi::ObjectRef SetCurrentLoc(ffi::ObjectRef obj) const;
  ffi::ObjectRef SetLoc(ffi::ObjectRef obj, Location loc) const;
};
 
class IRBuilder : public ffi::ObjectRef {
 public:
  IRBuilder();
  TVM_FFI_DEFINE_OBJECT_REF_METHODS_NOTNULLABLE(IRBuilder, ffi::ObjectRef, IRBuilderObj);
 
 public:
  void EnterWithScope();
  void ExitWithScope();
  static IRBuilder Current();
  static bool IsInScope();
  template <class TObjectRef>
  inline static TObjectRef Name(ffi::String name, TObjectRef obj);
};
 
 
namespace details {
 
class LocationAccessor {
 public:
  using FType = ObjectFunctor<Location*(const ffi::ObjectRef&)>;
  static FType& vtable();
};
 
class Namer {
 public:
  using FType = ObjectFunctor<void(const ffi::ObjectRef&, ffi::String)>;
  static FType& vtable();
  static void Name(ffi::ObjectRef node, ffi::String name);
};
 
}  // namespace details
 
template <class TObjectRef>
inline TObjectRef IRBuilder::Name(ffi::String name, TObjectRef obj) {
  details::Namer::Name(obj, name);
  return obj.template as_or_throw<TObjectRef>();
}
 
template <typename TFrame>
inline ffi::Optional<TFrame> IRBuilderObj::FindFrame() const {
  using TFrameNode = typename TFrame::ContainerType;
  for (auto it = frames.rbegin(); it != frames.rend(); ++it) {
    if (const TFrameNode* p = (*it).template as<TFrameNode>()) {
      return ffi::GetRef<TFrame>(p);
    }
  }
  return std::nullopt;
}
 
template <typename TFrame>
inline ffi::Optional<TFrame> IRBuilderObj::GetLastFrame() const {
  using TFrameNode = typename TFrame::ContainerType;
  if (!frames.empty() && frames.back()->IsInstance<TFrameNode>()) {
    return frames.back().template as_or_throw<TFrame>();
  }
  return std::nullopt;
}
 
template <typename TObjectRef>
inline TObjectRef IRBuilderObj::Get() const {
  using TObject = typename TObjectRef::ContainerType;
  TVM_FFI_CHECK(result.has_value(), IndexError) << "No result exists in IRBuilder yet";
  const auto* n = result.as<TObject>();
  TVM_FFI_CHECK(n != nullptr, TypeError)
      << "IRBuilder result is not of type: " << TObject::_type_key;
  return ffi::GetRef<TObjectRef>(n);
}
 
}  // namespace ir_builder
}  // namespace script
}  // namespace tvm
 
#endif  // TVM_SCRIPT_IR_BUILDER_BASE_H_