sc-file 0.0.0__py3-none-any.whl

sc_file-0.0.0.dist-info/METADATA

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: sc-file
+Version: 0.0.0
+Summary: Utility & Library for decoding stalcraft assets
+Author-email: onejeuu <mail@66rk.ru>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/onejeuu/sc-file
+Project-URL: Repository, https://github.com/onejeuu/sc-file
+Project-URL: Documentation, https://sc-file.readthedocs.io
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9.0.0,>=8.2.0
+Requires-Dist: lz4<5.0.0,>=4.4.0
+Requires-Dist: numpy<3.0.0,>=2.3.0
+Requires-Dist: rich<15.0.0,>=14.1.0
+Dynamic: license-file
+
+# sc-file
+
+<!-- Links -->
+
+[pypi]: https://pypi.org/project/sc-file
+[license]: https://opensource.org/licenses/MIT
+[tests]: https://github.com/onejeuu/sc-file/actions/workflows/tests.yml
+[build]: https://github.com/onejeuu/sc-file/actions/workflows/release.yml
+[issues]: https://github.com/onejeuu/sc-file/issues
+[releases]: https://github.com/onejeuu/sc-file/releases
+[docs]: https://sc-file.readthedocs.io/en/latest
+[readme-ru]: README-RU.md
+
+<!-- Usage -->
+
+[usage-dragndrop]: https://en.wikipedia.org/wiki/Drag_and_drop
+[usage-defaultapp]: https://support.microsoft.com/en-us/windows/e5d82cad-17d1-c53b-3505-f10a32e1894d
+[usage-cli]: https://en.wikipedia.org/wiki/Command-line_interface
+[usage-library]: https://pypi.org/project/sc-file
+
+<!-- Docs -->
+
+[docs-usage]: https://sc-file.readthedocs.io/en/latest/usage.html
+[docs-faq]: https://sc-file.readthedocs.io/en/latest/faq.html
+[docs-formats]: https://sc-file.readthedocs.io/en/latest/formats.html
+[docs-support]: https://sc-file.readthedocs.io/en/latest/support.html
+[docs-compile]: https://sc-file.readthedocs.io/en/latest/compile.html
+[docs-library]: https://sc-file.readthedocs.io/en/latest/api/index.html
+
+<!-- Badges -->
+
+[badge-pypi]: https://img.shields.io/pypi/v/sc-file.svg
+[badge-license]: https://img.shields.io/github/license/onejeuu/sc-file
+[badge-docs]: https://img.shields.io/readthedocs/sc-file
+[badge-tests]: https://img.shields.io/github/actions/workflow/status/onejeuu/sc-file/tests.yml?label=tests
+[badge-build]: https://img.shields.io/github/actions/workflow/status/onejeuu/sc-file/release.yml?label=build
+[badge-issues]: https://img.shields.io/github/issues/onejeuu/sc-file
+[badge-ru]: https://img.shields.io/badge/перевод%20на-🇷🇺%20Русский-0096FF
+
+<img src="assets/scfile.svg" alt="icon" width="96" />
+
+[![Pypi][badge-pypi]][pypi] [![License][badge-license]][license] [![Docs][badge-docs]][docs] [![Tests][badge-tests]][tests] [![Build][badge-build]][build] [![Issues][badge-issues]][issues]
+
+[![RU][badge-ru]][readme-ru]
+
+## Overview
+
+**scfile** is a utility and library for converting stalcraft assets (such as models and textures), into standard formats.
+
+_this project is unofficial and not related to stalcraft devs. all trademarks and assets belong to their respective owners._
+
+📚 Documentation: [sc-file.readthedocs.io][docs] \
+[Usage][docs-usage] / [FAQ][docs-faq] / [Game Formats][docs-formats] / [Formats Support][docs-support] / [Compile Guide][docs-compile] / [Library API Reference][docs-library]
+
+🗂️ Supported game formats: `.mcsb`, `.mcsa`, `.mcvd`, `.ol`, `.mic`, `.texarr`. \
+[More about Game Formats...][docs-formats]
+
+💻 Executable utility `scfile.exe` can be downloaded from [Releases page][releases] or [compiled from source][docs-compile] \
+[More about Usage...][docs-usage]
+
+❓ **Why reverse encoding into game formats is unsupported?** \
+And other common questions are answered on [FAQ page][docs-faq].
+
+## 🛠️ Supported Formats
+
+| Type       | Source                    | Output                          |
+| ---------- | ------------------------- | ------------------------------- |
+| 🧊 Model   | `.mcsb`, `.mcsa`, `.mcvd` | `.glb`, `.obj`, `.dae`, `.ms3d` |
+| 🧱 Texture | `.ol`                     | `.dds`                          |
+| 🖼️ Image   | `.mic`                    | `.png`                          |
+| 📦 Archive | `.texarr`                 | `.zip`                          |
+
+[More about Formats Support…][docs-support]
+
+## 🚀 Usage
+
+- **Easiest way is [Drag & Drop][usage-dragndrop]**. Just drag and drop your files onto `scfile.exe`.
+- **Set scfile.exe as the [default application][usage-defaultapp]** for the required file types.
+- **Via terminal as [CLI][usage-cli]** for specifying parameters.
+- **As [Python library][usage-library]** for complex tasks.
+
+Command example:
+
+```bash
+scfile.exe model.mcsb -F dae --skeleton
+```
+
+[More about Usage...][docs-usage]
+
+## 📖 Library
+
+To install library for coding, use following command:
+
+```bash
+pip install sc-file -U
+```
+
+Simple usage example:
+
+```python
+from scfile import UserOptions, convert
+
+# Optional convert settings
+options = UserOptions(parse_skeleton=True)
+
+# Specific format to format
+convert.mcsb_to_obj(source="path/to/model.mcsb", options=options)
+
+# Or auto detect by file suffix
+convert.auto(source="path/to/model.mcsb", options=options)
+```
+
+[More details about Library...][docs-library]
+
+## 🤝 Acknowledgments
+
+- `kommunist2021` – file structure research.
+- `Art3mLapa` – advice, bug reports, contribution.
+- `n1kodim` – advice, contribution.
+- `IExploitableMan` – contribution.
+- `Sarioga` – feedback, bug reports.
+- `Hazart` – bug reports.

