├── .gitattributes ├── .github └── workflows │ └── ci.yml ├── .gitignore ├── .gitlab-ci.yml ├── CONTRIBUTING.md ├── FunctionLibrary ├── .gitkeep ├── CheckBuildWord.mlx ├── CheckExercise5.mlx ├── CheckMarkMidpoint.mlx ├── ConwayGameSetup.mlx ├── RunConwayGame.mlx ├── ShowTaylor.mlx ├── ShowTaylor2.mlx ├── checkBuildWord.mlx ├── checkExercise5.mlx ├── checkMarkMidpoint.mlx ├── f.mlx └── runConwayGame.mlx ├── Images ├── AddOnsIcon.png ├── CodeCompare.png ├── Comment.png ├── EndIcon.png ├── Git-Icon.png ├── OpenInFX.png ├── OpenInMO.png ├── Refactor.png ├── Step.png ├── StoppedAtBreakpoint.png ├── TestedWith.json ├── TurkeysColor.png ├── end_24.png ├── image_10.gif ├── image_7.png └── turkeys1.jpg ├── InstructorResources └── Solutions │ ├── CommentingCodeSoln.mlx │ ├── DebuggingSoln.mlx │ ├── FunctionLibrarySoln │ ├── BuildWord.mlx │ ├── BuildWord2.mlx │ ├── MarkMidpoint.mlx │ ├── SplitChannels.mlx │ └── quad.mlx │ ├── FunctionsSoln.mlx │ └── SharingCodeSoln.mlx ├── LICENSE.md ├── MainMenu.mlx ├── README.md ├── README.mlx ├── SECURITY.md ├── Scripts ├── CommentingCode.mlx ├── Debugging.mlx ├── Functions.mlx └── SharingCode.mlx ├── SoftwareTests ├── CheckTestResults.m ├── CreateBadge.m ├── FunctionTests.m ├── PostFiles │ ├── PostCommentingCode.m │ ├── PostCommentingCodeSoln.m │ ├── PostDebugging.m │ ├── PostDebuggingSoln.m │ ├── PostFunctions.m │ ├── PostFunctionsSoln.m │ ├── PostSharingCode.m │ └── PostSharingCodeSoln.m ├── PostSmokeTest.m ├── PreFiles │ ├── PreCommentingCode.m │ ├── PreCommentingCodeSoln.m │ ├── PreDebugging.m │ ├── PreDebuggingSoln.m │ ├── PreFunctions.m │ ├── PreFunctionsSoln.m │ ├── PreSharingCode.m │ └── PreSharingCodeSoln.m ├── RunAllTests.m ├── SmokeTests.m ├── SolnSmokeTests.m └── TestResults_R2023b.txt ├── StructuringCode.prj ├── Utilities ├── OldVersions │ ├── MainMenuOld.mlx │ └── READMEOld.mlx ├── ProjectShutdown.m ├── ProjectStartup.m ├── ProjectStartupApp.m ├── README.m └── SurveyLinks.mat └── resources └── project ├── 6xhH2l9GP9loT6TdFn_Mo65sDHg ├── P8PSrqcBHMbGhqD2r1d9oc0h3TUd.xml └── P8PSrqcBHMbGhqD2r1d9oc0h3TUp.xml ├── 8h3kimKoV3g5SPdcFPq6bNqde20 ├── oBwspwaqrZC_Fmyb5wKi13xkOrMd.xml ├── oBwspwaqrZC_Fmyb5wKi13xkOrMp.xml ├── yvc00et_D9w1RZcV5T2-bniDUu0d.xml └── yvc00et_D9w1RZcV5T2-bniDUu0p.xml ├── BT5hWoz-UTefONdqForZyI91O8Y ├── Ur1esh7xN9L6aqDUKBE31DKE1Qod.xml └── Ur1esh7xN9L6aqDUKBE31DKE1Qop.xml ├── BjxNC43HIPP8KZwg_cceb68ikkA ├── dxW0rLxFMXm0cpQGCSkWQRi2YRsd.xml └── dxW0rLxFMXm0cpQGCSkWQRi2YRsp.xml ├── EEtUlUb-dLAdf0KpMVivaUlztwA ├── -upqjogKesBp3DwJRlG6KjrKvd4d.xml ├── -upqjogKesBp3DwJRlG6KjrKvd4p.xml ├── 2vfmNT5dFMoKB5FDZBSr3ouDAL8d.xml ├── 2vfmNT5dFMoKB5FDZBSr3ouDAL8p.xml ├── CimN6b3haEs9ki1jBr6eTHKXzIAd.xml ├── CimN6b3haEs9ki1jBr6eTHKXzIAp.xml ├── DxJWFQ6s-5tgLo-3uCpCdq16n-sd.xml ├── DxJWFQ6s-5tgLo-3uCpCdq16n-sp.xml ├── cn2Ee7NifKI7ffnw_Fjz5lrC1Qgd.xml ├── cn2Ee7NifKI7ffnw_Fjz5lrC1Qgp.xml ├── e7wCov_BYJUY6VsFZYx5ab3064gd.xml └── e7wCov_BYJUY6VsFZYx5ab3064gp.xml ├── HoHDHQ_WvHAAKj5aJOrvrg_vpt8 ├── xXlmKuOQ7YT_G1elNhbKQIUqSRMd.xml └── xXlmKuOQ7YT_G1elNhbKQIUqSRMp.xml ├── KAXfQgCar2Yb8zOxgvf9hdmLP1E ├── hvrnRHN01wxA3RHB4Yx9vil4O6Qd.xml ├── hvrnRHN01wxA3RHB4Yx9vil4O6Qp.xml ├── xcK8fO1pjra5DR0jot5vrzlBV84d.xml └── xcK8fO1pjra5DR0jot5vrzlBV84p.xml ├── NjSPEMsIuLUyIpr2u1Js5bVPsOs ├── 2kj09UetkV_lru3gvSPXnY6-nM4d.xml ├── 2kj09UetkV_lru3gvSPXnY6-nM4p.xml ├── KKyDJtbdIBOlaeHmIZd5VX6vqx8d.xml ├── KKyDJtbdIBOlaeHmIZd5VX6vqx8p.xml ├── QWNDYJD5mGW1bWYvPx9DtKnxzw4d.xml ├── QWNDYJD5mGW1bWYvPx9DtKnxzw4p.xml ├── R1RggVhA72agIvELiuhWPRS8F0Id.xml ├── R1RggVhA72agIvELiuhWPRS8F0Ip.xml ├── aEHSZBIY-yve10yGis12Zr5DLZod.xml ├── aEHSZBIY-yve10yGis12Zr5DLZop.xml ├── j4xwF_j8iFTVayUMfxLgMnTbencd.xml ├── j4xwF_j8iFTVayUMfxLgMnTbencp.xml ├── r8LR4nLmg9ai3oHrW1r_-KocQzkd.xml └── r8LR4nLmg9ai3oHrW1r_-KocQzkp.xml ├── Project.xml ├── VscVJQot7IndoRi0xm0fbAitS2Y ├── IN5Gw9hRs23W3dqBCLEXwjctJ1Id.xml └── IN5Gw9hRs23W3dqBCLEXwjctJ1Ip.xml ├── ZN2RlSIbyWXhOxbxxI4hOawbMD4 ├── p5HYYVUpTuYgZwnT8QkkzaoJraUd.xml ├── p5HYYVUpTuYgZwnT8QkkzaoJraUp.xml ├── q4FWbcu8zEbneDjWzNwfvfvjQNAd.xml ├── q4FWbcu8zEbneDjWzNwfvfvjQNAp.xml ├── s-04wUzHjOhlMa1CW_zpJwm8iDMd.xml └── s-04wUzHjOhlMa1CW_zpJwm8iDMp.xml ├── fjRQtWiSIy7hIlj-Kmk87M7s21k ├── NjSPEMsIuLUyIpr2u1Js5bVPsOsd.xml └── NjSPEMsIuLUyIpr2u1Js5bVPsOsp.xml ├── iMwdHOXOBiBXhnA_li8gtEJVTjc ├── RMvf4mEDuznAOqU6SKNmIWErfxgd.xml ├── RMvf4mEDuznAOqU6SKNmIWErfxgp.xml ├── ZTr3GAe6p03ZVs2FdKKE0JsiFMQd.xml ├── ZTr3GAe6p03ZVs2FdKKE0JsiFMQp.xml ├── nGmc4yUWSwVpS8w8tP7IolwQs0Ed.xml ├── nGmc4yUWSwVpS8w8tP7IolwQs0Ep.xml ├── uIbyU9dPEHKvxjdwx5pD9PDDCZYd.xml └── uIbyU9dPEHKvxjdwx5pD9PDDCZYp.xml ├── qaw0eS1zuuY1ar9TdPn1GMfrjbQ ├── 8h3kimKoV3g5SPdcFPq6bNqde20d.xml ├── 8h3kimKoV3g5SPdcFPq6bNqde20p.xml ├── BT5hWoz-UTefONdqForZyI91O8Yd.xml ├── BT5hWoz-UTefONdqForZyI91O8Yp.xml ├── BjxNC43HIPP8KZwg_cceb68ikkAd.xml ├── BjxNC43HIPP8KZwg_cceb68ikkAp.xml ├── KocSmEw1PpelhlG7ZNeMUdHVtywd.xml ├── KocSmEw1PpelhlG7ZNeMUdHVtywp.xml ├── VscVJQot7IndoRi0xm0fbAitS2Yd.xml ├── VscVJQot7IndoRi0xm0fbAitS2Yp.xml ├── ZN2RlSIbyWXhOxbxxI4hOawbMD4d.xml ├── ZN2RlSIbyWXhOxbxxI4hOawbMD4p.xml ├── iMwdHOXOBiBXhnA_li8gtEJVTjcd.xml ├── iMwdHOXOBiBXhnA_li8gtEJVTjcp.xml ├── rnpMu7jn2QWt_rQcz8FJ-MxGzVId.xml └── rnpMu7jn2QWt_rQcz8FJ-MxGzVIp.xml ├── root ├── 6x1BhZX_fLnKpcwqra0qFwv1jIgp.xml ├── 6xhH2l9GP9loT6TdFn_Mo65sDHgp.xml ├── EEtUlUb-dLAdf0KpMVivaUlztwAp.xml ├── GiiBklLgTxteCEmomM8RCvWT0nQd.xml ├── GiiBklLgTxteCEmomM8RCvWT0nQp.xml ├── HoHDHQ_WvHAAKj5aJOrvrg_vpt8p.xml ├── KAXfQgCar2Yb8zOxgvf9hdmLP1Ep.xml ├── NmGqIpAwUJcXFyLjFAGnU9uyN5Yp.xml ├── WZRuNzqc-Db7NcQAZO8Y-R8U9ccp.xml ├── fjRQtWiSIy7hIlj-Kmk87M7s21kp.xml └── qaw0eS1zuuY1ar9TdPn1GMfrjbQp.xml ├── rootp.xml ├── uuid-0b5f2aef-2281-4e2e-965e-7bb924d26344.xml └── uuid-366ca619-578a-4bc0-8012-bfa62d28c37f.xml /.gitattributes: -------------------------------------------------------------------------------- 1 | *.fig binary 2 | *.mat binary 3 | *.mdl binary diff merge=mlAutoMerge 4 | *.mdlp binary 5 | *.mexa64 binary 6 | *.mexw64 binary 7 | *.mexmaci64 binary 8 | *.mlapp binary linguist-language=MATLAB 9 | *.mldatx binary 10 | *.mlproj binary 11 | *.mlx binary merge=mlAutoMerge linguist-language=MATLAB 12 | *.p binary 13 | *.sfx binary 14 | *.sldd binary 15 | *.slreqx binary merge=mlAutoMerge 16 | *.slmx binary merge=mlAutoMerge 17 | *.sltx binary 18 | *.slxc binary 19 | *.slx binary merge=mlAutoMerge linguist-language=Simulink 20 | *.slxp binary 21 | 22 | ## Other common binary file types 23 | *.docx binary 24 | *.exe binary 25 | *.jpg binary 26 | *.pdf binary 27 | *.png binary 28 | *.xlsx binary 29 | 30 | # Ignore HTML 31 | 32 | *.html linguist-detectable=false 33 | -------------------------------------------------------------------------------- /.github/workflows/ci.yml: -------------------------------------------------------------------------------- 1 | name: MATLAB Build 2 | 3 | # Controls when the action will run. 4 | on: 5 | push: 6 | branches: [ release ] 7 | pull_request: 8 | branches: [ release ] 9 | workflow_dispatch: 10 | 11 | # Add permission to write GitHub pages 12 | permissions: 13 | contents: write 14 | pages: write 15 | id-token: write 16 | 17 | jobs: 18 | test: 19 | strategy: 20 | fail-fast: false 21 | matrix: 22 | MATLABVersion: [R2024a,R2024b] 23 | runs-on: ubuntu-latest 24 | steps: 25 | # Checks-out your repository 26 | - uses: actions/checkout@v4 27 | 28 | # Sets up a display server 29 | - name: Start display server 30 | if: ${{ always() }} 31 | run: | 32 | sudo apt-get install xvfb 33 | Xvfb :99 & 34 | echo "DISPLAY=:99" >> $GITHUB_ENV 35 | 36 | # Sets up MATLAB 37 | - name: Setup MATLAB 38 | uses: matlab-actions/setup-matlab@v2 39 | with: 40 | release: ${{ matrix.MATLABVersion }} 41 | products: > 42 | Symbolic_Math_Toolbox 43 | # Simulink Statistics_and_Machine_Learning_Toolbox 44 | # List required products above in the format shown (and uncomment them) 45 | # List of product strings: 46 | # Simulink 47 | # Statistics_and_Machine_Learning_Toolbox 48 | # Simulink_Coder 49 | # Econometrics_Toolbox 50 | # Deep_Learning_Toolbox 51 | 52 | 53 | # Run all the tests 54 | - name: Run SmokeTests 55 | uses: matlab-actions/run-command@v2 56 | with: 57 | command: openProject(pwd); RunAllTests; 58 | 59 | # Upload the test results as artifact 60 | - name: Upload TestResults 61 | if: ${{ always() }} 62 | uses: actions/upload-artifact@v4 63 | with: 64 | name: TestResults_${{ matrix.MATLABVersion }} 65 | path: ./public/* 66 | overwrite: true 67 | 68 | badge: 69 | if: ${{ always() }} 70 | needs: [test] 71 | strategy: 72 | fail-fast: false 73 | runs-on: ubuntu-latest 74 | steps: 75 | 76 | # Checks-out your repository 77 | - uses: actions/checkout@v4 78 | 79 | # Sets up R2023b 80 | - name: Setup MATLAB 81 | uses: matlab-actions/setup-matlab@v2 82 | with: 83 | release: R2024b 84 | 85 | # Download the test results from artifact 86 | - name: Download All TestResults 87 | uses: actions/download-artifact@v4 88 | with: 89 | path: public 90 | pattern: TestResults_* 91 | merge-multiple: true 92 | 93 | # Create the test results badge 94 | - name: Run PostSmokeTest 95 | uses: matlab-actions/run-command@v2 96 | with: 97 | command: openProject(pwd); PostSmokeTest; 98 | 99 | # Deploy reports to GitHub pages 100 | - name: Setup Pages 101 | uses: actions/configure-pages@v5 102 | - name: Upload pages artifact 103 | uses: actions/upload-pages-artifact@v3 104 | with: 105 | path: public 106 | - name: Deploy to GitHub Pages 107 | id: deployment 108 | uses: actions/deploy-pages@v4 109 | 110 | # Commit the JSON for the MATLAB releases badge 111 | - name: Commit changed files 112 | continue-on-error: true 113 | run: | 114 | git config user.name "${{ github.workflow }} by ${{ github.actor }}" 115 | git config user.email "<>" 116 | git pull 117 | git add Images/TestedWith.json 118 | git commit Images/TestedWith.json -m "Update CI badges ${{ github.ref_name }}" 119 | git fetch 120 | git push 121 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # List of untracked files to ignore 2 | 3 | # Autosave files 4 | *.asv 5 | *.m~ 6 | *.autosave 7 | *.slx.r* 8 | *.mdl.r* 9 | 10 | # MATLAB Drive 11 | *.MATLABDriveTag 12 | 13 | # Compiled files 14 | *.mex* 15 | *.p 16 | 17 | # Compressed files 18 | *.zip 19 | 20 | # Packaged app and toolbox files 21 | *.mlappinstall 22 | *.mltbx 23 | 24 | # Deployable archives 25 | *.ctf 26 | 27 | # Generated helpsearch folders 28 | helpsearch*/ 29 | 30 | # Defined Simulink cache folder 31 | Utilities/SimulinkCache/* 32 | 33 | # Standard code generation folders 34 | slprj/ 35 | sccprj/ 36 | codegen/ 37 | 38 | # Code generation file 39 | *.eep 40 | *.elf 41 | *.hex 42 | *.bin 43 | 44 | # Cache files 45 | *.slxc 46 | 47 | # Project settings 48 | Utilities/ProjectSettings.mat 49 | 50 | # GitLab page folder 51 | public/ -------------------------------------------------------------------------------- /.gitlab-ci.yml: -------------------------------------------------------------------------------- 1 | stages: 2 | # Set up two testing paths 3 | - setup 4 | - test 5 | - deploy 6 | - release 7 | 8 | setup-job: 9 | tags: 10 | - matlab 11 | stage: setup 12 | script: 13 | - cd .. 14 | - if (test-path utilities) { rm -r -force utilities } 15 | - git clone git@insidelabs-git.mathworks.com:modular-curriculum-content/utilities.git 16 | - cd $CI_PROJECT_NAME 17 | allow_failure: false 18 | 19 | 20 | smoke-test: 21 | # Smoke tests should run all the time 22 | tags: 23 | # Add additional tags like (e.g. - arduino) as required 24 | # Make sure that the runner you plan to use matches the tags 25 | - matlab 26 | stage: test 27 | parallel: 28 | matrix: 29 | - VERSION: [R2024a,R2024b] 30 | script: 31 | - Set-Alias -Name matlab -Value "C:\Program Files\MATLAB\$VERSION\bin\matlab.exe" 32 | - matlab -batch "openProject(pwd);RunAllTests" 33 | when: always 34 | allow_failure: true 35 | artifacts: 36 | name: "$VERSION" 37 | paths: 38 | - public/* 39 | when: always 40 | 41 | 42 | pages: 43 | tags: 44 | - matlab 45 | stage: deploy 46 | script: 47 | - matlab -batch "openProject(pwd);PostSmokeTest;" 48 | artifacts: 49 | paths: 50 | - public 51 | 52 | file-test: 53 | tags: 54 | - matlab 55 | stage: release 56 | script: 57 | - matlab -batch "proj = openProject(pwd); 58 | addpath(proj.RootFolder+'/InternalFiles/Tests/CI'); 59 | results = runtests('OpenCloseFileTest.m'); 60 | disp(table(results)); assertSuccess(results);" 61 | rules: 62 | # This test should always run when merging to main 63 | # And be available for manual running on any push 64 | - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == $CI_DEFAULT_BRANCH 65 | when: always 66 | - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME != $CI_DEFAULT_BRANCH 67 | when: manual 68 | allow_failure: true 69 | 70 | release-testing: 71 | tags: 72 | - matlab 73 | stage: release 74 | script: 75 | - matlab -batch "proj = openProject(pwd); 76 | cd ..; 77 | addpath(genpath(fullfile('utilities','TestingResources'))); 78 | addpath(genpath(fullfile('utilities','Tools'))); 79 | runCMTests" 80 | rules: 81 | # This test should always run when merging to main 82 | # And be available for manual running on any push 83 | - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == $CI_DEFAULT_BRANCH 84 | when: always 85 | - if: $CI_MERGE_REQUEST_TARGET_BRANCH_NAME != $CI_DEFAULT_BRANCH 86 | when: manual 87 | allow_failure: true 88 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing 2 | 3 | >_If you believe you have discovered a security vulnerability, please **do not** open an issue or make a pull request. Follow the instructions in the [SECURITY.md](SECURITY.md) file in this repository._ 4 | 5 | Thank you for your interest in contributing to a MathWorks repository! We encourage contributions large and small to this repository. 6 | 7 | **Contributions do not have to be code!** If you see a way to explain things more clearly or a great example of how to use something, please contribute it (or a link to your content). We welcome issues even if you don't code the solution. We also welcome pull requests to resolve issues that we haven't gotten to yet! 8 | 9 | ## How to give feedback 10 | * **Send us an email:** Contact the [MathWorks teaching resources team.](mailto:onlineteaching@mathworks.com) 11 | * **Open an issue:** Start by [creating an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue) in the repository that you're interested in. That will start a conversation with the maintainer. When you are creating a bug report, please include as many details as possible. Please remember that other people do not have your background or understanding of the issue; make sure you are clear and complete in your description. 12 | 13 | ## How to contribute to the repository 14 | * **Work in your own public fork:** If you choose to make a contribution, you should [fork the repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo). This creates an editable copy on GitHub where you can write, test, and refine your changes. We suggest that you keep your changes small and focused on the issue you submitted. 15 | * **Sign a Contributor License Agreement (CLA):** We require that all outside contributors sign a [CLA](https://en.wikipedia.org/wiki/Contributor_License_Agreement) before we can accept your contribution. When you create a pull request (see below), we'll reach out to you if you do not already have one on file. Essentially, the CLA gives us permission to publish your contribution as part of the repository. 16 | * **Make a pull request:** "[Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)" is a confusing term, but it means exactly what it says: You're requesting that the maintainers of the repository pull your changes in. If you don't have a CLA on file, we'll reach out to you. Your contribution will be reviewed, and we may ask you to revise your pull request based on our feedback. Once everyone is satisfied, we'll merge your pull request into the repository. 17 | 18 | ## Guidelines 19 | 20 | We don't have best practices for writing MATLAB® code, but we do have some recommendations: 21 | 22 | * You should not have any warnings or errors in the [code analyzer report](http://www.mathworks.com/help/matlab/matlab_prog/matlab-code-analyzer-report.html) 23 | * [Loren Shure's blog](https://blogs.mathworks.com/loren) has [great advice on improving your MATLAB code](https://blogs.mathworks.com/loren/category/best-practice/) 24 | * Examples should be written as [live scripts](https://www.mathworks.com/help/matlab/matlab_prog/what-is-a-live-script-or-function.html) or [Simulink® models](https://www.mathworks.com/help/simulink/index.html). 25 | * We adhere to the [CommonMark](https://commonmark.org/) specification where it does not conflict with GitHub rendering. If you edit your Markdown in Visual Studio Code or a similar editor, it uses [markdownlint](https://github.com/DavidAnson/markdownlint) to highlight issues in your Markdown. 26 | 27 | **Again, thanks for contributing, and we look forward to your issues and pull requests!** 28 | -------------------------------------------------------------------------------- /FunctionLibrary/.gitkeep: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/.gitkeep -------------------------------------------------------------------------------- /FunctionLibrary/CheckBuildWord.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/CheckBuildWord.mlx -------------------------------------------------------------------------------- /FunctionLibrary/CheckExercise5.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/CheckExercise5.mlx -------------------------------------------------------------------------------- /FunctionLibrary/CheckMarkMidpoint.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/CheckMarkMidpoint.mlx -------------------------------------------------------------------------------- /FunctionLibrary/ConwayGameSetup.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/ConwayGameSetup.mlx -------------------------------------------------------------------------------- /FunctionLibrary/RunConwayGame.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/RunConwayGame.mlx -------------------------------------------------------------------------------- /FunctionLibrary/ShowTaylor.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/ShowTaylor.mlx -------------------------------------------------------------------------------- /FunctionLibrary/ShowTaylor2.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/ShowTaylor2.mlx -------------------------------------------------------------------------------- /FunctionLibrary/checkBuildWord.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/checkBuildWord.mlx -------------------------------------------------------------------------------- /FunctionLibrary/checkExercise5.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/checkExercise5.mlx -------------------------------------------------------------------------------- /FunctionLibrary/checkMarkMidpoint.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/checkMarkMidpoint.mlx -------------------------------------------------------------------------------- /FunctionLibrary/f.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/f.mlx -------------------------------------------------------------------------------- /FunctionLibrary/runConwayGame.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/FunctionLibrary/runConwayGame.mlx -------------------------------------------------------------------------------- /Images/AddOnsIcon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/AddOnsIcon.png -------------------------------------------------------------------------------- /Images/CodeCompare.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/CodeCompare.png -------------------------------------------------------------------------------- /Images/Comment.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/Comment.png -------------------------------------------------------------------------------- /Images/EndIcon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/EndIcon.png -------------------------------------------------------------------------------- /Images/Git-Icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/Git-Icon.png -------------------------------------------------------------------------------- /Images/OpenInFX.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/OpenInFX.png -------------------------------------------------------------------------------- /Images/OpenInMO.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/OpenInMO.png -------------------------------------------------------------------------------- /Images/Refactor.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/Refactor.png -------------------------------------------------------------------------------- /Images/Step.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/Step.png -------------------------------------------------------------------------------- /Images/StoppedAtBreakpoint.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/StoppedAtBreakpoint.png -------------------------------------------------------------------------------- /Images/TestedWith.json: -------------------------------------------------------------------------------- 1 | {"schemaVersion":1,"label":"Test Status","color":"success","message":"R2024a | R2024b"} 2 | -------------------------------------------------------------------------------- /Images/TurkeysColor.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/TurkeysColor.png -------------------------------------------------------------------------------- /Images/end_24.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/end_24.png -------------------------------------------------------------------------------- /Images/image_10.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/image_10.gif -------------------------------------------------------------------------------- /Images/image_7.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/image_7.png -------------------------------------------------------------------------------- /Images/turkeys1.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Images/turkeys1.jpg -------------------------------------------------------------------------------- /InstructorResources/Solutions/CommentingCodeSoln.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/CommentingCodeSoln.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/DebuggingSoln.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/DebuggingSoln.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/FunctionLibrarySoln/BuildWord.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/FunctionLibrarySoln/BuildWord.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/FunctionLibrarySoln/BuildWord2.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/FunctionLibrarySoln/BuildWord2.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/FunctionLibrarySoln/MarkMidpoint.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/FunctionLibrarySoln/MarkMidpoint.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/FunctionLibrarySoln/SplitChannels.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/FunctionLibrarySoln/SplitChannels.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/FunctionLibrarySoln/quad.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/FunctionLibrarySoln/quad.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/FunctionsSoln.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/FunctionsSoln.mlx -------------------------------------------------------------------------------- /InstructorResources/Solutions/SharingCodeSoln.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/InstructorResources/Solutions/SharingCodeSoln.mlx -------------------------------------------------------------------------------- /LICENSE.md: -------------------------------------------------------------------------------- 1 | Copyright (c) 2023, The MathWorks, Inc. 2 | All rights reserved. 3 | 4 | Redistribution and use in source and binary forms, with or without 5 | modification, are permitted provided that the following conditions are 6 | met: 7 | 8 | * Redistributions of source code must retain the above copyright 9 | notice, this list of conditions and the following disclaimer. 10 | * Redistributions in binary form must reproduce the above copyright 11 | notice, this list of conditions and the following disclaimer in 12 | the documentation and/or other materials provided with the distribution 13 | * Neither the name of the The MathWorks, Inc. nor the names 14 | of its contributors may be used to endorse or promote products derived 15 | from this software without specific prior written permission. 16 | 17 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 18 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20 | ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 21 | LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22 | CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 | SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24 | INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25 | CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26 | ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27 | POSSIBILITY OF SUCH DAMAGE. 28 | -------------------------------------------------------------------------------- /MainMenu.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/MainMenu.mlx -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | # Programming: Structuring Code 3 | 4 | 5 | [![View on File Exchange](https://www.mathworks.com/matlabcentral/images/matlab-file-exchange.svg)](https://www.mathworks.com/matlabcentral/fileexchange/115905-programming-structuring-code) or [![Open in MATLAB Online](https://www.mathworks.com/images/responsive/global/open-in-matlab-online.svg)](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj&file=README.mlx) 6 | 7 | [![MATLAB Versions Tested](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FMathWorks-Teaching-Resources%2FProgramming-Structuring-Code%2Frelease%2FImages%2FTestedWith.json)](https://MathWorks-Teaching-Resources.github.io/Programming-Structuring-Code) 8 | 9 | **Curriculum Module** 10 | 11 | _Created with R2024a. Compatible with R2024a and later releases._ 12 | 13 | # Information 14 | 15 | This curriculum module contains interactive [MATLAB® live scripts](https://www.mathworks.com/products/matlab/live-editor.html) that teach fundamental concepts and basic terminology related to programming computers. This module focuses on organizing code into functions, describing, debugging, and sharing code. 16 | 17 | 18 | ## Background 19 | 20 | You can use these live scripts as demonstrations in lectures, class activities, or interactive assignments outside class. This module covers using built\-in and user\-defined functions, commenting code and choosing variable names, utilizing warning messages and run\-time errors to locate and fix bugs, comparing different versions of a script, cloning a GitHub repository, and creating a MATLAB project. 21 | 22 | 23 | The instructions inside the live scripts will guide you through the exercises and activities. Get started with each live script by running it one section at a time. To stop running the script or a section midway (for example, when an animation is in progress), use the EndIcon.png Stop button in the **RUN** section of the **Live Editor** tab in the MATLAB Toolstrip. 24 | 25 | ## Contact Us 26 | 27 | Solutions are available upon instructor request. Contact the [MathWorks teaching resources team](mailto:onlineteaching@mathworks.com) if you would like to request solutions, provide feedback, or if you have a question. 28 | 29 | 30 | ## Prerequisites 31 | 32 | This module assumes familiarity with basic programming concepts such as floating point doubles and strings, structures including constants, vectors, matrices, and arrays, and control flows including if/else, for loops, and while loops, as well as how to use them in MATLAB. These ideas are all presented with interactive examples in [Fundamentals of Programming](https://www.mathworks.com/matlabcentral/fileexchange/103225-fundamentals-of-programming). 33 | 34 | 35 | ## Getting Started 36 | ### Accessing the Module 37 | ### **On MATLAB Online:** 38 | 39 | Use the [OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj) link to download the module. You will be prompted to log in or create a MathWorks account. The project will be loaded, and you will see an app with several navigation options to get you started. 40 | 41 | ### **On Desktop:** 42 | 43 | Download or clone this repository. Open MATLAB, navigate to the folder containing these scripts and double\-click on [StructuringCode.prj](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj&file=README.mlx). It will add the appropriate files to your MATLAB path and open an app that asks you where you would like to start. 44 | 45 | 46 | Ensure you have all the required products (listed below) installed. If you need to include a product, add it using the Add\-On Explorer. To install an add\-on, go to the **Home** tab and select AddOnsIcon.png **Add-Ons** > **Get Add-Ons**. 47 | 48 | ## Products 49 | 50 | MATLAB® is used throughout, and the Symbolic Math Toolbox™ is used for the ShowTaylor example in Functions.mlx. 51 | 52 | # Scripts 53 | ## [**Functions.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj&file=Scripts/Functions.mlx) 54 | | | | | 55 | | :-- | :-- | :-- | 56 | | | **In this script, students will...**
| **Summary**
| 57 | | Refactor.png
| $\bullet$ use mathematical functions to use MATLAB as a calculator.
$\bullet$ use the documentation to locate functions and determine how to use them.
$\bullet$ write simple functions with inputs, outputs, and side effects, and ensure the functions are on your MATLAB path.
$\bullet$ pass functions as arguments by using function handles.
| Organizing code into functions improves the readability, reusability, and ease of testing. This script addresses built\-in functions, refactoring code to create functions, local functions, functions defined in their own files, programmatic scope and the MATLAB path, and how to pass functions as arguments to other functions.
| 58 | | | | | 59 | 60 | ## [**Debugging.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj&file=Scripts/Debugging.mlx) 61 | | | | | 62 | | :-- | :-- | :-- | 63 | | | **In this script, students will...**
| **Summary**
| 64 | | StoppedAtBreakpoint.png
| $\bullet$ identify warning messages and locate and fix the problem.
$\bullet$ locate and fix syntax errors.
$\bullet$ recognize and isolate run\-time errors.
| Everyone makes mistakes when coding or interacting with computer programs, but you can fix these mistakes. This script introduces the MATLAB Code Analyzer, errors, warnings, breakpoints, stepping, and other tools for minimizing errors as well as identifying and removing bugs from your programs.
| 65 | | | | | 66 | 67 | ## [**CommentingCode.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj&file=Scripts/CommentingCode.mlx) 68 | | | | | 69 | | :-- | :-- | :-- | 70 | | | **In this script, students will...**
| **Summary**
| 71 | | Comment.png
| $\bullet$ write comments and documentation for a self\-defined function.
$\bullet$ select meaningful variable names and add code and documentation to an existing function.
| Clearly documenting and communicating your thinking is essential to program with others or even your future self. This script addresses why and how you should document and comment your code.
| 72 | | | | | 73 | 74 | ## [**SharingCode.mlx**](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Structuring-Code&project=StructuringCode.prj&file=Scripts/SharingCode.mlx) 75 | | | | | 76 | | :-- | :-- | :-- | 77 | | | **In this script, students will...**
| **Summary**
| 78 | | CodeCompare.png
| $\bullet$ add scripts to a project.
$\bullet$ clone a GitHub repository.
$\bullet$ use the Compare tool to see differences between two versions of the same live script
| Writing code for yourself is the first step, but when you create something useful or interesting, you also need to know how to share your work with others. This script offers a brief introduction to sharing your code with others.
| 79 | | | | | 80 | 81 | # License 82 | 83 | The license for this module is available in the [LICENSE.md](https://github.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/blob/release/LICENSE.md). 84 | 85 | # Related Courseware Modules 86 | | | | | 87 | | :-- | :-- | :-- | 88 | | **Courseware Module**
| **Sample Content**
| **Available on:**
| 89 | | [**Programming: Organizing Data**](https://www.mathworks.com/matlabcentral/fileexchange/115900-programming-organizing-data)
Learn more about strings, numeric data types,
memory, and ways of storing data
| image_7.png
| [OpenInFX.png](https://www.mathworks.com/matlabcentral/fileexchange/115900-programming-organizing-data)
[OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-Organizing-Data&project=OrganizingData.prj)
[GitHub](https://github.com/MathWorks-Teaching-Resources/Programming-Organizing-Data)
| 90 | | [**Programming: A Starter Project Using MATLAB and Python**](https://www.mathworks.com/matlabcentral/fileexchange/116490-programming-a-starter-project-using-matlab-and-python)
Use MATLAB, Python, and the OpenWeather API
together to implement a weather prediction dashboard
| image_10.gif
| [OpenInFX.png](https://www.mathworks.com/matlabcentral/fileexchange/116490-programming-a-starter-project-using-matlab-and-python)
[OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Programming-A-Starter-Project-Using-MATLAB-and-Python&project=MATLABwithPython.prj)
[GitHub](https://github.com/MathWorks-Teaching-Resources/Programming-A-Starter-Project-Using-MATLAB-and-Python)
| 91 | | | | | 92 | 93 | 94 | **Introductory content:** 95 | 96 | - [**Fundamentals of Programming**](https://www.mathworks.com/matlabcentral/fileexchange/103225-fundamentals-of-programming) is available on [OpenInFX.png](https://www.mathworks.com/matlabcentral/fileexchange/103225-fundamentals-of-programming) or [OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Fundamentals-of-Programming&project=FundamentalsofProgramming.prj) or [GitHub](https://github.com/MathWorks-Teaching-Resources/Fundamentals-of-Programming) 97 | - [**Treasure Hunt Game: Learn to Code**](https://www.mathworks.com/matlabcentral/fileexchange/123265-treasure-hunt) is available on [OpenInFX.png](https://www.mathworks.com/matlabcentral/fileexchange/123265-treasure-hunt) or [OpenInMO.png](https://matlab.mathworks.com/open/github/v1?repo=MathWorks-Teaching-Resources/Treasure-Hunt&project=TreasureHunt.prj) or [GitHub](https://github.com/MathWorks-Teaching-Resources/Treasure-Hunt) 98 | 99 | Or feel free to explore our other [modular courseware content](https://www.mathworks.com/matlabcentral/fileexchange/?q=tag%3A%22courseware+module%22&sort=downloads_desc_30d). 100 | 101 | # Educator Resources 102 | - [Educator Page](https://www.mathworks.com/academia/educators.html) 103 | 104 | # Contribute 105 | 106 | Looking for more? Find an issue? Have a suggestion? Please contact the [MathWorks teaching resources team](mailto:%20onlineteaching@mathworks.com). If you want to contribute directly to this project, you can find information about how to do so in the [CONTRIBUTING.md](https://github.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/blob/release/CONTRIBUTING.md) page on GitHub. 107 | 108 | 109 | *©* Copyright 2024 The MathWorks™, Inc 110 | 111 | 112 | -------------------------------------------------------------------------------- /README.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/README.mlx -------------------------------------------------------------------------------- /SECURITY.md: -------------------------------------------------------------------------------- 1 | # Reporting Security Vulnerabilities 2 | 3 | If you believe you have discovered a security vulnerability, please report it to 4 | [security@mathworks.com](mailto:security@mathworks.com). Please see 5 | [MathWorks Vulnerability Disclosure Policy for Security Researchers](https://www.mathworks.com/company/aboutus/policies_statements/vulnerability-disclosure-policy.html) 6 | for additional information. -------------------------------------------------------------------------------- /Scripts/CommentingCode.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Scripts/CommentingCode.mlx -------------------------------------------------------------------------------- /Scripts/Debugging.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Scripts/Debugging.mlx -------------------------------------------------------------------------------- /Scripts/Functions.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Scripts/Functions.mlx -------------------------------------------------------------------------------- /Scripts/SharingCode.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Scripts/SharingCode.mlx -------------------------------------------------------------------------------- /SoftwareTests/CheckTestResults.m: -------------------------------------------------------------------------------- 1 | classdef CheckTestResults < matlab.unittest.TestCase 2 | 3 | properties (SetAccess = protected) 4 | end 5 | 6 | properties (ClassSetupParameter) 7 | Project = {currentProject()}; 8 | end 9 | 10 | properties (TestParameter) 11 | Version 12 | end 13 | 14 | 15 | methods (TestParameterDefinition,Static) 16 | 17 | function Version = GetResults(Project) 18 | RootFolder = Project.RootFolder; 19 | Version = dir(fullfile(RootFolder,"public","TestResults*.txt")); 20 | Version = extractBetween([Version.name],"TestResults_",".txt"); 21 | end 22 | 23 | end 24 | 25 | methods (TestClassSetup) 26 | 27 | function SetUpSmokeTest(testCase,Project) 28 | try 29 | currentProject; 30 | catch 31 | error("Project is not loaded.") 32 | end 33 | end 34 | 35 | end 36 | 37 | methods(Test) 38 | 39 | function CheckResults(testCase,Version) 40 | File = fullfile("public","TestResults_"+Version+".txt"); 41 | Results = readtable(File,TextType="string"); 42 | if ~all(Results.Passed) 43 | error("Some of the tests did not pass.") 44 | end 45 | end 46 | 47 | end 48 | 49 | end -------------------------------------------------------------------------------- /SoftwareTests/CreateBadge.m: -------------------------------------------------------------------------------- 1 | % Run these tests with runMyTests 2 | % All tests so far are on code expected to run without errors 3 | % If/when we end up with a version that _should_ error, 4 | % please add it to this set of examples 5 | classdef CreateBadge < matlab.unittest.TestCase 6 | 7 | properties 8 | rootProject 9 | results 10 | end 11 | 12 | 13 | methods (TestClassSetup) 14 | 15 | function setUpPath(testCase) 16 | 17 | try 18 | project = currentProject; 19 | testCase.rootProject = project.RootFolder; 20 | cd(testCase.rootProject) 21 | catch 22 | error("Load project prior to run tests") 23 | end 24 | 25 | testCase.log("Running in " + version) 26 | 27 | end % function setUpPath 28 | 29 | function readResults(testCase) 30 | Release = string([]); 31 | Passed = []; 32 | testCase.results = table(Release,Passed); 33 | 34 | ResultFiles = dir("SoftwareTests"+filesep+"TestResults_*"); 35 | for kFiles = 1:size(ResultFiles) 36 | Results = readtable(fullfile(ResultFiles(kFiles).folder,ResultFiles(kFiles).name),... 37 | Delimiter=",",TextType="string"); 38 | Release = Results.Version(1); 39 | Passed = all(Results.Status == "passed"); 40 | testCase.results(end+1,:) = table(Release,Passed); 41 | end 42 | end 43 | 44 | end % methods (TestClassSetup) 45 | 46 | methods(Test) 47 | 48 | function writeBadge(testCase) 49 | 50 | % Create JSON 51 | badgeInfo = struct; 52 | badgeInfo.schemaVersion = 1; 53 | badgeInfo.label = "tested with"; 54 | badgeInfo.message = ""; 55 | 56 | % Check that results exist: 57 | if size(testCase.results,1) == 0 58 | badgeInfo.message = "None"; 59 | badgeInfo.color = "failed"; 60 | else 61 | for i = 1:size(testCase.results,1) 62 | if testCase.results.Passed(i) 63 | if badgeInfo.message ~= "" 64 | badgeInfo.message = badgeInfo.message + " | "; 65 | end 66 | badgeInfo.message = badgeInfo.message + string(testCase.results.Release(i)); 67 | end 68 | end 69 | badgeInfo.color = "success"; 70 | end 71 | 72 | % Write JSON file out 73 | badgeJSON = jsonencode(badgeInfo); 74 | fid = fopen(fullfile("Images","TestedWith.json"),"w"); 75 | fwrite(fid,badgeJSON); 76 | fclose(fid); 77 | 78 | end 79 | 80 | end 81 | 82 | end -------------------------------------------------------------------------------- /SoftwareTests/FunctionTests.m: -------------------------------------------------------------------------------- 1 | classdef FunctionTests < matlab.unittest.TestCase 2 | 3 | % https://www.mathworks.com/help/matlab/matlab_prog/use-parameters-in-class-based-tests.html 4 | 5 | methods(Test) 6 | 7 | end % methods 8 | 9 | end % classdef -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostCommentingCode.m: -------------------------------------------------------------------------------- 1 | % Post-run script for CommentingCode.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostCommentingCodeSoln.m: -------------------------------------------------------------------------------- 1 | % Post-run script for CommentingCodeSoln.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostDebugging.m: -------------------------------------------------------------------------------- 1 | % Post-run script for Debugging.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostDebuggingSoln.m: -------------------------------------------------------------------------------- 1 | % Post-run script for DebuggingSoln.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostFunctions.m: -------------------------------------------------------------------------------- 1 | % Post-run script for Functions.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostFunctionsSoln.m: -------------------------------------------------------------------------------- 1 | % Post-run script for FunctionsSoln.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostSharingCode.m: -------------------------------------------------------------------------------- 1 | % Post-run script for SharingCode.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostFiles/PostSharingCodeSoln.m: -------------------------------------------------------------------------------- 1 | % Post-run script for SharingCodeSoln.mlx 2 | % ---- Post-run commands ----- 3 | 4 | -------------------------------------------------------------------------------- /SoftwareTests/PostSmokeTest.m: -------------------------------------------------------------------------------- 1 | function PostSmokeTest(ShowReport) 2 | arguments 3 | ShowReport (1,1) logical = false; 4 | end 5 | 6 | import matlab.unittest.plugins.TestRunnerPlugin; 7 | 8 | % Create the runner: 9 | Runner = matlab.unittest.TestRunner.withTextOutput; 10 | 11 | % Create report folder: 12 | Folder = fullfile(currentProject().RootFolder,"public"); 13 | if ~isfolder(Folder) 14 | mkdir(Folder) 15 | end 16 | 17 | % Add HTML plugin: 18 | Plugin = matlab.unittest.plugins.TestReportPlugin.producingHTML(Folder,... 19 | "IncludingPassingDiagnostics",true,... 20 | "IncludingCommandWindowText",false,... 21 | "LoggingLevel",matlab.automation.Verbosity(1)); 22 | Runner.addPlugin(Plugin); 23 | 24 | 25 | % Create Test Suite 26 | Suite = testsuite("CheckTestResults"); 27 | 28 | % Run the test suite 29 | Results = Runner.run(Suite); 30 | 31 | 32 | % Format the results in a table and save them 33 | Results = table(Results'); 34 | Version = extractBetween(string(Results.Name),"Version=",")"); 35 | Passed = Results.Passed; 36 | 37 | % Add link to other report 38 | File = fileread(fullfile("public","index.html")); 39 | for iVer = 1:length(Version) 40 | File = replace(File,"Version="+Version(iVer),... 41 | sprintf('%s',Version(iVer),"Version="+Version(iVer))); 42 | end 43 | writelines(File,fullfile("public","index.html"),"WriteMode","overwrite"); 44 | 45 | % Format the JSON file 46 | Badge = struct; 47 | Badge.schemaVersion = 1; 48 | Badge.label = "Test Status"; 49 | if all(Passed) 50 | Badge.color = "success"; 51 | Badge.message = join("R"+Version," | "); 52 | elseif any(Passed) 53 | Badge.color = "yellowgreen"; 54 | Badge.message = join("R") 55 | elseif all(~Passed) 56 | Badge.color = "critical"; 57 | Badge.message = join("R"+Version," | "); 58 | end 59 | Badge = jsonencode(Badge); 60 | writelines(Badge,fullfile("Images","TestedWith.json")); 61 | 62 | if ShowReport 63 | web(fullfile(Folder,"index.html")) 64 | end 65 | 66 | end -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreCommentingCode.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for CommentingCode.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreCommentingCodeSoln.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for CommentingCodeSoln.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | addpath(genpath(fullfile(currentProject().RootFolder,... 7 | "InstructorResources","Solutions","FunctionLibrarySoln"))) -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreDebugging.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for Debugging.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreDebuggingSoln.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for DebuggingSoln.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreFunctions.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for Functions.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreFunctionsSoln.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for FunctionsSoln.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = "MATLAB:UndefinedFunction"; 4 | % ---- Pre-run commands ----- 5 | 6 | addpath(genpath(fullfile(currentProject().RootFolder,... 7 | "InstructorResources","Solutions","FunctionLibrarySoln"))) -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreSharingCode.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for SharingCode.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | -------------------------------------------------------------------------------- /SoftwareTests/PreFiles/PreSharingCodeSoln.m: -------------------------------------------------------------------------------- 1 | % Pre-run script for SharingCodeSoln.mlx 2 | % ---- Known Issues ----- 3 | KnownIssuesID = ""; 4 | % ---- Pre-run commands ----- 5 | 6 | -------------------------------------------------------------------------------- /SoftwareTests/RunAllTests.m: -------------------------------------------------------------------------------- 1 | function RunAllTests(ShowReport) 2 | arguments 3 | ShowReport (1,1) logical = false; 4 | end 5 | 6 | import matlab.unittest.plugins.TestReportPlugin; 7 | 8 | % Create a runner 9 | Runner = matlab.unittest.TestRunner.withTextOutput; 10 | Folder = fullfile(currentProject().RootFolder,"public",version("-release")); 11 | if ~isfolder(Folder) 12 | mkdir(Folder) 13 | else 14 | rmdir(Folder,'s') 15 | mkdir(Folder) 16 | end 17 | Plugin = TestReportPlugin.producingHTML(Folder,... 18 | "IncludingPassingDiagnostics",true,... 19 | "IncludingCommandWindowText",true,... 20 | "LoggingLevel",matlab.automation.Verbosity(1)); 21 | Runner.addPlugin(Plugin); 22 | 23 | 24 | % Create the test suite with SmokeTest and Function test if they exist 25 | Suite = testsuite("SmokeTests"); 26 | Suite = [Suite testsuite("FunctionTests")]; 27 | Suite = [Suite testsuite("SolnSmokeTests")]; 28 | 29 | % Run the test suite 30 | Results = Runner.run(Suite); 31 | 32 | if ShowReport 33 | web(fullfile(Folder,"index.html")) 34 | end 35 | 36 | % Format the results in a table and save them 37 | ResultsTable = table(Results') 38 | writetable(ResultsTable,fullfile(currentProject().RootFolder,... 39 | "public","TestResults_"+version("-release")+".txt")); 40 | 41 | % Assert success of test 42 | assertSuccess(Results); 43 | 44 | end 45 | -------------------------------------------------------------------------------- /SoftwareTests/SmokeTests.m: -------------------------------------------------------------------------------- 1 | classdef SmokeTests < matlab.unittest.TestCase 2 | 3 | properties 4 | RootFolder 5 | sparedEditors % Files already open when the test starts 6 | end % properties 7 | 8 | properties (ClassSetupParameter) 9 | Project = {currentProject()}; 10 | end % ClassSetupParameter 11 | 12 | properties (TestParameter) 13 | File; 14 | end % TestParameter 15 | 16 | methods (TestParameterDefinition,Static) 17 | 18 | function File = RetrieveFile(Project) %#ok 19 | % Retrieve student template files: 20 | RootFolder = currentProject().RootFolder; 21 | File = dir(fullfile(RootFolder,"Scripts","*.mlx")); 22 | File = {File.name}; 23 | end 24 | 25 | end % Static TestParameterDefinition 26 | 27 | methods (TestClassSetup) 28 | 29 | function SetUpSmokeTest(testCase,Project) %#ok 30 | % Navigate to project root folder: 31 | testCase.RootFolder = Project.RootFolder; 32 | cd(testCase.RootFolder) 33 | 34 | % Close the StartUp app if still open: 35 | delete(findall(groot,'Name','StartUp App')) 36 | 37 | % Log MATLAB version: 38 | testCase.log("Running in " + version) 39 | end 40 | 41 | end % TestClassSetup 42 | 43 | methods(TestMethodSetup) 44 | function recordEditorsToSpare(testCase) 45 | testCase.sparedEditors = matlab.desktop.editor.getAll; 46 | testCase.sparedEditors = {testCase.sparedEditors.Filename}; 47 | end 48 | end % TestMethodSetup 49 | 50 | methods(TestMethodTeardown) 51 | function closeOpenedEditors_thenDeleteWorkingDir(testCase) 52 | openEditors = matlab.desktop.editor.getAll; 53 | for editor=openEditors(1:end) 54 | if any(strcmp(editor.Filename, testCase.sparedEditors)) 55 | continue; 56 | end 57 | % if not on our list, close the file 58 | editor.close(); 59 | end 60 | end 61 | end % TestMethodTeardown 62 | 63 | methods(Test) 64 | 65 | function SmokeRun(testCase,File) 66 | 67 | % Navigate to project root folder: 68 | cd(testCase.RootFolder) 69 | FileToRun = string(File); 70 | 71 | % Pre-test: 72 | PreFiles = CheckPreFile(testCase,FileToRun); 73 | run(PreFiles); 74 | 75 | % Run SmokeTest 76 | disp(">> Running " + FileToRun); 77 | try 78 | run(fullfile("Scripts",FileToRun)); 79 | catch ME 80 | 81 | end 82 | 83 | % Post-test: 84 | PostFiles = CheckPostFile(testCase,FileToRun); 85 | run(PostFiles) 86 | 87 | % Log every figure created during run: 88 | Figures = findall(groot,'Type','figure'); 89 | Figures = flipud(Figures); 90 | if ~isempty(Figures) 91 | for f = 1:size(Figures,1) 92 | if ~isempty(Figures(f).Number) 93 | FigDiag = matlab.unittest.diagnostics.FigureDiagnostic(Figures(f),'Formats','png'); 94 | log(testCase,1,FigDiag); 95 | end 96 | end 97 | end 98 | 99 | % Close all figures and Simulink models 100 | close all force 101 | if any(matlab.addons.installedAddons().Name == "Simulink") 102 | bdclose all 103 | end 104 | 105 | % Rethrow error if any 106 | if exist("ME","var") 107 | if ~any(strcmp(ME.identifier,KnownIssuesID)) 108 | rethrow(ME) 109 | end 110 | end 111 | 112 | end 113 | 114 | end % Test Methods 115 | 116 | 117 | methods (Access = private) 118 | 119 | function Path = CheckPreFile(testCase,Filename) 120 | PreFile = "Pre"+replace(Filename,".mlx",".m"); 121 | PreFilePath = fullfile(testCase.RootFolder,"SoftwareTests","PreFiles",PreFile); 122 | if ~isfolder(fullfile(testCase.RootFolder,"SoftwareTests/PreFiles")) 123 | mkdir(fullfile(testCase.RootFolder,"SoftwareTests/PreFiles")) 124 | end 125 | if ~isfile(PreFilePath) 126 | writelines("% Pre-run script for "+Filename,PreFilePath) 127 | writelines("% ---- Known Issues -----",PreFilePath,'WriteMode','append'); 128 | writelines("KnownIssuesID = "+char(34)+char(34)+";",PreFilePath,'WriteMode','append'); 129 | writelines("% ---- Pre-run commands -----",PreFilePath,'WriteMode','append'); 130 | writelines(" ",PreFilePath,'WriteMode','append'); 131 | end 132 | Path = PreFilePath; 133 | end 134 | 135 | function Path = CheckPostFile(testCase,Filename) 136 | PostFile = "Post"+replace(Filename,".mlx",".m"); 137 | PostFilePath = fullfile(testCase.RootFolder,"SoftwareTests","PostFiles",PostFile); 138 | if ~isfolder(fullfile(testCase.RootFolder,"SoftwareTests/PostFiles")) 139 | mkdir(fullfile(testCase.RootFolder,"SoftwareTests/PostFiles")) 140 | end 141 | if ~isfile(PostFilePath) 142 | writelines("% Post-run script for "+Filename,PostFilePath) 143 | writelines("% ---- Post-run commands -----",PostFilePath,'WriteMode','append'); 144 | writelines(" ",PostFilePath,'WriteMode','append'); 145 | end 146 | Path = PostFilePath; 147 | end 148 | 149 | end % Private Methods 150 | 151 | end % Smoketests -------------------------------------------------------------------------------- /SoftwareTests/SolnSmokeTests.m: -------------------------------------------------------------------------------- 1 | classdef SolnSmokeTests < matlab.unittest.TestCase 2 | 3 | properties 4 | RootFolder 5 | isSolnOnPath 6 | sparedEditors % Track open files 7 | end % properties 8 | 9 | properties (ClassSetupParameter) 10 | Project = {currentProject()}; 11 | end % ClassSetupParameter 12 | 13 | methods(TestMethodSetup) 14 | function recordEditorsToSpare(testCase) 15 | testCase.sparedEditors = matlab.desktop.editor.getAll; 16 | testCase.sparedEditors = {testCase.sparedEditors.Filename}; 17 | end 18 | end % TestMethodSetup 19 | 20 | methods(TestMethodTeardown) 21 | function closeOpenedEditors_thenDeleteWorkingDir(testCase) 22 | openEditors = matlab.desktop.editor.getAll; 23 | for editor=openEditors(1:end) 24 | if any(strcmp(editor.Filename, testCase.sparedEditors)) 25 | continue; 26 | end 27 | % if not on our list, close the file 28 | editor.close(); 29 | end 30 | end 31 | end % TestMethodTeardown 32 | 33 | properties (TestParameter) 34 | File; 35 | end % TestParameter 36 | 37 | methods (TestParameterDefinition,Static) 38 | 39 | function File = GetScriptName(Project) 40 | % Retrieve student template files: 41 | RootFolder = Project.RootFolder; 42 | File = dir(fullfile(RootFolder,"Scripts","*.mlx")); 43 | File = {File.name}; 44 | end 45 | 46 | end % Static TestParameterDefinition 47 | 48 | methods (TestClassSetup) 49 | 50 | function SetUpPath(testCase,Project) 51 | % Navigate to project root folder: 52 | testCase.RootFolder = Project.RootFolder; 53 | cd(testCase.RootFolder) 54 | 55 | % Check that solutions are on path: 56 | testCase.isSolnOnPath = isfolder("Solutions"); 57 | if testCase.isSolnOnPath == 0 58 | addpath(fullfile(testCase.RootFolder,"InstructorResources","Solutions")) 59 | end 60 | 61 | % Close the StartUp app if still open: 62 | delete(findall(groot,'Name','StartUp App')) 63 | 64 | % Log MATLAB version: 65 | testCase.log("Running in " + version) 66 | 67 | end % function setUpPath 68 | 69 | end % methods (TestClassSetup) 70 | 71 | methods(Test) 72 | 73 | % Check that solutions files exist for each of the student 74 | % templates 75 | function ExistSolns(testCase,File) 76 | SolutionName = replace(string(File),".mlx","Soln.mlx"); 77 | assert(exist(SolutionName,"file"),"Missing solutions for "+File); 78 | end 79 | 80 | 81 | function SmokeRun(testCase,File) 82 | 83 | % Navigate to project root folder: 84 | cd(testCase.RootFolder) 85 | FileToRun = replace(string(File),".mlx","Soln.mlx"); 86 | 87 | % Pre-test: 88 | PreFiles = CheckPreFile(testCase,FileToRun); 89 | run(PreFiles); 90 | 91 | % Run SmokeTest 92 | disp(">> Running " + FileToRun); 93 | try 94 | run(fullfile("InstructorResources","Solutions",FileToRun)); 95 | catch ME 96 | 97 | end 98 | 99 | % Post-test: 100 | PostFiles = CheckPostFile(testCase,FileToRun); 101 | run(PostFiles) 102 | 103 | % Log every figure created during run: 104 | Figures = findall(groot,'Type','figure'); 105 | Figures = flipud(Figures); 106 | if ~isempty(Figures) 107 | for f = 1:size(Figures,1) 108 | if ~isempty(Figures(f).Number) 109 | FigDiag = matlab.unittest.diagnostics.FigureDiagnostic(Figures(f),'Formats','png'); 110 | log(testCase,1,FigDiag); 111 | end 112 | end 113 | end 114 | 115 | % Close all figures and Simulink models 116 | close all force 117 | if any(matlab.addons.installedAddons().Name == "Simulink") 118 | bdclose all 119 | end 120 | 121 | % Rethrow error if any 122 | if exist("ME","var") 123 | if ~any(strcmp(ME.identifier,KnownIssuesID)) 124 | rethrow(ME) 125 | end 126 | end 127 | 128 | end 129 | 130 | end % Test Methods 131 | 132 | methods (Access = private) 133 | 134 | function Path = CheckPreFile(testCase,Filename) 135 | PreFile = "Pre"+replace(Filename,".mlx",".m"); 136 | PreFilePath = fullfile(testCase.RootFolder,"SoftwareTests","PreFiles",PreFile); 137 | if ~isfolder(fullfile(testCase.RootFolder,"SoftwareTests/PreFiles")) 138 | mkdir(fullfile(testCase.RootFolder,"SoftwareTests/PreFiles")) 139 | end 140 | if ~isfile(PreFilePath) 141 | writelines("% Pre-run script for "+Filename,PreFilePath) 142 | writelines("% ---- Known Issues -----",PreFilePath,'WriteMode','append'); 143 | writelines("KnownIssuesID = "+char(34)+char(34)+";",PreFilePath,'WriteMode','append'); 144 | writelines("% ---- Pre-run commands -----",PreFilePath,'WriteMode','append'); 145 | writelines(" ",PreFilePath,'WriteMode','append'); 146 | end 147 | Path = PreFilePath; 148 | end 149 | 150 | function Path = CheckPostFile(testCase,Filename) 151 | PostFile = "Post"+replace(Filename,".mlx",".m"); 152 | PostFilePath = fullfile(testCase.RootFolder,"SoftwareTests","PostFiles",PostFile); 153 | if ~isfolder(fullfile(testCase.RootFolder,"SoftwareTests/PostFiles")) 154 | mkdir(fullfile(testCase.RootFolder,"SoftwareTests/PostFiles")) 155 | end 156 | if ~isfile(PostFilePath) 157 | writelines("% Post-run script for "+Filename,PostFilePath) 158 | writelines("% ---- Post-run commands -----",PostFilePath,'WriteMode','append'); 159 | writelines(" ",PostFilePath,'WriteMode','append'); 160 | end 161 | Path = PostFilePath; 162 | end 163 | 164 | end % Private Access Methods 165 | 166 | end % SolnSmokeTests 167 | -------------------------------------------------------------------------------- /SoftwareTests/TestResults_R2023b.txt: -------------------------------------------------------------------------------- 1 | Version,File,Status,ElapsedTime 2 | R2023b,CommentingCode.mlx,passed,1.875415e+00 3 | R2023b,Debugging.mlx,passed,5.075684e-01 4 | R2023b,Functions.mlx,passed,2.872010e+01 5 | R2023b,SharingCode.mlx,passed,3.768991e-01 6 | -------------------------------------------------------------------------------- /StructuringCode.prj: -------------------------------------------------------------------------------- 1 | 2 | 3 | -------------------------------------------------------------------------------- /Utilities/OldVersions/MainMenuOld.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Utilities/OldVersions/MainMenuOld.mlx -------------------------------------------------------------------------------- /Utilities/OldVersions/READMEOld.mlx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Utilities/OldVersions/READMEOld.mlx -------------------------------------------------------------------------------- /Utilities/ProjectShutdown.m: -------------------------------------------------------------------------------- 1 | function ProjectShutdown 2 | % Reset module to original state that is expected when loading in a new 3 | % MATLAB version. 4 | proj = currentProject; 5 | if isMATLABReleaseOlderThan("R2023b") 6 | cd(proj.RootFolder) 7 | try 8 | if exist(fullfile("Utilities","OldVersions","MainMenuNew.mlx"),"file") 9 | movefile("MainMenu.mlx", fullfile("Utilities","OldVersions","MainMenuOld.mlx")) 10 | movefile(fullfile("Utilities","OldVersions","MainMenuNew.mlx"),fullfile(proj.RootFolder,"MainMenu.mlx")) 11 | end 12 | catch 13 | disp("Failed to move MainMenu.mlx.") 14 | end 15 | try 16 | if exist(fullfile("Utilities","OldVersions","READMENew.mlx"),"file") 17 | movefile("README.mlx", fullfile("Utilities","OldVersions","READMEOld.mlx")) 18 | movefile(fullfile("Utilities","OldVersions","READMENew.mlx"),fullfile(proj.RootFolder,"README.mlx")) 19 | end 20 | catch 21 | disp("Failed to move README.mlx.") 22 | end 23 | end 24 | end -------------------------------------------------------------------------------- /Utilities/ProjectStartup.m: -------------------------------------------------------------------------------- 1 | function ProjectStartup 2 | % Set up check for version number 3 | proj = currentProject; 4 | if isMATLABReleaseOlderThan("R2023b") 5 | cd(proj.RootFolder) 6 | try 7 | if exist(fullfile("Utilities","OldVersions","MainMenuOld.mlx"),"file") 8 | movefile("MainMenu.mlx", fullfile("Utilities","OldVersions","MainMenuNew.mlx")) 9 | movefile(fullfile("Utilities","OldVersions","MainMenuOld.mlx"),fullfile(proj.RootFolder,"MainMenu.mlx")) 10 | end 11 | catch 12 | disp("Failed to move MainMenu.mlx.") 13 | end 14 | try 15 | if exist(fullfile("Utilities","OldVersions","READMEOld.mlx"),"file") 16 | movefile("README.mlx", fullfile("Utilities","OldVersions","READMENew.mlx")) 17 | movefile(fullfile("Utilities","OldVersions","READMEOld.mlx"),fullfile(proj.RootFolder,"README.mlx")) 18 | end 19 | catch 20 | disp("Failed to move README.mlx.") 21 | end 22 | end 23 | ProjectStartupApp 24 | end -------------------------------------------------------------------------------- /Utilities/ProjectStartupApp.m: -------------------------------------------------------------------------------- 1 | classdef ProjectStartupApp < matlab.apps.AppBase 2 | 3 | % Properties that correspond to app components 4 | properties (Access = public) 5 | StartUpAppUIFigure matlab.ui.Figure 6 | TabGroup matlab.ui.container.TabGroup 7 | WelcomeTab matlab.ui.container.Tab 8 | Image matlab.ui.control.Image 9 | READMEButton matlab.ui.control.Button 10 | ReviewUsButton matlab.ui.control.Button 11 | MainMenuButton matlab.ui.control.Button 12 | WelcomeTitle matlab.ui.control.Label 13 | TabReview matlab.ui.container.Tab 14 | OtherButton matlab.ui.control.Button 15 | StudentButton matlab.ui.control.Button 16 | FacultyButton matlab.ui.control.Button 17 | Q1 matlab.ui.control.Label 18 | ReviewTitle matlab.ui.control.Label 19 | ReviewText matlab.ui.control.Label 20 | end 21 | 22 | 23 | properties (Access = private) 24 | GitHubOrganization = "MathWorks-Teaching-Resources"; % Description 25 | GitHubRepository = "Programming-Structuring-Code"; 26 | end 27 | %% How to customize the app? 28 | %{ 29 | 30 | This StartUp app is designed to be customized to your module. It 31 | requires a minimum number of customization: 32 | 33 | 1. Change "Module Template" in app.WelcomeTitle by your module name 34 | 2. Change "Module Template" in app.ReviewTitle by your module name 35 | 3. Change the GitHubRepository (line 25) to the correct value 36 | 4. Change image in app.Image by the cover image you would like for your 37 | module. This image should be located in rootFolder/Images 38 | 5. Create your MS Form: 39 | a. Make a copy of the Faculty and the Student Template surveys 40 | b. Customize the name of the survey to match the name of your 41 | survey 42 | c. Click on "Collect responses", select "Anyone can respond" and 43 | copy the form link to SetupAppLinks (see step 6). 44 | 5. Create your MS Sway: 45 | a. Go to MS Sway 46 | b. Create a blank sway 47 | c. Add the name of your module to the title box 48 | d. Click "Share", Select "Anyone with a link", Select "View" 49 | e. Copy the sway link to SetupAppLinks (see step 6). 50 | 6. Add the Survey and Sway link to Utilities/SurveyLinks using 51 | SetupAppLinks.mlx in InternalFiles/RequiredFunctions/StartUpFcn 52 | 7. Save > Export to .m file and save the result as 53 | Utilities/ProjectStartupApp.m 54 | 55 | %} 56 | 57 | methods (Access = private, Static) 58 | 59 | function pingSway(app) 60 | try 61 | if ~ispref("MCCTEAM") 62 | load Utilities\SurveyLinks.mat SwayLink 63 | webread(SwayLink); 64 | end 65 | catch 66 | end 67 | end 68 | 69 | function openStudentForm(app) 70 | try 71 | load Utilities\SurveyLinks.mat StudentFormLink 72 | web(StudentFormLink); 73 | catch 74 | end 75 | end 76 | 77 | function openFacultyForm(app) 78 | try 79 | load Utilities\SurveyLinks.mat FacultyFormLink 80 | web(FacultyFormLink); 81 | catch 82 | end 83 | end 84 | 85 | function saveSettings(isReviewed,numLoad) 86 | try 87 | save(fullfile("Utilities","ProjectSettings.mat"),"isReviewed","numLoad"); 88 | catch 89 | end 90 | end 91 | 92 | end 93 | 94 | 95 | % Callbacks that handle component events 96 | methods (Access = private) 97 | 98 | % Code that executes after component creation 99 | function startupFcn(app) 100 | 101 | % Switch tab to review if has not been reviewed yet 102 | if isfile(fullfile("Utilities","ProjectSettings.mat")) 103 | load(fullfile("Utilities","ProjectSettings.mat"),"isReviewed","numLoad"); 104 | numLoad = numLoad + 1; % Increment counter 105 | else 106 | isReviewed = false; 107 | numLoad = 1; % Initialize counter 108 | end 109 | 110 | % Switch tab for review 111 | if ~isReviewed && numLoad > 2 112 | isReviewed = true; 113 | app.TabGroup.SelectedTab = app.TabReview; 114 | end 115 | 116 | % Save new settings 117 | app.saveSettings(isReviewed,numLoad) 118 | 119 | % Download links to survey (should only work when module goes 120 | % public on GitHub) 121 | try 122 | import matlab.net.* 123 | import matlab.net.http.* 124 | 125 | Request = RequestMessage; 126 | Request.Method = 'GET'; 127 | Address = URI("http://api.github.com/repos/"+app.GitHubOrganization+... 128 | "/"+app.GitHubRepository+"/contents/Utilities/SurveyLinks.mat"); 129 | Request.Header = HeaderField("X-GitHub-Api-Version","2022-11-28"); 130 | Request.Header(2) = HeaderField("Accept","application/vnd.github+json"); 131 | [Answer,~,~] = send(Request,Address); 132 | websave(fullfile("Utilities/SurveyLinks.mat"),Answer.Body.Data.download_url); 133 | catch 134 | end 135 | 136 | end 137 | 138 | % Close request function: StartUpAppUIFigure 139 | function StartUpAppUIFigureCloseRequest(app, event) 140 | if event.Source == app.READMEButton 141 | open README.mlx 142 | elseif event.Source == app.MainMenuButton 143 | open MainMenu.mlx 144 | elseif event.Source == app.FacultyButton 145 | open MainMenu.mlx 146 | elseif event.Source == app.StudentButton 147 | open MainMenu.mlx 148 | elseif event.Source == app.OtherButton 149 | open MainMenu.mlx 150 | else 151 | disp("Thank you for your time.") 152 | end 153 | delete(app) 154 | end 155 | 156 | % Button pushed function: MainMenuButton 157 | function MainMenuButtonPushed(app, event) 158 | StartUpAppUIFigureCloseRequest(app,event) 159 | end 160 | 161 | % Button pushed function: FacultyButton 162 | function FacultyButtonPushed(app, event) 163 | app.pingSway; 164 | app.openFacultyForm; 165 | StartUpAppUIFigureCloseRequest(app,event) 166 | end 167 | 168 | % Button pushed function: StudentButton 169 | function StudentButtonPushed(app, event) 170 | app.pingSway; 171 | app.openStudentForm; 172 | StartUpAppUIFigureCloseRequest(app,event) 173 | end 174 | 175 | % Button pushed function: OtherButton 176 | function OtherButtonPushed(app, event) 177 | app.pingSway; 178 | app.openStudentForm; 179 | StartUpAppUIFigureCloseRequest(app,event) 180 | end 181 | 182 | % Button pushed function: ReviewUsButton 183 | function ReviewUsButtonPushed(app, event) 184 | app.TabGroup.SelectedTab = app.TabReview; 185 | end 186 | 187 | % Button pushed function: READMEButton 188 | function READMEButtonPushed(app, event) 189 | StartUpAppUIFigureCloseRequest(app,event) 190 | end 191 | end 192 | 193 | % Component initialization 194 | methods (Access = private) 195 | 196 | % Create UIFigure and components 197 | function createComponents(app) 198 | 199 | % Create StartUpAppUIFigure and hide until all components are created 200 | app.StartUpAppUIFigure = uifigure('Visible', 'off'); 201 | app.StartUpAppUIFigure.AutoResizeChildren = 'off'; 202 | app.StartUpAppUIFigure.Position = [100 100 276 430]; 203 | app.StartUpAppUIFigure.Name = 'StartUp App'; 204 | app.StartUpAppUIFigure.Resize = 'off'; 205 | app.StartUpAppUIFigure.CloseRequestFcn = createCallbackFcn(app, @StartUpAppUIFigureCloseRequest, true); 206 | 207 | % Create TabGroup 208 | app.TabGroup = uitabgroup(app.StartUpAppUIFigure); 209 | app.TabGroup.AutoResizeChildren = 'off'; 210 | app.TabGroup.Position = [1 1 276 460]; 211 | 212 | % Create WelcomeTab 213 | app.WelcomeTab = uitab(app.TabGroup); 214 | app.WelcomeTab.AutoResizeChildren = 'off'; 215 | app.WelcomeTab.Title = 'Tab'; 216 | 217 | % Create WelcomeTitle 218 | app.WelcomeTitle = uilabel(app.WelcomeTab); 219 | app.WelcomeTitle.HorizontalAlignment = 'center'; 220 | app.WelcomeTitle.VerticalAlignment = 'top'; 221 | app.WelcomeTitle.WordWrap = 'on'; 222 | app.WelcomeTitle.FontSize = 24; 223 | app.WelcomeTitle.FontWeight = 'bold'; 224 | app.WelcomeTitle.Position = [2 349 274 70]; 225 | app.WelcomeTitle.Text = 'Programming: Structuring Code'; 226 | 227 | % Create MainMenuButton 228 | app.MainMenuButton = uibutton(app.WelcomeTab, 'push'); 229 | app.MainMenuButton.ButtonPushedFcn = createCallbackFcn(app, @MainMenuButtonPushed, true); 230 | app.MainMenuButton.FontSize = 18; 231 | app.MainMenuButton.Position = [59 96 161 35]; 232 | app.MainMenuButton.Text = 'Main Menu'; 233 | 234 | % Create ReviewUsButton 235 | app.ReviewUsButton = uibutton(app.WelcomeTab, 'push'); 236 | app.ReviewUsButton.ButtonPushedFcn = createCallbackFcn(app, @ReviewUsButtonPushed, true); 237 | app.ReviewUsButton.FontSize = 18; 238 | app.ReviewUsButton.Position = [59 10 161 35]; 239 | app.ReviewUsButton.Text = 'Review Us'; 240 | 241 | % Create READMEButton 242 | app.READMEButton = uibutton(app.WelcomeTab, 'push'); 243 | app.READMEButton.ButtonPushedFcn = createCallbackFcn(app, @READMEButtonPushed, true); 244 | app.READMEButton.FontSize = 18; 245 | app.READMEButton.Position = [59 53 161 35]; 246 | app.READMEButton.Text = 'README'; 247 | 248 | % Create Image 249 | app.Image = uiimage(app.WelcomeTab); 250 | app.Image.Position = [16 141 245 209]; 251 | app.Image.ImageSource = 'TurkeysColor.png'; 252 | 253 | % Create TabReview 254 | app.TabReview = uitab(app.TabGroup); 255 | app.TabReview.AutoResizeChildren = 'off'; 256 | app.TabReview.Title = 'Tab2'; 257 | app.TabReview.HandleVisibility = 'off'; 258 | 259 | % Create ReviewText 260 | app.ReviewText = uilabel(app.TabReview); 261 | app.ReviewText.HorizontalAlignment = 'center'; 262 | app.ReviewText.VerticalAlignment = 'top'; 263 | app.ReviewText.WordWrap = 'on'; 264 | app.ReviewText.FontSize = 18; 265 | app.ReviewText.Position = [16 243 245 69]; 266 | app.ReviewText.Text = 'Please help us improve your experience by answering a few questions.'; 267 | 268 | % Create ReviewTitle 269 | app.ReviewTitle = uilabel(app.TabReview); 270 | app.ReviewTitle.HorizontalAlignment = 'center'; 271 | app.ReviewTitle.VerticalAlignment = 'top'; 272 | app.ReviewTitle.WordWrap = 'on'; 273 | app.ReviewTitle.FontSize = 24; 274 | app.ReviewTitle.FontWeight = 'bold'; 275 | app.ReviewTitle.Position = [2 326 274 93]; 276 | app.ReviewTitle.Text = 'Programming: Structuring Code'; 277 | 278 | % Create Q1 279 | app.Q1 = uilabel(app.TabReview); 280 | app.Q1.HorizontalAlignment = 'center'; 281 | app.Q1.VerticalAlignment = 'top'; 282 | app.Q1.WordWrap = 'on'; 283 | app.Q1.FontSize = 18; 284 | app.Q1.FontWeight = 'bold'; 285 | app.Q1.Position = [16 141 245 69]; 286 | app.Q1.Text = 'What describes you best?'; 287 | 288 | % Create FacultyButton 289 | app.FacultyButton = uibutton(app.TabReview, 'push'); 290 | app.FacultyButton.ButtonPushedFcn = createCallbackFcn(app, @FacultyButtonPushed, true); 291 | app.FacultyButton.FontSize = 18; 292 | app.FacultyButton.Position = [64 127 150 40]; 293 | app.FacultyButton.Text = 'Faculty'; 294 | 295 | % Create StudentButton 296 | app.StudentButton = uibutton(app.TabReview, 'push'); 297 | app.StudentButton.ButtonPushedFcn = createCallbackFcn(app, @StudentButtonPushed, true); 298 | app.StudentButton.FontSize = 18; 299 | app.StudentButton.Position = [64 80 150 40]; 300 | app.StudentButton.Text = 'Student'; 301 | 302 | % Create OtherButton 303 | app.OtherButton = uibutton(app.TabReview, 'push'); 304 | app.OtherButton.ButtonPushedFcn = createCallbackFcn(app, @OtherButtonPushed, true); 305 | app.OtherButton.FontSize = 18; 306 | app.OtherButton.Position = [64 34 150 40]; 307 | app.OtherButton.Text = 'Other'; 308 | 309 | % Show the figure after all components are created 310 | app.StartUpAppUIFigure.Visible = 'on'; 311 | end 312 | end 313 | 314 | % App creation and deletion 315 | methods (Access = public) 316 | 317 | % Construct app 318 | function app = ProjectStartupApp 319 | 320 | % Create UIFigure and components 321 | createComponents(app) 322 | 323 | % Register the app with App Designer 324 | registerApp(app, app.StartUpAppUIFigure) 325 | 326 | % Execute the startup function 327 | runStartupFcn(app, @startupFcn) 328 | 329 | if nargout == 0 330 | clear app 331 | end 332 | end 333 | 334 | % Code that executes before app deletion 335 | function delete(app) 336 | 337 | % Delete UIFigure when app is deleted 338 | delete(app.StartUpAppUIFigure) 339 | end 340 | end 341 | end -------------------------------------------------------------------------------- /Utilities/README.m: -------------------------------------------------------------------------------- 1 | %[text] %[text:anchor:DEF03274] # Modular Courseware \- Utilities 2 | %[text] %[text:anchor:AB19903A] ## Set Modular Courseware Development Environment 3 | SetPath; %[control:button:1377]{"position":[1,2]} 4 | %% 5 | UnsetPath; %[control:button:98c3]{"position":[1,2]} 6 | %% 7 | %[text] ## Status Update 8 | %[text] - 8/10/23: Move images to [https://insidelabs\-git.mathworks.com/modular\-curriculum\-content/shared\-team\-resources](https://insidelabs-git.mathworks.com/modular-curriculum-content/shared-team-resources) 9 | %[text] - 7/25/23: Move template to [https://insidelabs\-git.mathworks.com/modular\-curriculum\-content/module\-template](https://insidelabs-git.mathworks.com/modular-curriculum-content/module-template) 10 | %[text] - 7/25/23: Re\-organize the repository format \ 11 | %[text] 12 | %[text] ## Tools Overwiew 13 | %[text] Need to add decription to every tool 14 | %[text] - **CheckDisplayStyle.mlx** \- use this to check for hidden code/code inline 15 | %[text] - **ClearOutput.mlx** \- use this to clear the output of a live script 16 | %[text] - **isDesktop.m** \- include this in modules if there is a need to determine where the repository is being run 17 | %[text] - **normalizeFigmaSVG.m** \- use this to get an image by id from the MathWorks Icon repository 18 | %[text] - **ResetProjectSettings.mlx** \- deprecated, shouldn't be necessary. Use this to set project views to `0` and reviewed to `false` 19 | %[text] - **SwitchDisplayStyle.mlx** \- use this to switch between hidden code and code inline \ 20 | %[text] 21 | %[text] ## Testing Resources 22 | %[text] ### HelperFunctions 23 | %[text] These functions are called by `testLinksImages.m` 24 | %[text] - **checkHyperlinks.m** \- do all the hyperlinks in a live script resolve without errors? 25 | %[text] - **checkImages.m** \- do all the images in a live script have developer\-designed alt\-text? 26 | %[text] - **idFile.m** \- identify the final Folder/Scriptname of the file currently being run \ 27 | %[text] ### TestFiles 28 | %[text] These are object oriented MATLAB testing files 29 | %[text] - **testLinksImages.m** \- contains two tests: one for hyperlinks and one for alt\-text \ 30 | %[text] ### **TestRunners** 31 | %[text] These are scripts that act as runners for TestFiles tests. 32 | %[text] - **runCMTests.m** \ 33 | %[text] `runCMTests` is intented to organize the running of immediately\-prior\-to\-release tests of hyperlinks and the existence of alt\-text in the .mlx files in a curriculum module. 34 | %[text] 35 | %[text] ## **Sandbox** 36 | %[text] - **HyperlinkUpdater** \ 37 | %[text] A set of sample scripts designed to allow updating textual elements (e.g. hyperlinks) in .mlx files 38 | %[text] - **urlEncoder.mlx** \ 39 | %[text] A sample attempt at generating mailto: links. Live tests did not work well in the wild. Be careful with this one. 40 | %% 41 | function SetPath 42 | Path = fileparts(matlab.desktop.editor.getActiveFilename); 43 | addpath(fullfile(Path,"Tools")); 44 | addpath(genpath(fullfile(Path,"TestingResources"))); 45 | savepath; 46 | setpref("MCCTEAM","Developer",true) 47 | end 48 | 49 | function UnsetPath 50 | Path = fileparts(matlab.desktop.editor.getActiveFilename); 51 | rmpath(fullfile(Path,"Tools")); 52 | rmpath(genpath(fullfile(Path,"TestingResources"))); 53 | savepath; 54 | rmpref("MCCTEAM") 55 | end 56 | 57 | %[appendix] 58 | %--- 59 | %[metadata:view] 60 | % data: {"layout":"inline","rightPanelPercent":40} 61 | %--- 62 | %[control:button:1377] 63 | % data: {"label":"Add Tools to path","run":"Section"} 64 | %--- 65 | %[control:button:98c3] 66 | % data: {"label":"Remove Tools from path","run":"Section"} 67 | %--- 68 | -------------------------------------------------------------------------------- /Utilities/SurveyLinks.mat: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MathWorks-Teaching-Resources/Programming-Structuring-Code/b587696e74e53713255b6b38a05cee45ac591fc0/Utilities/SurveyLinks.mat -------------------------------------------------------------------------------- /resources/project/6xhH2l9GP9loT6TdFn_Mo65sDHg/P8PSrqcBHMbGhqD2r1d9oc0h3TUd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/6xhH2l9GP9loT6TdFn_Mo65sDHg/P8PSrqcBHMbGhqD2r1d9oc0h3TUp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/8h3kimKoV3g5SPdcFPq6bNqde20/oBwspwaqrZC_Fmyb5wKi13xkOrMd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/8h3kimKoV3g5SPdcFPq6bNqde20/oBwspwaqrZC_Fmyb5wKi13xkOrMp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/8h3kimKoV3g5SPdcFPq6bNqde20/yvc00et_D9w1RZcV5T2-bniDUu0d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/8h3kimKoV3g5SPdcFPq6bNqde20/yvc00et_D9w1RZcV5T2-bniDUu0p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/BT5hWoz-UTefONdqForZyI91O8Y/Ur1esh7xN9L6aqDUKBE31DKE1Qod.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/BT5hWoz-UTefONdqForZyI91O8Y/Ur1esh7xN9L6aqDUKBE31DKE1Qop.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/BjxNC43HIPP8KZwg_cceb68ikkA/dxW0rLxFMXm0cpQGCSkWQRi2YRsd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/BjxNC43HIPP8KZwg_cceb68ikkA/dxW0rLxFMXm0cpQGCSkWQRi2YRsp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/-upqjogKesBp3DwJRlG6KjrKvd4d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/-upqjogKesBp3DwJRlG6KjrKvd4p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/2vfmNT5dFMoKB5FDZBSr3ouDAL8d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/2vfmNT5dFMoKB5FDZBSr3ouDAL8p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/CimN6b3haEs9ki1jBr6eTHKXzIAd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/CimN6b3haEs9ki1jBr6eTHKXzIAp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/DxJWFQ6s-5tgLo-3uCpCdq16n-sd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/DxJWFQ6s-5tgLo-3uCpCdq16n-sp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/cn2Ee7NifKI7ffnw_Fjz5lrC1Qgd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/cn2Ee7NifKI7ffnw_Fjz5lrC1Qgp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/e7wCov_BYJUY6VsFZYx5ab3064gd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/EEtUlUb-dLAdf0KpMVivaUlztwA/e7wCov_BYJUY6VsFZYx5ab3064gp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/HoHDHQ_WvHAAKj5aJOrvrg_vpt8/xXlmKuOQ7YT_G1elNhbKQIUqSRMd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/HoHDHQ_WvHAAKj5aJOrvrg_vpt8/xXlmKuOQ7YT_G1elNhbKQIUqSRMp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/KAXfQgCar2Yb8zOxgvf9hdmLP1E/hvrnRHN01wxA3RHB4Yx9vil4O6Qd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | -------------------------------------------------------------------------------- /resources/project/KAXfQgCar2Yb8zOxgvf9hdmLP1E/hvrnRHN01wxA3RHB4Yx9vil4O6Qp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/KAXfQgCar2Yb8zOxgvf9hdmLP1E/xcK8fO1pjra5DR0jot5vrzlBV84d.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | -------------------------------------------------------------------------------- /resources/project/KAXfQgCar2Yb8zOxgvf9hdmLP1E/xcK8fO1pjra5DR0jot5vrzlBV84p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/2kj09UetkV_lru3gvSPXnY6-nM4d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/2kj09UetkV_lru3gvSPXnY6-nM4p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/KKyDJtbdIBOlaeHmIZd5VX6vqx8d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/KKyDJtbdIBOlaeHmIZd5VX6vqx8p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/QWNDYJD5mGW1bWYvPx9DtKnxzw4d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/QWNDYJD5mGW1bWYvPx9DtKnxzw4p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/R1RggVhA72agIvELiuhWPRS8F0Id.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/R1RggVhA72agIvELiuhWPRS8F0Ip.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/aEHSZBIY-yve10yGis12Zr5DLZod.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/aEHSZBIY-yve10yGis12Zr5DLZop.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/j4xwF_j8iFTVayUMfxLgMnTbencd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/j4xwF_j8iFTVayUMfxLgMnTbencp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/r8LR4nLmg9ai3oHrW1r_-KocQzkd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/NjSPEMsIuLUyIpr2u1Js5bVPsOs/r8LR4nLmg9ai3oHrW1r_-KocQzkp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/Project.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/VscVJQot7IndoRi0xm0fbAitS2Y/IN5Gw9hRs23W3dqBCLEXwjctJ1Id.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/VscVJQot7IndoRi0xm0fbAitS2Y/IN5Gw9hRs23W3dqBCLEXwjctJ1Ip.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/ZN2RlSIbyWXhOxbxxI4hOawbMD4/p5HYYVUpTuYgZwnT8QkkzaoJraUd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/ZN2RlSIbyWXhOxbxxI4hOawbMD4/p5HYYVUpTuYgZwnT8QkkzaoJraUp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/ZN2RlSIbyWXhOxbxxI4hOawbMD4/q4FWbcu8zEbneDjWzNwfvfvjQNAd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/ZN2RlSIbyWXhOxbxxI4hOawbMD4/q4FWbcu8zEbneDjWzNwfvfvjQNAp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/ZN2RlSIbyWXhOxbxxI4hOawbMD4/s-04wUzHjOhlMa1CW_zpJwm8iDMd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/ZN2RlSIbyWXhOxbxxI4hOawbMD4/s-04wUzHjOhlMa1CW_zpJwm8iDMp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/fjRQtWiSIy7hIlj-Kmk87M7s21k/NjSPEMsIuLUyIpr2u1Js5bVPsOsd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/fjRQtWiSIy7hIlj-Kmk87M7s21k/NjSPEMsIuLUyIpr2u1Js5bVPsOsp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/RMvf4mEDuznAOqU6SKNmIWErfxgd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/RMvf4mEDuznAOqU6SKNmIWErfxgp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/ZTr3GAe6p03ZVs2FdKKE0JsiFMQd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/ZTr3GAe6p03ZVs2FdKKE0JsiFMQp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/nGmc4yUWSwVpS8w8tP7IolwQs0Ed.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/nGmc4yUWSwVpS8w8tP7IolwQs0Ep.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/uIbyU9dPEHKvxjdwx5pD9PDDCZYd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/iMwdHOXOBiBXhnA_li8gtEJVTjc/uIbyU9dPEHKvxjdwx5pD9PDDCZYp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/8h3kimKoV3g5SPdcFPq6bNqde20d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/8h3kimKoV3g5SPdcFPq6bNqde20p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/BT5hWoz-UTefONdqForZyI91O8Yd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/BT5hWoz-UTefONdqForZyI91O8Yp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/BjxNC43HIPP8KZwg_cceb68ikkAd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/BjxNC43HIPP8KZwg_cceb68ikkAp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/KocSmEw1PpelhlG7ZNeMUdHVtywd.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/KocSmEw1PpelhlG7ZNeMUdHVtywp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/VscVJQot7IndoRi0xm0fbAitS2Yd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/VscVJQot7IndoRi0xm0fbAitS2Yp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/ZN2RlSIbyWXhOxbxxI4hOawbMD4d.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/ZN2RlSIbyWXhOxbxxI4hOawbMD4p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/iMwdHOXOBiBXhnA_li8gtEJVTjcd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/iMwdHOXOBiBXhnA_li8gtEJVTjcp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/rnpMu7jn2QWt_rQcz8FJ-MxGzVId.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /resources/project/qaw0eS1zuuY1ar9TdPn1GMfrjbQ/rnpMu7jn2QWt_rQcz8FJ-MxGzVIp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/6x1BhZX_fLnKpcwqra0qFwv1jIgp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/6xhH2l9GP9loT6TdFn_Mo65sDHgp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/EEtUlUb-dLAdf0KpMVivaUlztwAp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/GiiBklLgTxteCEmomM8RCvWT0nQd.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/GiiBklLgTxteCEmomM8RCvWT0nQp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/HoHDHQ_WvHAAKj5aJOrvrg_vpt8p.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/KAXfQgCar2Yb8zOxgvf9hdmLP1Ep.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/NmGqIpAwUJcXFyLjFAGnU9uyN5Yp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/WZRuNzqc-Db7NcQAZO8Y-R8U9ccp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/fjRQtWiSIy7hIlj-Kmk87M7s21kp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/root/qaw0eS1zuuY1ar9TdPn1GMfrjbQp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/rootp.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/uuid-0b5f2aef-2281-4e2e-965e-7bb924d26344.xml: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /resources/project/uuid-366ca619-578a-4bc0-8012-bfa62d28c37f.xml: -------------------------------------------------------------------------------- 1 | 2 | --------------------------------------------------------------------------------