feat: deprecated CLI command cyclonedx-bom prints deprecation warni…

…ng on STDERR before execution (#489)

Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>

cyclonedx_py/client.py

@@ -321,11 +321,22 @@ def _get_input_parser(self) -> BaseParser:
             raise CycloneDxCmdException('Parser type could not be determined.')
 
 
-def main(*, prog_name: Optional[str] = None) -> None:
+def main(*, prog_name: Optional[str] = None, prog_name_instead: Optional[str] = None) -> None:
     parser = CycloneDxCmd.get_arg_parser(prog=prog_name)
+    if prog_name_instead:
+        print('',
+              '!!! DEPRECATION WARNING !!!',
+              f'! The used call method "{parser.prog}" is deprecated.',
+              f'! Use "{prog_name_instead}" instead.',
+              '',
+              sep='\n', file=sys.stderr)
     args = parser.parse_args()
     CycloneDxCmd(args).execute()
 
 
+def main_deprecated(*, prog_name: Optional[str] = None) -> None:
+    main(prog_name=prog_name, prog_name_instead='cyclonedx-py')
+
+
 if __name__ == "__main__":
     main()

pyproject.toml

@@ -72,7 +72,7 @@ types-toml = "^0.10.8"
 types-setuptools = ">= 57.0.0"
 
 [tool.poetry.scripts]
-cyclonedx-bom = 'cyclonedx_py.client:main'  # deprecated as of https://github.com/CycloneDX/cyclonedx-python/issues/414
+cyclonedx-bom = 'cyclonedx_py.client:main_deprecated'  # deprecated as of https://github.com/CycloneDX/cyclonedx-python/issues/488
 cyclonedx-py  = 'cyclonedx_py.client:main'
 
 [build-system]