etl/scripts/update_release.py
John Wellbelove 4a88884b39
Issue/add hugo support for documentation (#1449)
* Add ranges

* Initial Hugo setup

* Work in progress

* Added selection for local or remote site

* Updated to 'light' theme

* Changed to using Hextra Hugo theme

* Changed to using Hextra Hugo theme

* Changed to Hextra Hugo theme

* Change to Hextra Hugo theme

* Updated Hugo setup.

* Updated Hugo setup.

# Conflicts:
#	docs/releases/_index.md

* Work in progress

* Added new fonts

Added new documentation

* Latest documentation updates

* Latest documentation updates

# Conflicts:
#	docs/containers/array.md
#	docs/containers/array_view.md
#	docs/containers/array_wrapper.md
#	docs/containers/bip_buffer_spsc_atomic.md
#	docs/containers/bitset.md
#	docs/containers/indirect_vector.md
#	docs/containers/vector.md
#	docs/getting-started/compilers.md

* Added bloom_filter markdown doc

* Added more documentation

Updated CSS for light and dark modes

* Fixed some menus

Added mode documentation files

* Updated CSS rules

Added badges to home page
Added uniqur_ptr + pool tutorial

* Fixed formatting on the home page markdown

Modified light amd dark code formatting

* Updated unique_ptr-with-pool

* Added container and shared message tutorials

* Updates to documentation

* Added const_multimap

* Updated source-formatting.md

* Added initial raw text files form Web site editor

* Innore coverage build directory

* Exported raw text documentation files from the web site editor

* Hugo updates

* Added Hugo intalation and markdown descriptions

* More addition to the documentation

* Added closure.md and updates to delegate.md

* Added format.md

* Added documentation for etl::delegate_observable, etl::function, Base64 codec

* Added io_port documentation

* Added basic_format_spec

* Added documentation for string_stream and string utilities.

* Added more documentation

Updated the documentation CSS

* Added documentation for clocks, day, duration

* Added more documentation for chrono classes

Updated callouts

* More chrono documentation

* Completed chrono documentation

* Maths functions documentation

* Completed maths documentation

* Completed maths documentation

* Completed maths documentation

* Completed maths documentation

* Added multiple documentation files

* Added iterator.md

* Added debug_count.md and versions.md

* Added debug_count.md and versions.md

* Added more documentation

* More documentation

* Added some design pattern documentation

Modified some of the layout files
Modified the About documentation

* Converted more documentation pages

Modified the site CSS

* Added more documentation

Moced some documentation files to new directories

* Added more documentation

Tweaks to CSS

* Added callback_timer_deferred_locked documentation

* Added callback_timer_locked documentation

* More documentation updates

* More documentation updates

* More documentation updates

* New documentation files.

Harmonised file name format

* New documentation files.

* Multiple document updates

* Multiple document updates

* Final conversion of web pages

* Updates before PR

* Updates before PR

* Updates before PR

# Conflicts:
#	docs/blog/_index.md

* Final pre PR updates

* Updates to message framework documentation

* Renamed directory

* Fix spelling

* Added author and date to blog files

Moved documentation files merged from development

* Fixed 'Description' typo

* Fix typos

# Conflicts:
#	docs/IO/io_port.md
#	docs/containers/sets/const-multiset.md
#	docs/containers/sets/const-set.md
#	docs/maths/correlation.md
#	docs/maths/gamma.md

* Renamed two files to lower case

* Minor renaming

* Added author and date

* Updated callout on bresenham_line.md

Added support for showing the ETL version on the documentation first page, by copying the version.txt file as a hugo asset.
Updated the Python 'update_release.py' to copy 'version.txt'

* Replace space in filename with hyphen.

Added more information to hugo-commands.md

* Replace space in filename with hyphen.

Added more information to hugo-commands.md

# Conflicts:
#	docs/getting-started/view-the-docs-locally/hugo-commands.md

* Added a link to pseudo_moving_average.md

* Updated title pages for groups

* Fixed missing 404 for non-existent pages

* Fixed coordinate variable names in the 'Calculating the intersection' example

---------

Co-authored-by: Roland Reichwein <Roland.Reichwein@bmw.de>
Co-authored-by: John Wellbelove <john.wellbelove@etlcpp.com>
Co-authored-by: John Wellbelove <john.wellbelove@etlcpp.co.uk>
2026-06-06 13:12:44 +01:00

257 lines
7.4 KiB
Python

import shutil
import os
# Get the current path of the script
script_dir = os.path.dirname(os.path.abspath(__file__))
# Get the root folder of the ETL
etl_dir = os.path.abspath(os.path.join(script_dir, os.pardir))
# Get the ETL repository folder
include_dir = os.path.join(etl_dir, 'include')
# Get the ETL headers folder
headers_dir = os.path.join(include_dir, 'etl')
# Get the Hugo folder
hugo_dir = os.path.join(etl_dir, 'hugo')
# Get the Arduino folder
arduino_dir = os.path.join(etl_dir, 'arduino')
# Get the ETL arduino_examples folder
arduino_examples_dir = os.path.join(arduino_dir, 'examples')
# Get the root folder of both repositories
common_dir = os.path.abspath(os.path.join(etl_dir, os.pardir))
# Get the ETL Arduino repository folder
etl_arduino_dir = os.path.join(common_dir, 'etl-arduino')
# Get the ETL Arduino src repository folder
etl_arduino_src_dir = os.path.join(etl_arduino_dir, 'src')
# Get the ETL Arduino examples repository folder
etl_arduino_examples_dir = os.path.join(etl_arduino_dir, 'examples')
major_version = ''
minor_version = ''
patch_version = ''
#------------------------------------------------------------------------------
# Assumes this folder structure.
# Folder Variable
# ---------------------------------------
# etl etl_dir
# arduino arduino_dir
# include include_dir
# etl-arduino etl_arduino_dir
# src etl_arduino_src_dir
def create_arduino_variant():
print('')
print('Copy ETL files to the etl-arduino repository')
print('')
print('script_dir = ', script_dir)
print('etl_dir = ', etl_dir)
print('include_dir = ', include_dir)
print('headers_dir = ', headers_dir)
print('hugo_dir = ', hugo_dir)
print('arduino_dir = ', arduino_dir)
print('examples_dir = ', arduino_examples_dir)
print('common_dir = ', common_dir)
print('etl_arduino_dir = ', etl_arduino_dir)
print('etl_arduino_src_dir = ', etl_arduino_src_dir)
print('etl_arduino_examples_dir = ', etl_arduino_examples_dir)
print('')
# Copy the library properties
src_filename = 'library-arduino.properties'
dst_filename = 'library.properties'
source = os.path.join(arduino_dir, src_filename)
destination = os.path.join(etl_arduino_dir, dst_filename)
print('Copy the library properties')
print(' From :', source)
print(' To :', destination)
shutil.copyfile(source, destination)
print('')
# Copy the library json
src_filename = 'library-arduino.json'
dst_filename = 'library.json'
source = os.path.join(arduino_dir, src_filename)
destination = os.path.join(etl_arduino_dir, dst_filename)
print('Copy the library json')
print(' From :', source)
print(' To :', destination)
shutil.copyfile(source, destination)
print('')
# Copy the Arduino ETL header
filename = 'Embedded_Template_Library.h'
source = os.path.join(arduino_dir, filename)
destination = os.path.join(etl_arduino_src_dir, filename)
print('Copy the Arduino ETL header')
print(' From :', source)
print(' To :', destination)
shutil.copyfile(source, destination)
print('')
# Copy the ETL headers
source = include_dir
destination = etl_arduino_src_dir
print('Copy the ETL headers')
print(' From :', source)
print(' To :', destination)
shutil.copytree(source, destination, dirs_exist_ok = True)
print('')
# Copy the ETL arduino_examples
source = arduino_examples_dir
destination = etl_arduino_examples_dir
print('Copy the ETL Arduino examples')
print(' From :', source)
print(' To :', destination)
shutil.copytree(source, destination, dirs_exist_ok = True)
#------------------------------------------------------------------------------
def get_version():
version_file = os.path.join(etl_dir, 'version.txt')
print('')
print('version_file = ', version_file)
with open(version_file) as f:
version = f.read().splitlines()
elements = version[0].split('.', 3)
return version[0], elements[0], elements[1], elements[2]
#------------------------------------------------------------------------------
def update_version_h():
print('')
print('Creating version.h')
version_h = os.path.join(headers_dir, 'version.h')
with open(version_h) as f:
text = f.read().splitlines()
search_major = '#define ETL_VERSION_MAJOR '
search_minor = '#define ETL_VERSION_MINOR '
search_patch = '#define ETL_VERSION_PATCH '
length_major = len(search_major)
length_minor = len(search_minor)
length_patch = len(search_patch)
for i in range(len(text) - 1):
index = text[i].find(search_major)
if index != -1:
text[i] = text[i][index:length_major] + major_version
print(text[i])
index = text[i].find(search_minor)
if index != -1:
text[i] = text[i][index:length_minor] + minor_version
print(text[i])
index = text[i].find(search_patch)
if index != -1:
text[i] = text[i][index:length_patch] + patch_version
print(text[i])
with open(version_h, 'w') as f:
for line in text:
f.write(line)
f.write('\n')
#------------------------------------------------------------------------------
def update_hugo_version_txt():
print('')
print('Copying version.txt to hugo/assets')
src = os.path.join(etl_dir, 'version.txt')
dst = os.path.join(hugo_dir, 'assets', 'version.txt')
try:
shutil.copyfile(src, dst)
print("Copy successful!")
except PermissionError:
print(f"Permission denied. Check if the file is open or locked.")
#------------------------------------------------------------------------------
def update_library_json(filename):
print('')
print('Creating %s' % filename)
with open(filename) as f:
text = f.read().splitlines()
search = 'version'
for i in range(len(text) - 1):
index = text[i].find(search)
if index != -1:
text[i] = ' \"version\": \"' + full_version + '\",'
with open(filename, 'w') as f:
for line in text:
f.write(line)
f.write('\n')
#------------------------------------------------------------------------------
def update_library_properties(filename):
print('')
print('Creating %s' % filename)
with open(filename, 'r') as f:
text = f.read().splitlines()
search = 'version'
for i in range(len(text) - 1):
index = text[i].find(search)
if index != -1:
text[i] = 'version=' + full_version
with open(filename, 'w') as f:
for line in text:
f.write(line)
f.write('\n')
#------------------------------------------------------------------------------
def update_versions():
print('')
print('Update Versions')
global full_version
global major_version
global minor_version
global patch_version
full_version, major_version, minor_version, patch_version = get_version()
print("Version = %s.%s.%s" % (major_version, minor_version, patch_version ))
update_version_h()
update_hugo_version_txt()
update_library_json(os.path.join(etl_dir, 'library.json'))
update_library_json(os.path.join(arduino_dir, 'library-arduino.json'))
update_library_properties(os.path.join(etl_dir, 'library.properties'))
update_library_properties(os.path.join(arduino_dir, 'library-arduino.properties'))
#------------------------------------------------------------------------------
if __name__ == "__main__":
update_versions()
create_arduino_variant()