sc_file-0.0.0.dist-info/RECORD

@@ -0,0 +1,84 @@
+sc_file-0.0.0.dist-info/licenses/LICENSE,sha256=F-SU1JkdAgWCldOJezvXupiEtyofFUZhFevinEqdQTo,1063
+scfile/__init__.py,sha256=MCDk6nVxa211blNWq15tR3WEJNV1Cf7Y7bYWnwAdQWc,344
+scfile/__main__.py,sha256=EGR9PD2JwK30qyTohMFXwgpgRwvwmsKyVekVTizO2SQ,434
+scfile/consts.py,sha256=1ktWs52kOlmZhGQ5ZJ_BrftruwjOwoeaTzIW0x5mzPE,2342
+scfile/enums.py,sha256=pjonOtCA-qqRz6kFrH8UXPVEoSjmFKCxlS827bVh6GY,2585
+scfile/exceptions.py,sha256=TShI27nBTo2YVNeNZHNEdwmr0HvZihtWpfdcXFiykiY,2399
+scfile/types.py,sha256=3fVn8J04gQSBtoVaPvMRImUzslFmdlFXAu3yB5Eyhak,168
+scfile/cli/__init__.py,sha256=4KrjuD5K4z4b9stkOdQXR8g4TdD0fDPRjDZCE_yxLBI,207
+scfile/cli/commands.py,sha256=tXT_GRtyb_AAxHipvGQjy1cUbkwCtaa5crfpGEoalt0,3283
+scfile/cli/types.py,sha256=Y_hVj19pqoBUtTBWsDSJqRkz__OA0GPqZVNATn6mGrY,592
+scfile/cli/utils.py,sha256=5-3p_V5YPr3SI47XFYVwGVT4XH7mq7H81L-jMoAKzuc,1997
+scfile/convert/__init__.py,sha256=ug0Ina7K6w8efkgrrbBfUbdtlbXmpTksgXzagmUVQZw,544
+scfile/convert/base.py,sha256=SQG5TSNEB7CJ-7zoT9lkP7uvInyAxmkZ2jxX0XBR3oE,1889
+scfile/convert/detect.py,sha256=Ux5w4Z_UKqiWqt3k4NFT3AKnXxYvm4Nejvvtp3ak5FI,2599
+scfile/convert/factory.py,sha256=jUuqqiova-j8kg7-THJpwENhPXoUMSd4xGGmTtIqQQI,948
+scfile/convert/formats.py,sha256=C6jd0Cxj4ndGbJ2IbA85raMo8zZHIOS50OKSTmmRavI,4674
+scfile/convert/legacy.py,sha256=7iSp1_UrWYdSx5RK7B0JjoGOftZgd9z3BiOE-Ge0L7M,2514
+scfile/core/__init__.py,sha256=nieAAh9IsHE-zh28CSIxvT7EmcotpUEb9rtzqm8prpk,653
+scfile/core/base.py,sha256=vjN4aGENOc-AeBDzYYSVVQ9DrmuJ-g5j75KWxjsIl00,423
+scfile/core/decoder.py,sha256=yOGRrJTPZBwC0FGdaVaTjl9oYKGx4Ce4xP5WHAS4g5Q,3414
+scfile/core/encoder.py,sha256=N_cd5lnL1Y0SyPmE0v2XhdtHB7aTM4IpOwADT-q4lIk,3708
+scfile/core/types.py,sha256=-F-KNz9dCX3Bzd1vvwJ5xUchz9Oe0Cooy2VuFnjVtCA,231
+scfile/core/context/__init__.py,sha256=t8xPwyOGbtj0IGKwAvS3MK1ZV7-Ke2_5V7FzCXH4LW8,327
+scfile/core/context/content.py,sha256=P28JflRZmkDWQYSDClZNwnqCY4nXKF_mWw5JoRYml8g,2415
+scfile/core/context/options.py,sha256=j-JqoUUG24z-8BshjZfcDpdyN5rw-4xiLw94S4e1DKM,582
+scfile/core/io/__init__.py,sha256=5D0kPshJC7MQ_ocNrltGX5-cJNfWhyDbnSoqYZY-S8k,259
+scfile/core/io/base.py,sha256=bwRW_V-RAGG4Jsr8YaPZsBK30q31EZFkmW8EVHdePXc,1817
+scfile/core/io/streams.py,sha256=bvZFMLD1M6pNKAEtaUksY0vj4W_8okJ3UwxOLgLgLtE,859
+scfile/formats/__init__.py,sha256=pF9uRnWnYKMAqHHoOE0TSDT7LILqtMqeRRHM_b8qff0,336
+scfile/formats/dae/__init__.py,sha256=Zj8367IuQC4Y_PkD70ChtOHXqgY6I9KiUK0Eqgmb7jo,60
+scfile/formats/dae/encoder.py,sha256=MWdpnF3mltuo1BE3q3NQm6myykfDBi7Wrb6KClIiU7A,9114
+scfile/formats/dae/utils.py,sha256=OwtvZqMtWBFQ8owpHJ25INFpAfievvViopf1pffOWEE,1025
+scfile/formats/dds/__init__.py,sha256=H8TNV4n5vwu_0wjrW6lrCjMZsmxrFPoEXKQWxRDkR48,60
+scfile/formats/dds/encoder.py,sha256=Lu-JR9YtniJfnRNV_ic5NWVpwknmFRTavEcOhTqPlPw,3029
+scfile/formats/dds/enums.py,sha256=bVKCxnGo40AWwyTtwZZadglAb0SSKXP4gAlBZQFoLtI,714
+scfile/formats/dds/header.py,sha256=MBURWS7ZB9bvV8BSdFFa-9qW9aByjp4k8XywczVUyWY,597
+scfile/formats/dds/mask.py,sha256=zANIwEaknx1yPwJvexSbfwEzu2tyUK460Agbm7nAQvk,191
+scfile/formats/glb/__init__.py,sha256=rpBTrL6D7WisNLmMJwbfSu8qjNKdbq5hRaUUIzJates,59
+scfile/formats/glb/base.py,sha256=db15BqAOTDkoUqkLJSi-pQLCMucyJgXQcj7EpOLLNkQ,502
+scfile/formats/glb/encoder.py,sha256=1dN8269-1bDu_88F_otywu36DYTovtjMtbjx8vYpMuA,11641
+scfile/formats/glb/enums.py,sha256=OQDemwFndPXDg5qPgeAxiX92t8__a0xhqs6KebDGw4o,266
+scfile/formats/hdri/__init__.py,sha256=zz3wmS8vC_3oe5tTXAbhy-HN1LpdAOM_U_LVXQV3Vw0,71
+scfile/formats/hdri/decoder.py,sha256=GGJorFcDW4bD1v8AAICU9MN7_02M5M8HzfkpPmLI2ME,980
+scfile/formats/mcsa/__init__.py,sha256=1zMzLORm22YxsNRoJ2_QmbIfGyU9bRWEzvOwHYLR1QA,137
+scfile/formats/mcsa/decoder.py,sha256=X-ew_hiqSDvLkHq6W7MBZ0UzRoX4YdyVqAujPu4vh3Q,7655
+scfile/formats/mcsa/exceptions.py,sha256=gAjvioHn73H7AsVBACs2KKhLct6n9zQFokdwnmkEflY,1278
+scfile/formats/mcsa/io.py,sha256=qCoNLSt4VvwG9fM5OiZaAUh2-pxPTiwDofwQfsoionc,3909
+scfile/formats/mcsa/versions.py,sha256=jXoRrH51rbHXeTR6fWq17eQM5h3dB9ubAR3hXDXluXc,248
+scfile/formats/mcsb/__init__.py,sha256=--ygCGNmZlxvxFUrzaECvDRE_yOLyTx3nAMd6PfKDlQ,61
+scfile/formats/mcsb/decoder.py,sha256=WwcoNMh1oqF0BOnPuifGooQ9oU5Q4rnSjtbVsrAktgA,287
+scfile/formats/mic/__init__.py,sha256=ipmhCnAXiSrGRFXU1LgS_i5A3ON3s3k6YrSEh-Ar2fo,59
+scfile/formats/mic/decoder.py,sha256=bTwQtoeTknueDU4C0IT3suTt-HnP6CkfW5BSlpzGKfQ,448
+scfile/formats/ms3d/__init__.py,sha256=JzlJlzW81MOgt2HHU68D9NYmJZ_zJE4fdxhd5ubnncc,111
+scfile/formats/ms3d/encoder.py,sha256=DY9tKMNhEBlmuCKGjQCuGU6JZEp4viOR-Wk5gktdntY,5043
+scfile/formats/ms3d/exceptions.py,sha256=68B8Mz5z0SvQ0vVgLw4GrKX3UMbV4SlmRnIypu9AYWE,584
+scfile/formats/ms3d/io.py,sha256=rqrDzCZWI43Um2DEatcKKKPMw_K2kp_MvZXO5Lx8IFc,521
+scfile/formats/obj/__init__.py,sha256=v7COYPO0-Y8iKpSG8-0Il_mlsjuwJgucuQt469tTD1s,59
+scfile/formats/obj/encoder.py,sha256=qGPruV8SxSgyv431xhuSWJWPRGDZa0PTDTw2JsZ6TUQ,2202
+scfile/formats/obj/faces.py,sha256=VC-2Ogy50FaGJXe2TcgH8KCyetZj8viyz4c_d__tSzg,426
+scfile/formats/ol/__init__.py,sha256=UmXOuoT8NcfAVFEPSv5imHc468O8LmD-mAW6BAQvD-U,131
+scfile/formats/ol/decoder.py,sha256=XEqWEX11ZG8F8rUfVBNX_fI4EkG-aerB_hr1FA-LZzg,2092
+scfile/formats/ol/exceptions.py,sha256=In-XAO_p9wjvaB1Vn1LtML7CUq7QD8qJK93mRzBPwxw,520
+scfile/formats/ol/formats.py,sha256=fjujvTX6Bygyiob1JyweBL6NUjzdX65j9IGhB38C14k,135
+scfile/formats/ol/io.py,sha256=bCliJj3W9MJDstq8iHbpWL_HQk8Dj74wVO-up1BRyvA,778
+scfile/formats/png/__init__.py,sha256=Ii9Y88llmEOV02fDyE7iAus20vmHCqnD00wnYFQsVBI,59
+scfile/formats/png/encoder.py,sha256=gM6a9-5QSt4hfFD3A3TryHO_FidEMDTlhwQBmgHfeqg,328
+scfile/formats/texarr/__init__.py,sha256=Ky1NS8dYS5BTDIsJbClmQXJ5CN9JrTDYfKnaH7w8wcY,78
+scfile/formats/texarr/decoder.py,sha256=_tXJ1WnuxqUbU2-YW035fU6TTqgRZBiyyS0nX3MGKtM,805
+scfile/formats/zip/__init__.py,sha256=NcgrNWy_Rnek7de1VFZJADulvVUXg7r_IgwC4yyclWw,78
+scfile/formats/zip/encoder.py,sha256=28OOYrEOjjEL9ah_VkXJ3UW8bk3WNGwfkIw4tI3y1Rs,402
+scfile/structures/__init__.py,sha256=g62_wTCxOF2RDBBeT2KaJJUz6JMKOa69KyufI6z7Thg,279
+scfile/structures/animation.py,sha256=UJ7BmOZ2DQhssUT02D7mI1CVCJQuALV57GLujdr7tEY,853
+scfile/structures/flags.py,sha256=BtZOCm8dFfisy8Z3L9VsiEznVzsCjVikcWa5DD1Ijhc,320
+scfile/structures/mesh.py,sha256=C_o57A9dieixDQRdQWIEcT1WDFhFAJ4Ur_Hc5xeoEmM,1717
+scfile/structures/scene.py,sha256=49hGqjzu0pla2h1jOpfwB30Mh7oE0xuFXLoP0Xcpw1w,1926
+scfile/structures/skeleton.py,sha256=UZa9rRfNmTWQQ8WkbmdYFhGCnyTJN_PQjRaoLBnCHk4,3643
+scfile/structures/texture.py,sha256=S6ZEd1yc560pKAy1okkw3VW8Dw8FhP2VX1xCFZ318So,1325
+scfile/structures/types.py,sha256=QwEcIuQUXj_9gTCbOArAmruZUqjUNZe5WnZHLD7KVKQ,128
+scfile/structures/vectors.py,sha256=613afYk14VS51WOOXGDC9Oo0esBowSirak7e6FWR8PI,434
+sc_file-0.0.0.dist-info/METADATA,sha256=hXTcXINXfPA2mLJty0idlc8Im8xF4qdpol19G2enC_M,5294
+sc_file-0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sc_file-0.0.0.dist-info/entry_points.txt,sha256=wjcio3iI6X_NoBBAepGm6UGrDnmIXK-KHuJpZ8oMhR0,48
+sc_file-0.0.0.dist-info/top_level.txt,sha256=kD3ZzfXy17HaeDhcENn7dQpnDMufc7CRmoa3DbUHFzo,7
+sc_file-0.0.0.dist-info/RECORD,,

