#include "torch/csrc/jit/script/init.h" #include "torch/csrc/jit/script/compiler.h" namespace torch { namespace jit { namespace script { using ResolutionCallback = std::function; // The visibility attribute is to avoid a warning about storing a field in the // struct that has a different visibility (from pybind) than the struct. #ifdef _WIN32 #define VISIBILITY_HIDDEN #else #define VISIBILITY_HIDDEN __attribute__((visibility("hidden"))) #endif static void ensureSizeMatches(SourceRange loc, size_t expected, size_t actual, const std::string& what) { if(expected != actual) { throw ErrorReport(loc) << "expected " << expected << " " << what << " but found " << actual; } } struct VISIBILITY_HIDDEN PythonValue : public SugaredValue { PythonValue(py::object self) : self(std::move(self)) {} // call it like a function, e.g. `outputs = this(inputs)` virtual std::vector call(SourceRange loc, Method & m, at::ArrayRef inputs, List attributes, size_t n_outputs) override { if (attributes.size() > 0) throw ErrorReport(loc) << "keyword arguments in Python calls aren't supported"; // Release the function object so we can wrap it in a PythonOp Graph& g = *m.graph(); py::object func = self; std::string cconv(inputs.size(), 't'); Node* new_node = g.insertNode(g.createPythonOp( THPObjectPtr(func.release().ptr()), cconv, false, {}, {}, false)); for(auto i : inputs) new_node->addInput(i); std::vector outputs; for(size_t i = 0; i < n_outputs; ++i) outputs.push_back(new_node->addOutput()); return outputs; } virtual std::shared_ptr attr(SourceRange loc, Method & m, const std::string& field) { // We generally don't want to allow traversing arbitrary Python objects, but we // make an exception for traversing modules because we want to be access // torch, torch.nn.functional, and the functions they expose. py::object member = getattr(loc, field); if (isBuiltinModule() && py::isinstance(member)) { return std::make_shared(field); } if (py::isinstance(self) && py::isinstance(member)) { return std::make_shared(member); } throw ErrorReport(loc) << "unsupported attribute lookup on " << py::repr(self) << "."; } virtual std::string kind() const override { std::stringstream ss; ss << "python value'" << py::repr(self) << "'"; return ss.str(); } private: bool isBuiltinModule() { // XXX: these can't be static, or they will be destructed after the Python interpreter // exits and that generally sounds like a bad idea py::object torch = py::module::import("torch"); py::object functional = py::module::import("torch.nn.functional"); return self.is(torch) || self.is(functional); } py::object getattr(SourceRange loc, const std::string& name) { try { return py::getattr(self, name.c_str()); } catch (py::error_already_set& e) { throw ErrorReport(loc) << "object has no attribute " << name; } } py::object self; }; Resolver pythonResolver(ResolutionCallback rcb) { return [=](const std::string& name) -> std::shared_ptr { AutoGIL ag; py::object obj = rcb(name); if(obj.is(py::none())) { return nullptr; } return std::make_shared(obj); }; } // defines how modules/methods behave inside the script subset. // for now this does not have any interaction with python. // in the future, we will add the ability to resolve `self.foo` to python // {functions, modules, contants} so this SugaredValue is defined here // anticipating we will eventually need to replace Module with a py::object // holding the actual nn.Module class. // defines how a method obtained from a module behaves in script struct MethodValue : public SugaredValue { MethodValue(std::shared_ptr module, Method& method) : module(std::move(module)) //insurance that method stays alive , method(method) {} std::string kind() const override { return "method"; } virtual std::vector call(SourceRange loc, Method & caller, at::ArrayRef inputs, List attributes, size_t n_outputs) override { if(attributes.size() != 0) { throw ErrorReport(loc) << "not yet implemented - calls to python functions using keyword arguments"; } ensureSizeMatches(loc, method.num_inputs(), inputs.size(), "inputs"); auto outputs = caller.emit_call_to(method, inputs); ensureSizeMatches(loc, outputs.size(), n_outputs, "outputs"); return outputs; } private: std::shared_ptr module; Method& method; }; struct ModuleValue : public SugaredValue { ModuleValue(std::shared_ptr module) : module(std::move(module)) {} virtual std::string kind() const override { return "module"; } // select an attribute on it, e.g. `this.field` virtual std::shared_ptr attr(SourceRange loc, Method & m, const std::string& field) override { if(at::optional v = module->find_module(field)) { return std::make_shared(v->module); } else if(at::optional v = module->find_method(field)) { return std::make_shared(module, *v); } else if(at::optional v = module->find_parameter(field)) { return std::make_shared(m.get_or_add_parameter(v->slot())); } // This can also be a call to a non-script module, or a plain // python method. If so return this as a python value. py::object py_module = py::cast(module); if(py::object attr = py::getattr(py_module, field.c_str(), py::none())) { if(py::isinstance(attr) || py::isinstance(attr, py::module::import("torch.nn").attr("Module"))) { return std::make_shared(attr); } } throw ErrorReport(loc) << "module has no attribute '" << field << "'"; } // call module.forward virtual std::vector call(SourceRange loc, Method & caller, at::ArrayRef inputs, List attributes, size_t n_outputs) override { return attr(loc, caller, "forward")->call(loc, caller, inputs, attributes, n_outputs); } private: std::shared_ptr module; }; // TODO: dedup with other init // we cannot use the default py:cast because it currently // unwraps the data tensor in the conversion process variable_tensor_list createVariableTensorList(py::tuple tuple, size_t reserve_extra_space = 0) { variable_tensor_list result; result.reserve(tuple.size() + reserve_extra_space); for(auto e : tuple) { result.push_back(py::cast(e)); } return result; } py::object unpackVariableTensorList(std::vector outputs) { // if we don't tell pybind these are variables it chokes on the // conversion. // TODO: fix conversions to be sane and make sure this works. if (outputs.size() == 0) { return py::none(); } else if (outputs.size() == 1) { return py::cast(static_cast(outputs[0])); } else { py::tuple tuple(outputs.size()); for(size_t i = 0; i < outputs.size(); i++) { tuple[i] = py::cast(static_cast(outputs[i])); } return tuple; } } static void gatherParametersAndBuffers(std::vector & values, const Module & m) { for(auto & params : m.get_parameters()) { values.push_back(params.slot()); } for(const auto & sub : m.get_modules()) { gatherParametersAndBuffers(values, *sub.module); } } void initJitScriptBindings(PyObject* module) { auto m = py::handle(module).cast(); // torch.jit.ScriptModule is a subclass of this C++ object. // Methods here are prefixed with _ since they should not be // public. py::class_>(m, "ScriptModule") .def(py::init<>()) .def("_set_optimized", &Module::set_optimized) .def( "_define", [](Module& m, const std::string& script, ResolutionCallback rcb, bool has_self) { auto self = has_self ? std::make_shared(m.shared_from_this()) : nullptr; return defineMethodsInModule(m, script, pythonResolver(rcb), self); }) .def("_create_method", [](Module& m, Def def, ResolutionCallback rcb) { defineMethodsInModule( m, { def }, pythonResolver(rcb), std::make_shared(m.shared_from_this())); }) .def("_get_method", [](Module& self, const std::string& name) -> const Method& { return self.get_method(name); }, py::return_value_policy::reference_internal) .def("_register_parameter", &Module::register_parameter) .def("_register_module", &Module::register_module) .def("_set_parameter", &Module::set_parameter) .def("_get_parameter", &Module::get_parameter) .def("_get_module", &Module::get_module) .def("_get_modules", [](Module& self) -> py::tuple { auto & modules = self.get_modules(); py::tuple result(modules.size()); for(size_t i = 0; i < modules.size(); ++i) { auto & nm = modules[i]; result[i] = std::make_pair(nm.name, nm.module); } return result; }) .def("_get_parameters", [](Module& self) -> py::tuple { auto & parameters = self.get_parameters(); py::tuple result(parameters.size()); for(size_t i = 0; i < parameters.size(); ++i) { auto & p = parameters[i]; py::tuple r(3); result[i] = std::make_tuple( p.name, static_cast(*p.slot()), p.is_buffer); } return result; }) .def("_has_parameter", [](Module& self, const std::string& name) { if(auto r = self.find_parameter(name)) { return !r->is_buffer; } return false; }) .def("_has_buffer", [](Module& self, const std::string& name) { if(auto r = self.find_parameter(name)) { return r->is_buffer; } return false; }) .def("_has_module", [](Module& self, const std::string& name) { return bool(self.find_module(name)); }) .def("_has_method", [](Module& self, const std::string& name) { return bool(self.find_method(name)); }) .def("_method_names", [](Module& self) { return fmap(self.get_methods(), [](const std::unique_ptr & m) { return m->name(); }); }) .def("_create_method_from_trace", []( Module& self, const std::string& name, py::function func, tracer::variable_list inputs) { size_t num_inputs = inputs.size(); // prereq: Module's buffers and parameters are unique // this was ensured in python before calling this function std::vector parameters; gatherParametersAndBuffers(parameters, self); for(at::Tensor* param : parameters) { inputs.push_back(static_cast(*param)); } auto graph = tracer::createGraphByTracing(func, std::move(inputs), num_inputs); self.create_method(name, std::move(graph), std::move(parameters)); }); py::class_(m, "ScriptMethod") .def("graph", [&](Method& self) { return self.graph(); }) .def("__call__", [](Method& m, py::args args) -> py::object { auto inputs = createVariableTensorList(args); auto outputs = m.run(std::move(inputs)); return unpackVariableTensorList(std::move(outputs)); }); m.def("_jit_script_compile", [](Def def, ResolutionCallback rcb) { return compileFunction(def, pythonResolver(rcb)); }); } } // namespace script } // namespace jit } // namespace torch