EmbeddedProto 4.0.0b1__py3-none-any.whl

EmbeddedProto/templates/Field_SerializePartial.h.jinja2

@@ -0,0 +1,119 @@
+{#
+Copyright (C) 2020-2026 Embedded AMS B.V. - All Rights Reserved
+
+This file is part of Embedded Proto.
+
+Embedded Proto is dual licensed. You may use it under the terms of the
+GNU General Public License version 3 (GPLv3) as published by the Free
+Software Foundation, or under a commercial license from Embedded AMS B.V.
+
+Under the GPLv3 you must release the source code of
+any product you distribute that includes Embedded Proto or code
+generated by it. A commercial license removes that obligation.
+See <https://embeddedproto.com/pricing/>.
+
+Embedded Proto is distributed WITHOUT ANY WARRANTY; without even the
+implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+See the LICENSE file in the root of the repository for details.
+
+SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-EmbeddedProto-Commercial
+
+Embedded AMS B.V., Hoorn, the Netherlands - info at EmbeddedProto dot com
+#}
+{# Template for partial field serialization.
+   This simplified template delegates to library methods instead of inlining
+   the state machine logic. See doc/design/partial_serialization_design_v2.md
+#}
+
+{% if field.uses_serialize_len() %}
+{# ======================================================================= #}
+{# Field types that use LENGTH_DELIMITED: messages, strings, bytes, repeated #}
+{# ======================================================================= #}
+
+{% if field.callback_is_len_expanded() %}
+{# ------------------------------------------------------------------------- #}
+{# Map callback storage: pull each entry from the bound source and emit it     #}
+{# length delimited, resuming across a full buffer without pulling any entry   #}
+{# twice. Same framing a resident map uses, so a protoc peer can read it.      #}
+{# ------------------------------------------------------------------------- #}
+return_value = {{field.get_variable_name()}}.serialize_partial_as_field_expanded_len(
+    static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, false);
+
+{% elif field.callback_is_expanded() %}
+{# ------------------------------------------------------------------------- #}
+{# Repeated callback storage: pull each element from the bound source and emit #}
+{# it EXPANDED (one tag+value or one group per element), resuming across a     #}
+{# full buffer without pulling any element twice.                             #}
+{# ------------------------------------------------------------------------- #}
+return_value = {{field.get_variable_name()}}.serialize_partial_as_field_expanded(
+    static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, false);
+
+{% elif (field.optional or (field.oneof is not none)) %}
+{# ------------------------------------------------------------------------- #}
+{# Optional or oneof LENGTH_DELIMITED field #}
+{# ------------------------------------------------------------------------- #}
+if(has_{{field.get_name()}}())
+{
+{% if field.is_delimited() %}
+  return_value = {{field.get_variable_name()}}.serialize_partial_as_group(
+      static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state);
+{% else %}
+  return_value = {{field.get_variable_name()}}.serialize_partial_as_field(
+      static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, true);
+{% endif %}
+}
+else
+{
+  state.phase = ::EmbeddedProto::FieldProcessingPhase::COMPLETE;
+}
+
+{% elif field.is_delimited() %}
+{# ------------------------------------------------------------------------- #}
+{# Implicit / LEGACY_REQUIRED DELIMITED message field. #}
+{# ------------------------------------------------------------------------- #}
+return_value = {{field.get_variable_name()}}.serialize_partial_as_group(
+    static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state);
+{% elif (field.is_packed is defined) and (not field.is_packed()) and (not field.element_is_length_delimited()) %}
+{# ------------------------------------------------------------------------- #}
+{# EXPANDED repeated scalar/enum field (editions repeated_field_encoding).    #}
+{# Force one-tag-per-element output so partial matches full serialization.    #}
+{# ------------------------------------------------------------------------- #}
+return_value = {{field.get_variable_name()}}.serialize_partial_as_field_expanded(
+    static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, false);
+{% else %}
+{# ------------------------------------------------------------------------- #}
+{# Implicit / LEGACY_REQUIRED LENGTH_DELIMITED field. LEGACY_REQUIRED is always #}
+{# serialized (force=true), implicit only when != default (force=false).      #}
+{# ------------------------------------------------------------------------- #}
+return_value = {{field.get_variable_name()}}.serialize_partial_as_field(
+    static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, {{ "true" if field.always_serialize else "false" }});
+{% endif %}
+
+{% else %}
+{# ======================================================================= #}
+{# Basic scalar types and enums #}
+{# ======================================================================= #}
+
+{% if (field.optional or (field.oneof is not none)) %}
+{# ------------------------------------------------------------------------- #}
+{# Optional or oneof scalar field #}
+{# ------------------------------------------------------------------------- #}
+if(has_{{field.get_name()}}())
+{
+  return_value = {{field.get_variable_name()}}.serialize_partial_with_id(
+      static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, true);
+}
+else
+{
+  state.phase = ::EmbeddedProto::FieldProcessingPhase::COMPLETE;
+}
+
+{% else %}
+{# ------------------------------------------------------------------------- #}
+{# Implicit / LEGACY_REQUIRED scalar field. LEGACY_REQUIRED is always          #}
+{# serialized (force=true), implicit only when != default (force=false).       #}
+{# ------------------------------------------------------------------------- #}
+return_value = {{field.get_variable_name()}}.serialize_partial_with_id(
+    static_cast<uint32_t>(FieldNumber::{{field.get_variable_id_name()}}), buffer, state, {{ "true" if field.always_serialize else "false" }});
+{% endif %}
+{% endif %}

EmbeddedProto/templates/Header.h.jinja2

@@ -0,0 +1,108 @@
+{#
+  Copyright (C) 2020-2026 Embedded AMS B.V. - All Rights Reserved
+
+  This file is part of Embedded Proto.
+
+  Embedded Proto is dual licensed. You may use it under the terms of the
+  GNU General Public License version 3 (GPLv3) as published by the Free
+  Software Foundation, or under a commercial license from Embedded AMS B.V.
+
+  Under the GPLv3 you must release the source code of
+  any product you distribute that includes Embedded Proto or code
+  generated by it. A commercial license removes that obligation.
+  See <https://embeddedproto.com/pricing/>.
+
+  Embedded Proto is distributed WITHOUT ANY WARRANTY; without even the
+  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+  See the LICENSE file in the root of the repository for details.
+
+  SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-EmbeddedProto-Commercial
+
+  Embedded AMS B.V., Hoorn, the Netherlands - info at EmbeddedProto dot com
+#}
+{% if custom_header %}
+{{ custom_header }}
+{% else %}
+/*
+ *  This file contains code based on templates from Embedded Proto,
+ *  Copyright (C) Embedded AMS B.V.
+ *
+ *  Embedded Proto is dual licensed. Without a commercial license from
+ *  Embedded AMS B.V. the template code in this file is licensed under the
+ *  GNU General Public License version 3 (GPLv3), and
+ *  any product you distribute that includes it must release its source code
+ *  under the GPLv3. A commercial license removes that obligation.
+ *  See <https://embeddedproto.com/pricing/>.
+ *
+ *  SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-EmbeddedProto-Commercial
+ */
+{% endif %}
+/*
+ *  This file is generated with Embedded Proto, PLEASE DO NOT EDIT!
+ *  source: {{proto_file.descriptor.name}}
+ *  Generated on: {{ current_date_and_time }}
+ */
+
+// This file is generated. Please do not edit!
+#ifndef {{proto_file.get_header_guard()}}_H
+#define {{proto_file.get_header_guard()}}_H
+
+#include <cstdint>
+#include <EmbeddedProto/Version.h>
+
+//! The major version number of the Embedded Proto generator used to create this file.
+#define {{proto_file.filename_without_folder|upper}}_GENERATOR_VERSION_MAJOR {{version_major}}
+
+//! The minor version number of the Embedded Proto generator used to create this file.
+#define {{proto_file.filename_without_folder|upper}}_GENERATOR_VERSION_MINOR {{version_minor}}
+
+//! The patch version number of the Embedded Proto generator used to create this file.
+#define {{proto_file.filename_without_folder|upper}}_GENERATOR_VERSION_PATCH {{version_patch}}
+
+static_assert({{proto_file.filename_without_folder|upper}}_GENERATOR_VERSION_MAJOR == EMBEDDEDPROTO_VERSION_MAJOR,
+    "Major version mismatch between generated code and library");
+
+#if {{proto_file.filename_without_folder|upper}}_GENERATOR_VERSION_MINOR != EMBEDDEDPROTO_VERSION_MINOR
+#warning "Minor version mismatch between generated code and library"
+#endif
+
+{% if proto_file.msg_definitions %}
+#include <EmbeddedProto/MessageInterface.h>
+#include <EmbeddedProto/WireFormatter.h>
+#include <EmbeddedProto/Fields.h>
+#include <EmbeddedProto/MessageSizeCalculator.h>
+#include <EmbeddedProto/ReadBufferSection.h>
+#include <EmbeddedProto/RepeatedFieldFixedSize.h>
+#include <EmbeddedProto/RepeatedFieldCallback.h>
+#include <EmbeddedProto/MessageCallback.h>
+#include <EmbeddedProto/FieldStringBytes.h>
+#include <EmbeddedProto/BytesStringCallback.h>
+#include <EmbeddedProto/Errors.h>
+#include <EmbeddedProto/Defines.h>
+#include <limits>
+#include <type_traits>
+
+{% endif %}
+{% if proto_file.get_dependencies() is defined %}
+// Include external proto definitions
+{% for dependency in proto_file.get_dependencies() %}
+#include "{{dependency}}"
+{% endfor %}
+
+{% endif %}
+{% for namespace in proto_file.get_namespaces() %}
+namespace {{ namespace }} {
+{% endfor %}
+
+{% for enum in proto_file.enum_definitions %}
+{{ enum.render(environment) }}
+
+{% endfor %}
+{% for msg in proto_file.msg_definitions %}
+{{ msg.render(environment) }}
+
+{% endfor %}
+{% for namespace in proto_file.get_namespaces()|reverse %}
+} // End of namespace {{ namespace }}
+{% endfor %}
+#endif // {{proto_file.get_header_guard()}}_H

EmbeddedProto/templates/TypeDefEnum.h.jinja2

@@ -0,0 +1,45 @@
+{#
+Copyright (C) 2020-2026 Embedded AMS B.V. - All Rights Reserved
+
+This file is part of Embedded Proto.
+
+Embedded Proto is dual licensed. You may use it under the terms of the
+GNU General Public License version 3 (GPLv3) as published by the Free
+Software Foundation, or under a commercial license from Embedded AMS B.V.
+
+Under the GPLv3 you must release the source code of
+any product you distribute that includes Embedded Proto or code
+generated by it. A commercial license removes that obligation.
+See <https://embeddedproto.com/pricing/>.
+
+Embedded Proto is distributed WITHOUT ANY WARRANTY; without even the
+implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+See the LICENSE file in the root of the repository for details.
+
+SPDX-License-Identifier: GPL-3.0-only OR LicenseRef-EmbeddedProto-Commercial
+
+Embedded AMS B.V., Hoorn, the Netherlands - info at EmbeddedProto dot com
+#}
+enum class {{ typedef.name }} : uint32_t
+{
+  {% for value in typedef.values() %}
+  {{ value.name }} = {{ value.number }}{{ "," if not loop.last }}
+  {% endfor %}
+};
+{%- if typedef.is_closed() %}
+
+
+// CLOSED enum (editions enum_type feature): returns true only for declared values.
+static inline bool {{ typedef.name }}_is_valid(const uint32_t value)
+{
+  switch(value)
+  {
+    {% for number in typedef.unique_value_numbers() %}
+    case {{ number }}U:
+    {% endfor %}
+      return true;
+    default:
+      return false;
+  }
+}
+{%- endif %}