sc_file-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sc_file-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+scfile = scfile.__main__:main

sc_file-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 onejeuu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sc_file-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+scfile

scfile/__init__.py

@@ -0,0 +1,19 @@
+__version__ = "4.1.2"
+__author__ = "onejeuu"
+__license__ = "MIT"
+
+
+from . import cli, convert, core, exceptions, formats, structures, consts, enums
+from .core.context.options import UserOptions
+
+__all__ = (
+    "cli",
+    "convert",
+    "core",
+    "exceptions",
+    "formats",
+    "structures",
+    "consts",
+    "enums",
+    "UserOptions",
+)

scfile/__main__.py

@@ -0,0 +1,26 @@
+import sys
+
+import click
+from rich import print
+
+from scfile.cli import scfile
+from scfile.enums import L
+
+
+def main():
+    """Program entrypoint."""
+
+    try:
+        scfile(standalone_mode=False)
+
+    except click.ClickException as err:
+        print(L.INVALID, str(err))
+
+    except (KeyboardInterrupt, click.exceptions.Abort):
+        print("[yellow]Operation aborted.[/]")
+
+    sys.exit()
+
+
+if __name__ == "__main__":
+    main()

scfile/cli/__init__.py

@@ -0,0 +1,13 @@
+"""
+CLI wrapper module. Responsible for implementation of interaction with internal core.
+"""
+
+from .commands import scfile
+from . import types, utils
+
+
+__all__ = (
+    "scfile",
+    "types",
+    "utils",
+)

