More Bugfixes!

Upgrading

Windows

Download and run the appropriate installer.

Notes

• You may be stopped by Windows SmartScreen when running the installer. This is expected, and we are working to resolve this issue. In the meantime, click "more info" and "run anyway" (if your system is set to block unknown apps and programs, you'll have to change the SmartScreen settings to "warn" or disable checking entirely [which we don't recommend]).

MacOS

Run brew update && brew upgrade pros-cli

Linux / pip installs

Run pip install --upgrade pros-cli

Changes:

• fcb3094 🐛Fixes CLI hanging in commands calling 'make.exe' (#180)
• cb3024f remove rfc6266-parser (#182)
• 406f818 Add pool for Publish Artifact (#179)
• affc30e Update azure-pipelines.yml for Azure Pipelines (#178)
• f0c6992 Fix outdated Ubuntu and Windows VM Image for CI (#177)
• 551e793 🐛Fixes --run-after flag priority issues. (#173)
• b122cce Update conductor.py (#172)

Here Comes VSC

Changes

This update should fix some bugs for the upcoming VSC Extension.

Upgrading

Windows

Download and run the appropriate installer.

Notes

• You may be stopped by Windows SmartScreen when running the installer. This is expected, and we are working to resolve this issue. In the meantime, click "more info" and "run anyway" (if your system is set to block unknown apps and programs, you'll have to change the SmartScreen settings to "warn" or disable checking entirely [which we don't recommend]).

MacOS

Run brew update && brew upgrade pros-cli

Linux / pip installs

Run pip install --upgrade pros-cli

Bugfixes:

• 🐛 Fix the limit flag for template querying (#164)
• 🚸 Changed IDEs in Warning Message (#165)
• 🚸 Fix VSC Error (#166)

3.2.1 - 😳 Bugfixes for 3.2.0 🐛

Changes:

This update should fix many of the issues introduced in the last release. Wireless uploading/terminal is now functioning normally. Windows Installers have also been remade and should not have any environment variable issues.

Upgrading

Windows

Download and run the appropriate installer.

Notes

• You may be stopped by Windows SmartScreen when running the installer. This is expected, and we are working to resolve this issue. In the meantime, click "more info" and "run anyway" (if your system is set to block unknown apps and programs, you'll have to change the SmartScreen settings to "warn" or disable checking entirely [which we don't recommend]).
• If you applied the workaround detailed in the release notes for 3.2.0 (adding an entry to the PATH environment variable), you can go ahead and remove it if you wish.

MacOS

Run brew update && brew upgrade pros-cli

Linux / pip installs

Run pip install --upgrade pros-cli

Bugfixes:

• #151 - wireless terminal doesn't exit on keyboard interrupt
• #153 - sentry_sdk modules missing in frozen distribution
• #154 - wireless uploading doesn't work

3.2.0 - 📶🖥 Wireless Terminal!

At long last! the PROS CLI release 2+ years in the making

Important: in order to use PROS with vexOS 1.0.13, you MUST upgrade to this version!

This release has a number of long-awaited features, not least of which is official support for the wireless terminal. Another notable change is that you can now (again) use the pros command to refer to the CLI! For those of you who have committed prosv5 to muscle memory over the last few years---don't worry, that command still exists.

We are also pleased to announce that pros-cli is back on PyPi! Anyone who installed through pip should be able to run pip install --upgrade pros-cli and get this release.

A number of other miscellaneous bugfixes and improvements were added, so feel free to browse the full changelog below.

Special thanks to @3038922, @Sleuth56, @vexcat, @Bottersnike, and @Trimbell for their contributions!

Known Issues (please read this section before upgrading!)

All Platforms

• There is currently a bug related to uploading projects wirelessly (i.e. through a controller) to a brain with the latest firmware. We’re working on a fix and will post another release as soon as we have it.

Windows

If you upgraded PROS at any point between 2:30AM and 3:00PM on March 19 2021, you likely ran into various problems including (but not necessarily limited to):

• missing start menu shortcut to the PROS Editor
• unable to run CLI commands due to a missing module
• cquery unable to start in the Editor

These are resolved in the latest version of the installer (3.2.0.1), so please use that to upgrade. You will likely have to uninstall PROS completely before running the new one. Anyone upgrading from 3.1.4 after 3:00PM EDT on March 19 2021 will NOT need to uninstall PROS first.

We've been getting reports from some users that files are missing after running the installer. So far we've seen errors including

this one when running the CLI at all (click to reveal error)

Python path configuration:
  PYTHONHOME = (not set)
  PYTHONPATH = (not set)
  program name = 'C:\Program Files\PROS\cli\pros.exe'
  isolated = 0
  environment = 0
  user site = 1
  import site = 0
  sys._base_executable = 'C:\Program Files\PROS\cli\pros.exe'
  sys.base_prefix = ''
  sys.base_exec_prefix = ''
  sys.platlibdir = 'lib'
  sys.executable = 'C:\Program Files\PROS\cli\pros.exe'
  sys.prefix = ''
  sys.exec_prefix = ''
  sys.path = [
    'C:\Program Files\PROS\cli\lib\library.zip',
    'C:\Program Files\PROS\cli\lib',
  ]
Fatal Python error: init_fs_encoding: failed to get the Python codec of the filesystem encoding
Python runtime state: core initialized
ModuleNotFoundError: No module named 'encodings'

this one when attempting to build a project (click to reveal error)

ERROR - pros.cli.main:main - [WinError 2] The system cannot find the file specified
  File "C:\Python38\lib\subprocess.py", line 1307, in _execute_child
    hp, ht, pid, tid = _winapi.CreateProcess(executable, args,
FileNotFoundError: [WinError 2] The system cannot find the file specified

To fix either of these errors, run the installer again in "repair" mode. You can verify this has worked by checking the path %PROS_TOOLCHAIN%\bin for the presence of a program called make. Following this, you will likely run into problems that can be resolved by applying the workaround from my first update above.

If you (still) are unable to build projects, please add %PROS_TOOLCHAIN%\gcc-arm-none-eabi-10-2020-q4-major\bin to your PATH environment variable as a temporary workaround (guide). You will then have to restart any instance of the PROS Editor or command prompt in order for the change to take effect.

MacOS

If you upgraded PROS at any point between 2:30AM and 11:45AM on March 19 2021, you likely ran into an issue relating to a mismatched version of pypng.

This has been resolved in the latest pros-cli homebrew formula, which can be applied by running brew update && brew reinstall pros-cli

Updating to the new version

Python PIP

Run pip install --upgrade pros-cli or simply pip install pros-cli if you are installing for the first time. (or pip3, depending on your system)

Windows

Download and run the appropriate installer (.exe) from below.

macOS

If you have already installed PROS using the recommended method (Homebrew), run brew update, and then run brew upgrade pros-cli.

Otherwise, if you need to install the PROS CLI for the first time, follow the instructions here.

Documentation

See our site for CLI documentation and other handy guides.

Changes:

• 3be1f44 🔖 release version 3.2.0
• ae9f000 🔖 release version 3.2.0
• 44ece6a 🐛 Fix uploading without a project (#116)
• f392dec ✨ Add Wireless Terminal (#119) [ #114 ]
• 32f5668 🚸Schema Length Detection Change (#14)
• 4460a4a 🐛 Get slot from project file (#128)
• 24456c6 🔧 rename dist pros-cli-v5 -> pros-cli (#147)
• 5c6238e 🐛 Fix UnicodeDecodeError in UI (#129) [ #117 ]
• af8c21a 🏗 fix azure pipeline artifact publication (#146)
• 2fb250a 🏗 Try fixing azure pipeline issue (#145)

See More

• 8500c9f Merge pull request #43 from purduesigbots/feature/add-azure-ci-badge
• b61020c Merge pull request #144 from purduesigbots/develop
• a2705e8 Delete .unibeautifyrc.yml
• 06eff31 🐛 Fix channel switch timeout bug when uploading wirelessly (#127)
• ec531ab 🐛 Fix terminal input by calling ConsoleBase setup()/cleanup() (#100)
• b4437e8 Update azure-pipelines.yml for Azure Pipelines (#120)
• 4139dff Update azure-pipelines.yml for Azure Pipelines
• bfe4c9b 🐛 Sort keys of cold hash (#77)
• d7c4779 🐛 Use sys.exit correctly (#85)
• 51a678d Fix user file upgrades (#105)
• 31bf2e5 🐛 Fix bug in screen capture (#109)
• 03b467a Fix broken links in conductor.py (#92) [ #82 ]
• 779d0b5 Fix UsePythonVersion spec to use any 3.6 release (#86)
• dd4f9bd Create .unibeautifyrc.yml
• 6f5e476 add azure status badge

This list of changes was auto generated.

3.1.4 - Interactive UI, Hot/Cold Support, and more

Summary:

• Implement interactive UI (#38)

• Add binary compression to uploaded V5 files (#48)

• Add support for V5 hot/cold linking (#46)

• Add support for V5 screen capture

• Add wireless upload support (#47)

• Bugfixes and improvements to Conductor, V5 upload protocol

3.1.3

Updates and Improvements:

• V5 uploading now goes to program screen after uploading (no more robots falling off tables!)
• Suppress some Sentry reports we were getting but didn't want
• Added a new command user_script to run a Python script with the PROS package available. We can test hotfixes with you using this functionality. If you're interested in automating something that the CLI doesn't support easily, you can use this as well.
• MacOS users should no longer run into the issue where intercept-cc and friends were not found on PATH.
• Added the VCS standalone vision utility to the Homebrew tap. To install, run brew update and then run brew cask install vcs-vision.
• Misc. Improvements not deserving a bullet point

Updating to the new version

Python PIP

Run pip install https://github.com/purduesigbots/pros-cli3/releases/download/3.1.3/pros_cli_v5-3.1.3-py3-none-any.whl (or pip3, depending on your system)

Windows

Download and run the appropriate installer (.exe)

macOS

If you have already installed PROS using the recommended method (Homebrew), run brew update, and then run brew upgrade pros-cli to upgrade the CLI and brew upgrade pros-editor to upgrade the Editor.

Otherwise, if you need to install the PROS CLI, see below for the recommended method of installation.

macOS installs

Follow the instructions here

3.1.2

• Improved logging for debugging
• Added V5 drivers to Windows installers
• Added V5 Vision Utility to Windows Installers

Updating to the new version

Python PIP

Run pip install https://github.com/purduesigbots/pros-cli3/releases/download/3.1.2/pros_cli_v5-3.1.2-py3-none-any.whl (or pip3, depending on your system)

Windows

Download and run the appropriate installer

macOS

See below for the new recommended method of installing the CLI

macOS installs

1. Install Homebrew if it's not already installed. This may take a while.
2. Run brew tap purduesigbots/pros
3. Run brew cask install gcc-arm-embedded pros-editor (if you want to install only the CLI, you can run brew cask install gcc-arm-embedded && brew install pros-cli instead)

Notes:

• if Homebrew complains about some files existing when trying to install the toolchain (gcc-arm-embedded), run rm -f /usr/local/bin/arm-none-eabi-* to clear the old files out
• if you already have the PROS CLI installed, or if Homebrew complains about some files existing when trying to install the CLI, you'll want to uninstall it first
  • if you installed using pip, you can run pip3 uninstall pros-cli-v5
  • if you installed using the .app bundle, you can move that bundle to the trash folder, and then run rm -f /usr/local/bin/prosv5 to clear out the old file

3.1.1

Summary:

• Improve reliability of V5 port detection
• Bugfixes reported by users and Sentry

3.1.0

PROS CLI 3 Initial Release

Features

• Compatible with the VEX V5
• Backwards-compatible with the VEX Cortex

Conductor - project and template management

• Create new projects (prosv5 conduct new)
• Upgrade projects to newer versions of the PROS kernel (prosv5 conduct upgrade)
• Get information about projects (prosv5 conduct info-project)
• Install and uninstall templates to projects (prosv5 conduct install/prosv5 conduct uninstall)
• Query and download remote templates (prosv5 conduct query/prosv5 conduct fetch)
• Backwards-compatible with PROS 2.x projects

General utilities

• List connected VEX devices (prosv5 lsusb)
• Build PROS projects (prosv5 make)
• Open a terminal stream from connected VEX devices (prosv5 terminal)
• Upload PROS binaries to VEX devices (prosv5 upload)

V5 Utilities

• List files on a connected VEX V5's flash filesystem (prosv5 v5 ls-files)
• Remove all user programs from a connected VEX V5 (prosv5 v5 rm-all)
• Remove a specific file from a connected VEX V5's flash filesystem (prosv5 v5 rm-file)
• Start and stop programs on a connected VEX V5 (prosv5 v5 run/prosv5 v5 stop)
• Print system information for a connected VEX V5 (prosv5 v5 status)