Replit C++ Template for Bridges

This is a Replit IDE template for the Bridges C++ library that you can use to create assignments for your students.

More information about the Bridges project can be found here. The Bridges C++ library documentation can be found here.

When the Bridges library is updated, this repository should be updated shortly thereafter (if necessary).

Getting Started

1. Use the GitHub import feature to use this repository as a template when creating a new repl
2. Insert your assignment scaffolding in the main file
3. (Optional) Remove the readme, license, and library setup files
4. Create a project (assignment) from the repl
5. Publish to your students

Building and Running

Just press the "Run" button. It will automatically compile and run the program.

Replit should automatically switch to the Console tab (to the right of the editor tab), but if it does not, you will have to manually do so to access stdin, stdout, and stderr.

Notes/FAQ

Where can I learn more about Replit?

Replit's documentation can be accessed here. It has resources for teachers here.

The following resources might be helpful as you are getting started with Replit:

• How to invite students
• Turning personal REPLs into assignments
• Creating lesson plans
• Using the autograder

What is the difference between the Console and Shell tabs in Replit?

In languages with a supported REPL environment (Python, Ruby, etc.), the Console tab is a REPL and also handles stdin/out/err of your application. (Not to be confused with a repl, an IDE instance hosted by Replit. More information on REPLs can be found here.)

In languages without a REPL environment (C, C++, etc.) or languages with a REPL environment not supported by Replit (e.g. Java), the Console is a Bash shell you can interact with and where stdin/out/err of your application is handled. However, it is not identical in functionality to the Shell tab, as the Shell tab is a terminal emulator while the Console tab is not. This difference is not important for many applications, but some, espcially (n)curses-based applications (git, man, vim, etc.) will work as expected in the Shell tab but are unusable in the Console tab.

There is a new Bridges library available but this repository has not yet been updated. How do I get the latest version?

In the Console or Shell tabs (to the right of the editor tab), execute the following commands:

curl -O http://bridgesuncc.github.io/sw/replit-cxx-setup.sh # download latest setup script (overwriting the existing script)
rm -r curl/ bridges-cxx-*/ # delete existing Bridges library
sh replit-cxx-setup.sh $(pwd) # run script

After this, you will have to manually re-run any Makefile changes.

See the Using Bridges C++ with Repl.it guide if this fails.

I do not want my assignment to be in a file named CxxTest.cpp. What do I do?

1. Rename CxxTest.cpp and adjust the class names (if necessary)
2. Either manually edit the Makefile and replit file or, in the Console or Shell tabs (to the right of the editor tab), execute the following commands:

   sed -i 's/CxxTest.cpp/MyNewFileName.cpp/g' Makefile # update make source file
   sed -i 's/CxxTest.cpp/MyNewFileName.cpp/g' .replit # update default file for Replit to open on startup

I need to compile multiple files. How do I do that?

Either manually edit the Makefile or, in the Console or Shell tabs (to the right of the editor tab), execute the following command:

sed -i 's/CxxTest.cpp/CxxTest.cpp OtherFile1.cpp OtherFile2.cpp Etc.cpp/g' Makefile # update make source files

I do not want my executable to be named CxxTest. How do I rename it?

Either manually edit the Makefile or, in the Console or Shell tabs (to the right of the editor tab), execute the following command:

sed -i 's/EXE=CxxTest/EXE=MyNewExecutableName/g' Makefile # update make destination file

License

This project is licensed under the MIT License - see the LICENSE.md file for details.