scfile/cli/commands.py

@@ -0,0 +1,121 @@
+"""
+CLI wrapper implementation.
+"""
+
+import traceback
+from typing import Optional
+
+import click
+from rich import print
+
+from scfile import __version__, convert, exceptions
+from scfile.consts import CLI, Formats
+from scfile.core import UserOptions
+from scfile.enums import L
+
+from . import types, utils
+
+
+@click.command(name="scfile", epilog=CLI.EPILOG)
+@click.argument("PATHS", type=types.Files, nargs=-1)
+@click.option(
+    "-O",
+    "--output",
+    help="Output results directory.",
+    type=types.Output,
+)
+@click.option(
+    "-F",
+    "--mdlformat",
+    help="Preferred format for models.",
+    type=types.Formats,
+    multiple=True,
+)
+@click.option(
+    "--relative",
+    help="Preserve directory structure from source in output.",
+    is_flag=True,
+)
+@click.option(
+    "--parent",
+    help="Use parent directory as starting point in relative directory.",
+    is_flag=True,
+)
+@click.option(
+    "--skeleton",
+    help="Parse armature in models.",
+    is_flag=True,
+)
+@click.option(
+    "--animation",
+    help="Parse builtin clips in models.",
+    is_flag=True,
+)
+@click.option(
+    "--unique",
+    help="Ensure file saved with unique name, avoiding overwrites.",
+    is_flag=True,
+)
+@click.version_option(version=__version__)
+@click.pass_context
+def scfile(
+    ctx: click.Context,
+    paths: types.FilesPaths,
+    output: types.OutputDir,
+    mdlformat: Optional[Formats],
+    relative: bool,
+    parent: bool,
+    skeleton: bool,
+    animation: bool,
+    unique: bool,
+) -> None:
+    # In case program executed without arguments
+    if not paths:
+        utils.no_args(ctx)
+        return
+
+    # Normalize options
+    model_formats = mdlformat or None
+    if parent: relative = True
+    if animation: skeleton = True
+
+    # Relative flag is useless without output path
+    if relative and not output:
+        print(L.WARN, "Flag [b]--relative[/] requires [b]--output[/] option.")
+
+    # Warn if specified formats has unsupported features
+    if model_formats:
+        if skeleton: utils.check_feature_unsupported(model_formats, CLI.NON_SKELETAL_FORMATS, "skeleton")
+        if animation: utils.check_feature_unsupported(model_formats, CLI.NON_ANIMATION_FORMATS, "animation")
+
+    # Prepare options
+    options = UserOptions(
+        model_formats=model_formats,
+        parse_skeleton=skeleton,
+        parse_animation=animation,
+        overwrite=not unique,
+    )
+
+    # Iterate over each directory to their supported files
+    for root, source in utils.paths_to_files_map(paths):
+        # Get destination path
+        dest = utils.output_to_destination(root, source, output, relative, parent)
+
+        # Convert source file
+        try:
+            convert.auto(source=source, output=dest, options=options)
+
+        except exceptions.InvalidStructureError as err:
+            print(L.ERROR, str(err), CLI.EXCEPTION)
+
+        except exceptions.ScFileException as err:
+            print(L.ERROR, str(err))
+
+        except Exception as err:
+            traceback.print_exception(err)
+            print(L.EXCEPTION, f"File '{source.as_posix()}' {err}.", CLI.EXCEPTION)
+
+        else:
+            src_path = source.relative_to(root)
+            dst_path = dest or source.parent
+            print(L.INFO, f"File '{src_path.as_posix()}' converted to '{dst_path.as_posix()}'.")

