How do I use live script (*.mlx) files in source control?

Question

MathWorks Support Team 2016-3-4

4
链接

此问题的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/271488-how-do-i-use-live-script-mlx-files-in-source-control

评论： Jan Kappen 2024-7-6

采纳的回答： MathWorks Support Team

I would like to use the live script files with source control, what is the workflow for that?

请先登录，再回答此问题。

Answer 1

MathWorks Support Team 2024-6-6

1
链接

此回答的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/271488-how-do-i-use-live-script-mlx-files-in-source-control#answer_212297

编辑：MathWorks Support Team 2024-6-7

How to source control your files within MATLAB:

Since R2014b, you can integrate MATLAB with the Git source control system through the Current Folder browser (see the workflow shown in this video ).

To avoid corruption when doing so, you must register your MATLAB and Simulink file extensions such as .mlx, .mat, .fig, .mlapp, .mdl, .slx, .mdlp, .slxp, .sldd, and .p as binary formats. See more details here:

https://www.mathworks.com/help/matlab/matlab_prog/set-up-git-source-control.html

How to diff/merge your files:

Support for comparing live code (.mlx) files has been shipping with MATLAB since R2018a. A two-way merge tool was also added in R2018b. External version control tools can be configured to use MATLAB Comparison tool using the setup instructions outlined here:

https://www.mathworks.com/help/matlab/matlab_prog/customize-external-source-control-to-use-matlab-for-comparison-and-merge.html

Future improvements:

We're committed to making the Live Editor features work more seamlessly with source control – and we're also committed to providing an enhanced experience with plain text MATLAB files. We're working hard on both of these fronts, so stay tuned for future updates!

5 个评论
显示 3更早的评论隐藏 3更早的评论

Walter Roberson 2020-10-13

Why not have include 1 as plain text in the mlx file, and add 2 as zipped and base64 encoded

The use case for mlx files is that the user should only have to copy one file and that would bring all relevant parts with it. This is the same strategy as for Simulink .slx files.

.mlx files are zip files that are mostly XML files, using the same kind of directory structure used by Microsoft .xlsx files -- OpenXML structures.

Any inserted code or text or controls are encoded as xml.

Any inserted equations are primarily encoded as xml, but a mathml equivalent of them is also included.

Any inserted images have coded by relationship identifiers, and the appropriate .rels file (which is more XML but with a different extension) gives a directory reference to a binary copy of the image -- the image itself is included in the .mlx structure, not just a filename reference to the image.

You could potentially compare by unzip the .mlx file and comparing files. You might, however, have some difficulty with relationship identifiers being different -- I see no attempt in the files to allocate a GUID to relationships so as to be able to compare them even if you did something like insert a new control in the middle.

Markus Leuthold 2022-1-4

@Steven Lord

you cannot see any diffs on github
you cannot git blame
you cannot make one commit per topic by staging single lines which belong to a certain topic

All of these are important aspects of git which I don't want to loose

Hamid Farshi 2024-7-6

Starting with MATLAB R2024b if you use the "new MATLAB Desktop", you have the option of saving your MLX to M based live script. You can also change your settings so that all of your new live scripts would be M based .

请先登录，再进行评论。

Answer 2

Teemu Sillanpää 2018-3-22

8
链接

此回答的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/271488-how-do-i-use-live-script-mlx-files-in-source-control#answer_311269

So with the change from readable content (text) to binary, live scripts / to achieve .m files with documentation built in feature is totally useless in normal working environment (>1 user).

0 个评论
显示 -2更早的评论隐藏 -2更早的评论

请先登录，再进行评论。

Answer 3

Markus Leuthold 2019-4-1

6
链接

此回答的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/271488-how-do-i-use-live-script-mlx-files-in-source-control#answer_368462

This is going into a completely wrong direction. Source code files must be text files. The toolchain does not only consist of Matlab, but many other such aus Github etc... which become unusable with these mlx files.

Unfortunately, there are already new features which are only available in the Live editor, but not in the classic editor or command window, such as tab completion via functionSignatures.json

2 个评论
显示无隐藏无

Walter Roberson 2019-4-1

I used to rail against web pages with images because "Source code files must be text files!", and you couldn't copy and paste the representation of images. I lost that fight, Tools evolved.

I also appear to have lost the fight against CSS...

Michael Abboud 2021-6-29

Hi Markus, I'm a developer on the MATLAB Editor team and I'm glad to share that this Auto Completion functionality from the Live Editor is now available in plain text (.m) MATLAB files in the R2021b pre-release of the MATLAB Editor!

Many of the other coding tools from the Live Editor (Block selection, Refactoring, etc.) are also now available in plain text (.m) MATLAB files – along with a refreshed look and feel – starting with the R2021b pre-release which launched last week.

We think this is a big step forward, and we're excited for you to give it a try! If you're able to install a new version of MATLAB, I'd encourage you to try out the R2021b pre-release and send us feedback:

https://www.mathworks.com/downloads/prerelease

请先登录，再进行评论。

Answer 4

Richard Crozier 2018-3-21

4
链接

此回答的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/271488-how-do-i-use-live-script-mlx-files-in-source-control#answer_311156

编辑：Richard Crozier 2018-3-21

No you cannot use live scripts with any of the major version control systems such as svn, git or mercurial. They are a binary format and not compatible with these text difference based systems. Versioning the files will be possible in a very basic sense but none of the standard diffing and merging commands will work effectively, and none of the standard GUI tools for comparing versions will work as the files will simply appear as binary blobs.

You may be able to set up your source control system on one or two machines to work as specified in the Matlab docs, but no remote services such as Github or Bitbucket will support this.

0 个评论
显示 -2更早的评论隐藏 -2更早的评论

请先登录，再进行评论。

Answer 5

Jan Kappen 2021-6-22

1
链接

此回答的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/271488-how-do-i-use-live-script-mlx-files-in-source-control#answer_730615

编辑：Jan Kappen 2021-6-22

Any updates on that? Workarounds? Plugins for Github or GitLab? Mathworks is effectively destroying any kind of collaboration, --automatic testing-- (wrong, see below) and code reviewing.

I'd stick to .m files if the editor wasn't that bad :(

Even juypter notebook files are in text format... The Notebook file format — nbformat 5.1 documentation

12 个评论
显示 10更早的评论隐藏 10更早的评论

Jan Kappen 2021-6-22

Please ignore "automatic testing" in my rather provocant statement, that is not true, apologizes. CI & automated tests works well. Github Actions are the right direction, unfortunately, my company uses Bitbucket and Gitlab - no way to change that. Runners for CI work on local machines so better than nothing.

The part about collaboration and code review however remains true. Most of my developer colleagues (partially including myself) prefer not to use the Matlab GUI for code reviews (or anything else). This kind of work is done in the web interface where the pull request are shown or in good text editors that properly support git, pull requests, all kind of different languages, such as VSCode. There is no way to comment .mlx files line by line, or see incremental changes per commit online. One always has to checkout the whole commit and call the Matlab comparison tools (which have non-obvious interfaces and limited functionality - compare it with GitLens in VSCode and you know what I'm talking about ;)

Colleagues without having Matlab installed (or when no flex license is free) have no chance to do code reviews. That's certainly not the way to go.

What about supporting VSCode plugins like Add feature to support .mlx file(a matlab live script file) · Issue #115 · Gimly/vscode-matlab (github.com)? (I'm not the maintainer)

Thanks!

Jan Kappen 2021-6-23

Dear @Walter Roberson,

I'm afraid we indeed will stop using .mlx files though the idea is good. It's a too big source of error and slows down the development process, just as easy as that.

I'd like to continue using .m files, but the editor (auto completion, look & feel) is worse than the live editor. That means, I'd have to code in the live editor and save it as .m file to convert it to .mlx next time I (or my other 50 colleagues working with Matlab) want to make bigger changes where refactoring and auto completion features are needed. That's not a working workflow. Maybe commit hooks or one of these packages to convert .mlx to markdown can help: livescript2markdown: MATLAB's live scripts to markdown - File Exchange - MATLAB Central (mathworks.com) Live Script To Markdown Converter - File Exchange - MATLAB Central (mathworks.com)

Btw, as several people already mentioned the same issue in this thread, my needs are not that uncommon - in fact the majority of review workflows in software development I'm aware of are using web interfaces. And I wonder which company has not the same or at least similar requirements as ours has. These requirements automatically occur when a code review workflow combined with GIT (does not "like" binary data) is established. Which is standard.

Jupyter Notebooks work very similar as Livescripts, they contain code, text, pictures, latex and meta data and can be a) textually compared, b) rendered in GitHub, GitLab and Bitbucket, so it seems to be possible. I understand that .ipynb files are json, but as you state, .mlx is basically xml (zipped), so there should be ways to at least render them on the fly.

A comparison with .xlsx is not appropiate here imo. Microsoft has its own style of versioning and reviewing files via O365 and OneDrive/SharePoint. These files are simply not meant to be pushed to an VCS. On the other hand, Matlab .mlx files contain code. Code that often lived in .m files before. This should be reviewable outside Matlab.

I'm not asking to change the file format at all, I'm asking for helper to get around the fact that they cannot be rendered outside of Matlab.

Thanks.

Hamid Farshi 2024-7-6

Starting with MATLAB R2024b if you use the "new MATLAB Desktop", you have the option of saving your MLX to M based live script. You can also change your settings so that all of your new live scripts would be M based .

Jan Kappen 2024-7-6

Yep, already checked that out, it's nice!

请先登录，再进行评论。

How do I use live script (*.mlx) files in source control?