Upgrade libsrt to v1.5.3. v5.0.183 (#3808)

trunk/3rdparty/srt-1-fit/scripts/release-notes/README.md

@@ -0,0 +1,27 @@
+# Script Description
+
+Script designed to generate release notes template with main sections, contributors list, and detailed changelog out of `.csv` SRT git log file. The output `release-notes.md` file is generated in the root folder.
+
+In order to obtain the git log file since the previous release (e.g., v1.4.0), use the following command:
+
+```shell
+git log --pretty=format:"%h|%s|%an|%ae" v1.4.0...HEAD > commits.csv
+```
+
+Use the produced `commits.csv` file as an input to the script:
+
+```shell
+python scripts/release-notes/generate-release-notes.py commits.csv
+```
+
+The script produces `release-notes.md` as an output.
+
+
+## Requirements
+
+* Python 3.6+
+
+To install Python libraries use:
+```shell
+pip install -r requirements.txt
+```

trunk/3rdparty/srt-1-fit/scripts/release-notes/generate_release_notes.py

@@ -0,0 +1,120 @@
+import enum
+
+import click
+import numpy as np
+import pandas as pd
+
+
+@enum.unique
+class Area(enum.Enum):
+    core = 'core'
+    tests = 'tests'
+    build = 'build'
+    apps = 'apps'
+    docs = 'docs'
+
+
+def define_area(msg):
+    areas = [e.value for e in Area]
+
+    for area in areas:
+        if msg.startswith(f'[{area}] '):
+            return area
+
+    return np.NaN
+
+
+def delete_prefix(msg):
+    prefixes = [f'[{e.value}] ' for e in Area]
+
+    for prefix in prefixes:
+        if msg.startswith(prefix):
+            return msg[len(prefix):]
+
+    return msg[:]
+
+
+def write_into_changelog(df, f):
+    f.write('\n')
+    for _, row in df.iterrows():
+        f.write(f"\n{row['commit']} {row['message']}")
+    f.write('\n')
+
+
+@click.command()
+@click.argument(
+    'git_log',
+    type=click.Path(exists=True)
+)
+def main(git_log):
+    """
+    Script designed to generate release notes template with main sections,
+    contributors list, and detailed changelog out of .csv SRT git log file.
+    """
+    df = pd.read_csv(git_log, sep = '|', names = ['commit', 'message', 'author', 'email'])
+    df['area'] = df['message'].apply(define_area)
+    df['message'] = df['message'].apply(delete_prefix)
+
+    # Split commits by areas
+    core = df[df['area']==Area.core.value]
+    tests = df[df['area']==Area.tests.value]
+    build = df[df['area']==Area.build.value]
+    apps = df[df['area']==Area.apps.value]
+    docs = df[df['area']==Area.docs.value]
+    other = df[df['area'].isna()]
+
+    # Define individual contributors
+    contributors = df.groupby(['author', 'email'])
+    contributors = list(contributors.groups.keys())
+
+    with open('release-notes.md', 'w') as f:
+        f.write('# Release Notes\n')
+
+        f.write('\n## API / ABI / Integration Changes\n')
+        f.write('\n**API/ABI version: 1.x.**\n')
+
+        f.write('\n## New Features and Improvements\n')
+        f.write('\n## Important Bug Fixes\n')
+        f.write('\n## Build\n')
+        f.write('\n## Documentation\n')
+
+        f.write('\n## Contributors\n')
+        for name, email in contributors:
+            f.write(f'\n{name} <{email}>')
+        f.write('\n')
+
+        f.write('\n## Changelog\n')
+        f.write('\n<details><summary>Click to expand/collapse</summary>')
+        f.write('\n<p>')
+        f.write('\n')
+
+        if not core.empty:
+            f.write('\n### Core Functionality')
+            write_into_changelog(core, f)
+
+        if not tests.empty:
+            f.write('\n### Unit Tests')
+            write_into_changelog(tests, f)
+
+        if not build.empty:
+            f.write('\n### Build Scripts (CMake, etc.)')
+            write_into_changelog(build, f)
+
+        if not apps.empty:
+            f.write('\n### Sample Applications')
+            write_into_changelog(apps, f)
+
+        if not docs.empty:
+            f.write('\n### Documentation')
+            write_into_changelog(docs, f)
+
+        if not other.empty:
+            f.write('\n### Other')
+            write_into_changelog(other, f)
+
+        f.write('\n</p>')
+        f.write('\n</details>')
+
+
+if __name__ == '__main__':
+    main()

trunk/3rdparty/srt-1-fit/scripts/release-notes/requirements.txt

@@ -0,0 +1,3 @@
+click>=7.1.2
+numpy>=1.19.1
+pandas>=0.25.3