scfile/cli/types.py

@@ -0,0 +1,21 @@
+"""
+Data types for CLI wrapper.
+"""
+
+import pathlib
+from typing import Iterator, Optional, Sequence, Tuple, TypeAlias
+
+import click
+
+from scfile.consts import OutputFormats
+
+
+PathType = pathlib.Path
+
+FilesPaths: TypeAlias = Sequence[PathType]
+FilesIter: TypeAlias = Iterator[Tuple[PathType, PathType]]
+OutputDir: TypeAlias = Optional[PathType]
+
+Files = click.Path(path_type=PathType, dir_okay=True, file_okay=True, exists=True, resolve_path=True)
+Output = click.Path(path_type=PathType, dir_okay=True, file_okay=False)
+Formats = click.Choice(list(OutputFormats.MODELS), case_sensitive=False)

scfile/cli/utils.py

@@ -0,0 +1,62 @@
+"""
+CLI wrapper small utils.
+"""
+
+from pathlib import Path
+
+import click
+from rich import print
+
+from scfile.consts import CLI, SUPPORTED_SUFFIXES, Formats
+from scfile.enums import L
+
+from . import types
+
+
+def no_args(ctx: click.Context) -> None:
+    """Prints help message when no arguments provided."""
+    click.echo(ctx.get_help())
+    print(
+        "",
+        f"{L.INVALID} No files paths arguments provided. Showing help.",
+        f"{L.HINT} Next time drag and drop files onto scfile.exe OR use terminal for parameters.",
+        sep="\n"
+    )
+    click.pause(CLI.PAUSE)
+
+
+def check_feature_unsupported(user_formats: Formats, unsupported_formats: Formats, feature: str) -> None:
+    """Checks that user formats contain unsupported feature."""
+    matching_formats = list(filter(lambda fmt: fmt in unsupported_formats, user_formats))
+
+    if bool(matching_formats):
+        suffixes = ", ".join(map(lambda fmt: fmt.suffix, matching_formats))
+        print(L.WARN, f"Specified formats [b]({suffixes})[/] doesn't support {feature}.")
+
+
+def is_supported(path: Path) -> bool:
+    """Checks that file is supported (by suffix)."""
+    return path.is_file() and path.suffix in SUPPORTED_SUFFIXES
+
+
+def paths_to_files_map(paths: types.FilesPaths) -> types.FilesIter:
+    """Maps parent directories to their supported files."""
+    for path in paths:
+        path = path.resolve()
+
+        if path.is_file():
+            if is_supported(path):
+                yield path.parent, path
+
+        elif path.is_dir():
+            for file in path.rglob("*"):
+                if is_supported(file):
+                    yield path, file
+
+
+def output_to_destination(root: Path, source: Path, output: types.OutputDir, relative: bool, parent: bool) -> types.OutputDir:
+    """Output path with source relative subdirectory appended if relative flag."""
+    if relative and output:
+        basedir = root.parent if parent else root
+        return output / source.relative_to(basedir).parent
+    return output

