Author: cdutz
Date: Fri Apr 11 16:24:05 2025
New Revision: 76209
Log:
Staging of rc1 of PLC4X Build-Tools (Code-Generation) 1.8.0
Added:
dev/plc4x/build-tools/code-generation/1.8.0/
dev/plc4x/build-tools/code-generation/1.8.0/rc1/
dev/plc4x/build-tools/code-generation/1.8.0/rc1/README
dev/plc4x/build-tools/code-generation/1.8.0/rc1/RELEASE_NOTES
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip
(with props)
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.asc
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.sha512
Added: dev/plc4x/build-tools/code-generation/1.8.0/rc1/README
==============================================================================
--- dev/plc4x/build-tools/code-generation/1.8.0/rc1/README (added)
+++ dev/plc4x/build-tools/code-generation/1.8.0/rc1/README Fri Apr 11 16:24:05
2025
@@ -0,0 +1,54 @@
+Apache PLC4X Build-Tools
+========================
+
+Apache PLC4X Build-Tools is a sub-project of the Apache PLC4X project and
contains
+all the tools needed to build the main project.
+
+Currently the only tool it contains is a maven plugin used to generate drivers.
+
+It currently doesn't contain any actual code-generation modules, but just the
plugin
+and the API required to load and use code-generation modules.
+
+The actual code-generation modules are located inside the main project.
+
+Environment
+-----------
+
+Currently the project is configured to require the following software:
+
+1) Java 8 JDK (Or newer): For running Maven in general as well as compiling
the Java
+modules `JAVA_HOME` configured to point to that.
+
+
+Getting Started
+---------------
+
+Normally you wouldn't be required to build this module as the artifacts it
produces
+will be made available via one of the maven repositories. However if you want
to improve
+or fix the existing tools, you will have to build your version locally.
+
+You must have Java 8 installed on your system and connectivity to Maven Central
+(for downloading external third party dependencies). Maven will be
automatically
+downloaded and installed by the maven wrapper `mvnw`.
+
+NOTE: When running from sources-zip, the `mvnw` might not be executable, this
can easily
+be fixed by running the following command in the directory.
+
+$ chmod +x mvnw
+
+Build PLC4X Java jars and install them in your local maven repository
+
+$ ./mvnw install
+
+(Optionally you can use the normal Maven `mvn` command, if you have a
reasonably fresh version of Maven installed)
+
+This should make the build-tools available to the main projects build.
+In order to use your locally built version of the build-tools you should
+update the property: `plc4x-code-generation.version` in the PLC4X main pom.xml.
+
+
+
+Licensing
+---------
+
+Apache PLC4X is released under the Apache License Version 2.0.
Added: dev/plc4x/build-tools/code-generation/1.8.0/rc1/RELEASE_NOTES
==============================================================================
--- dev/plc4x/build-tools/code-generation/1.8.0/rc1/RELEASE_NOTES (added)
+++ dev/plc4x/build-tools/code-generation/1.8.0/rc1/RELEASE_NOTES Fri Apr 11
16:24:05 2025
@@ -0,0 +1,169 @@
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.8.0
+==============================================================
+
+New Features
+------------
+- Updated to the latest maven project maven-wrapper.
+- Added a 'skip' option to the plugin config.
+- Added support for providing external type information when
+ using external API types in the mspec (Such as PlcValueType
+ or PlcResponseCode)
+
+Incompatible changes
+--------------------
+
+- LanguageOutput now requires an additional Map<String,String>
+ argument for the type information.
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.7.0
+==============================================================
+
+New Features
+------------
+- Added a new "skip" option to the mojo.
+- Added a "nullBytesHex" option to optional fields.
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.6.0
+==============================================================
+
+New Features
+------------
+
+- Added the ability to provide protocol versions in the code
+ generation.
+- Fields now know the concept of attributes
+- New field types:
+ - Assert Field: Like Reserved or Const, but fires a special
+ type of exception which can be used by optional fields.
+ - Validation Field: Executes a validation and fires
+ special types of exceptions.
+ - Peek Field: Filed that doesn't consume bytes from the
+ read buffer.
+- Code generation now knows the concept of protocol versions.
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.5.0
+==============================================================
+
+New Features
+
+- `string` fields allow variable length input
+- Added a new `byte` simple type for 8 bit values where the
+ language can decide on if it's signed or unsigned.
+- Added a new `unknown` field type that can be used in
+ early stages of a driver, it allows simply discarding data
+ when parsing, but throws an exception when used for
+ serialization
+- Added support to the maven plugin for custom generator
+ options (Such as a custom package name)
+
+Changes
+
+- `enum` fields should only be used if a field of the enum
+ is required for parsing and serializing. For all other
+ cases a `simple` field works just right.
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.4.0
+==============================================================
+
+New Features
+
+- Added boolean-type
+- Moved the Default*TypeReference implementations from SPI in
+ the main repository to here
+
+------------
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.3.0
+==============================================================
+
+Refactorings needed to make the expressions used in mspec
+strongly typed.
+
+New Features
+------------
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.2.0
+==============================================================
+
+New Features
+------------
+- Added a new AbstractField type
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.1.0
+==============================================================
+
+New Features
+------------
+- Added new Integer and Float type references
+- Added support for "dataIo" types in MSpec
+- Added support for temporal fields
+- Added support for string fields
+
+Incompatible changes
+--------------------
+
+Bug Fixes
+---------
+
+==============================================================
+Apache PLC4X Build-Tools Code-Generation 1.0.0
+==============================================================
+
+This is the first official release of Apache PLC4X
+Build-Tools Code-Generation.
+
+New Features
+------------
+
+- New `plc4x-maven-plugin`
+
+Incompatible changes
+--------------------
+
+- none
+
+Bug Fixes
+---------
+
+- none
Added:
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip
==============================================================================
Binary file - no diff available.
Propchange:
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added:
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.asc
==============================================================================
---
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.asc
(added)
+++
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.asc
Fri Apr 11 16:24:05 2025
@@ -0,0 +1,16 @@
+-----BEGIN PGP SIGNATURE-----
+
+iQIzBAABCgAdFiEE8VaBP/MVAH42umwTCJEnwVxg1rkFAmf5QTUACgkQCJEnwVxg
+1rk1yxAAtJW9KOTttRPnUIoZKdAK2IuQ60CJCKtuiNLCoAU3pVmWaVl8hK3rJDo8
+cVT5dOfQVWj9HnNXhKzjwgQwDHTwkLXsvbb29WlzNm1dam0ikoTDDq+Qp9oVV5V5
+bKcgU+w0XHDLef6lLYXB/saNdFwp7Wy9Z8rJfOVVYldFVNOYGYnU2GpD7bzq0g+s
+Unc9hG8f/Po/nrtVF2j76HNAMVtJ2PneJJteBFouS7n6gi9WSCqnZubFNVFf58C4
+PQu+xzbtLxI0AhYEHF328fcoITkTSW/4pjEeM60yYdpqvh/ECgfvBBFSoxu/5d1U
+Md4+BZXnglXPfaJVJ2R8A5Z1RTNqCfqluaBWh+iTN7yRqpcWF4HOz4cJm8ddVthA
+BBR0mTg3ej6rDebSDXPnQdxLsUUw6llQjMfCwELbNna5l7ouOW910FA69OJkq3o1
+9mPFXtnzaKRDe3yA5SqR5zzdMuUXPrVWRf+U9XE82dkq/4DvUJGgeRetqJK1rP9h
+lWKFZMQHUe8O/g324Hx60EWfs4RXcz5SCcYB/YAjf9ONbaAL3OK9+vBfTl8upe9h
+ZJUC5TB67bvUdCJyOj/5S8amnfKIOmKDwURh+kD44od2Mp+B622yb+iuOW0Hz32W
+TFxR6dD2dFEVD5IDz8WuroBcaZMn0WNtVTPjlFonmKPiJBm/w/A=
+=kvSD
+-----END PGP SIGNATURE-----
Added:
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.sha512
==============================================================================
---
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.sha512
(added)
+++
dev/plc4x/build-tools/code-generation/1.8.0/rc1/apache-plc4x-code-generation-1.8.0-source-release.zip.sha512
Fri Apr 11 16:24:05 2025
@@ -0,0 +1 @@
+934bb0fa950d24b2a37ed10f3dbe269af95ca29dc04001f016a99cf5acf483a9f2f0f89ef56db00b0f402f32888d6a05a8ff6211a3a60a6731a2c02fa951608a
\ No newline at end of file
