feat(developer): kmc-copy

[mcdurdin]

Fixes: #2264.

Basic functionality for cloning and renaming a keyboard project with the kmc copy command. Many TODO-COPY items are resolved in #12586. Others to come.

Note: TODO list moved to #12641.

User Testing

• Install Keyman Developer

• Open a command prompt

• TEST_COPY_KEYBOARDS: Try to copy an existing keyboard project with the kmc copy command: kmc copy <source-project.kpj> -o <destination-folder>, e.g. kmc copy keyboards/release/k/khmer_angkor -o c:\temp\my_first_cambodian_keyboard. Do this with a few different keyboards. Verify that the copy and rename worked by building the new keyboards and verify that they build. Verify that the filenames are as expected in the new keyboards.

• TEST_COPY_MODELS: Try to copy an existing lexical model project with the kmc copy command: kmc copy <source-project.kpj> -o <destination-folder>, e.g. kmc copy lexical-models/release/sil/sil.km.cnd -o c:\temp\mydict.km.cambodian. Do this with a few different lexical models. Verify that the copy and rename worked by building the new models and verify that they build. Verify that the filenames are as expected in the new models.

[keymanapp-test-bot[bot]]

User Test Results

Test specification and instructions

• ✅ TEST_COPY_KEYBOARDS (PASSED) (notes)
• ✅ TEST_COPY_MODELS (PASSED) (notes)

Test Artifacts

• Android
  • Keyman for Android apk
  • FirstVoices for Android 16.0 apk
  • FirstVoices Keyboards for Android apk
  • KeyboardHarness apk
  • Keyman for Android 16.0 apk
  • KMSample1 apk
  • KMSample2 apk
• Developer
  • Keyman Developer
  • Compiler Regression Tests
  • kmcomp.zip
• iOS
  • Keyman for iOS (simulator image)
  • FirstVoices Keyboards for iOS (simulator image)
  • TestFlight internal PR build version - 18.0.127 (0.12555.12180)
• Keyboards
  • Test Keyboards
• Web
  • KeymanWeb Test Home
• Windows
  • Keyman for Windows
  • FirstVoices Keyboards for Windows
  • Text Editor (32 bit)
  • Text Editor (64 bit)

[dinakaranr]

Test Results

I tested this issue with the attached "18.0.127-alpha-test-12555" build on the Windows 10 and 11 OS. Here is my observation.

• TEST_COPY_KEYBOARDS (Passed):

  1. I installed the keymandeveloper-18.0.127.exe build in the Windows 10.
  2. Navigate to the folder path that has GitHub's keyboard.
  3. Open the command prompt.
  4. Enter the below command in the window's prompt

  5. kmc copy C:Users\Bharani\Documents\GitHub\keyboards\release\gautami\gautami_thamizh_tamil\gautami_thamizh_tamil.kpj -o C:\Users\Bharani\AppData\Local\Temp\KMCTesting1

  6. kmc copy C:\Users\Bharani\Documents\GitHub\keyboards\release\gautami\gautami_thamizh_tamil -o C:\Users\Bharani\Downloads\KMCTesting3

  7. Verified that the keyboard folder or *.kpj file was copied into a new folder.
  8. Verified that the keyboard file was renamed in the new folder.

• TEST_COPY_MODELS (Passed):

  1. I installed the keymandeveloper-18.0.127.exe build in the Windows 10.
  2. Navigate to the folder path that has GitHub's keyboard(lexical-models).
  3. Open the command prompt.
  4. Enter the below command in the window's prompt

  5. kmc copy C:\Users\Bharani\Documents\GitHub\lexical-models\release\sil\sil.cmo.bw -o D:\Dinakaran_Files\TestingKeyboard\LexicalModelKMCTesting1

  6. lexical-models

  7. kmc copy C:\Users\Bharani\Documents\GitHub\lexical-models\release\sil\sil.cmo.bw\sil.cmo.bw.kpj -o D:\Dinakaran_Files\TestingKeyboard\LexicalModelKMCTesting

  8. Verified that the keyboard folder or *.kpj file was copied into a new folder.
  9. Verified that the keyboard file was renamed in the new folder. It works well. Thanks.

• I observed two things for copying files.

• I created a folder in the Temp folder and then tried to copy a keyboard file.

• Here, the folder "already exists, not overwriting" message appears on the command prompt.

• I created a folder in the "Download" folder and then tried to copy a keyboard *.kmp file.

• Here, folder "Could not find project file" message appears on the command prompt. Please refer to the attached screenshot

  

[keyman-server]

Changes in this pull request will be available for download in Keyman version 18.0.138-alpha