scfile/consts.py

@@ -0,0 +1,106 @@
+from typing import Sequence, TypeAlias
+
+from .enums import FileFormat
+
+
+Formats: TypeAlias = Sequence[FileFormat]
+
+
+SUPPORTED_FORMATS: set[FileFormat] = {
+    FileFormat.MCSA,
+    FileFormat.MCSB,
+    FileFormat.MCVD,
+    FileFormat.MIC,
+    FileFormat.OL,
+    FileFormat.TEXARR,
+}
+"""Files formats (suffixes without dot) that can be converted."""
+
+SUPPORTED_SUFFIXES: set[str] = set(map(lambda fmt: fmt.suffix, SUPPORTED_FORMATS))
+"""Files suffixes that can be converted."""
+
+
+class FileSignature:
+    """File magic number for formats (big-endian)."""
+
+    MCSA = b"MCSA"
+    MCAL = b"MCAL"
+    MIC = b"\x89MIC"
+    OL = b"\x0a\x95\x23\xfd"
+
+    DDS = b"DDS "
+    PNG = b"\x89PNG"
+    GLTF = b"glTF"
+    MS3D = b"MS3D000000"
+
+
+class Factor:
+    """Integer max range for integer type."""
+
+    I8 = 0x7F
+    U8 = 0xFF
+    I16 = 0x7FFF
+    U16 = 0xFFFF
+
+
+class OlString:
+    """Xor encoded zero-end string."""
+
+    SIZE = 17
+    """16 encoded bytes and last 0x00 byte."""
+    XOR = ord("g")
+    NULL = ord("G")
+
+
+class CubemapFaces:
+    """Dds cubemap faces."""
+
+    FACES = {"+x", "-x", "+y", "-y", "+z", "-z"}
+    COUNT = len(FACES)
+
+
+class McsaModel:
+    """Mcsa model constants."""
+
+    DECIMALS = 6
+    ROOT_BONE_ID = -1
+    GEOMETRY_LIMIT = 1_000_000
+    """Safety limit to prevent memory overflow on corrupted files."""
+
+
+class McsaUnits:
+    """Mcsa structures elements count."""
+
+    POSITIONS = 4
+    TEXTURES = 2
+    NORMALS = 4
+    POLYGONS = 3
+    LINKS = 4
+    BONES = 6
+    FRAMES = 7
+
+
+class CLI:
+    """Command line interface constants."""
+
+    FORMATS = EPILOG = f"Supported formats: {', '.join(sorted(SUPPORTED_SUFFIXES))}"
+    EXCEPTION = "[b yellow]Input file appears to be corrupted or invalid.[/]"
+    PAUSE = "\nPress any key to exit..."
+
+    NON_SKELETAL_FORMATS: Formats = (FileFormat.OBJ,)
+    NON_ANIMATION_FORMATS: Formats = (FileFormat.OBJ, FileFormat.MS3D, FileFormat.DAE)
+
+
+class OutputFormats:
+    """Supported output formats for file data types."""
+
+    MODELS: Formats = (FileFormat.OBJ, FileFormat.GLB, FileFormat.DAE, FileFormat.MS3D)
+    TEXTURES: Formats = (FileFormat.DDS,)
+    IMAGES: Formats = (FileFormat.PNG,)
+
+
+class DefaultModelFormats:
+    """Default model formats for cases where no preference is specified."""
+
+    STANDARD: Formats = (FileFormat.OBJ,)
+    SKELETON: Formats = (FileFormat.GLB,)

scfile/convert/__init__.py

@@ -0,0 +1,33 @@
+"""
+Utility module. Handles conversion logic between formats.
+"""
+
+from . import base, legacy, detect, formats
+from .detect import auto
+from .formats import (
+    mcsb_to_dae,
+    mcsb_to_glb,
+    mcsb_to_ms3d,
+    mcsb_to_obj,
+    ol_to_dds,
+    ol_cubemap_to_dds,
+    mic_to_png,
+    texarr_to_zip,
+)
+
+
+__all__ = (
+    "base",
+    "legacy",
+    "detect",
+    "formats",
+    "auto",
+    "mcsb_to_dae",
+    "mcsb_to_glb",
+    "mcsb_to_ms3d",
+    "mcsb_to_obj",
+    "ol_to_dds",
+    "ol_cubemap_to_dds",
+    "mic_to_png",
+    "texarr_to_zip",
+)