├── .gitignore ├── Git ├── .DS_Store ├── CopyPublicKey.png ├── CopySSHURL.png ├── CreateRepo-README.md ├── CreateRepo.png ├── CreateRepoForm.png ├── Git-Config-README.md ├── Git-Install-Mac.md ├── Git-Install-Ubuntu-README.md ├── Invite.png ├── ManageAccess.png ├── README.md ├── collaborator.png ├── git-config.png └── ssh-keys.png ├── LICENSE ├── Linux ├── .DS_Store ├── CPP-README.md ├── Jupyter-README.md ├── Linux-CPP-README.md ├── Linux-JavaScript-README.md ├── Linux-Python3-README.md ├── Miniconda-Install.png ├── Miniconda-README.md └── README.md ├── Mac ├── .DS_Store ├── Mac-CPP-README.md ├── Mac-JavaScript-README.md ├── Mac-Miniconda-README.md ├── Mac-Python3-README.md └── README.md ├── README.md ├── VSCode ├── Code-Git-GUI.png ├── CreateFolderFile.png ├── GUI-add-Commit.png ├── GUI-push.png ├── Git-CLI.png ├── GitHubCheck.png ├── README.md ├── VSCode-CPP-README.md ├── VSCode-Git-README.md └── VSCode-Python-README.md ├── Windows ├── CmdPrompt.png ├── README.md ├── Username.png ├── VSCode │ ├── .DS_Store │ ├── AdditionalTasks.png │ ├── CloseStartTerminal.png │ ├── CodeDestination.png │ ├── CodeInstaller.png │ ├── DefaultShell.png │ ├── DefaultShellBinBash.png │ ├── InstallStep.png │ ├── PCProperties.png │ ├── README.md │ ├── Remote-WSL.png │ ├── StartMenu.png │ ├── SystemType.png │ ├── VSCode-Install-README.md │ ├── VSCode-Terminal-README.md │ ├── WSL-Code.png │ └── WSLCodeSecAccess.png ├── WSL │ ├── README.md │ ├── WSL-Check-Feature.png │ ├── WSL-Restart.png │ ├── WSL-Run-Ubuntu.png │ ├── WSL-Search-Feature.png │ ├── WSL-Store-Ubuntu.png │ ├── WSL-Store.png │ ├── WSL-Ubuntu-Account.png │ ├── WSL-Ubuntu-Install.png │ ├── WSL-Ubuntu-Launch.png │ ├── WSL-Update.png │ └── WindowsDrive.png ├── Windows-CPP-README.md └── Windows-Python3-README.md └── resources ├── AddSSH.png ├── CPPExtension.png ├── GitHub-profile.png ├── GitHubSSH.png ├── Miniconda-Install.png ├── SSHTest.png ├── VSCodePythonExtension.png ├── View-Extensions.png └── mac_uname.png /.gitignore: -------------------------------------------------------------------------------- 1 | # Byte-compiled / optimized / DLL files 2 | __pycache__/ 3 | *.py[cod] 4 | *$py.class 5 | 6 | # C extensions 7 | *.so 8 | 9 | # Distribution / packaging 10 | .Python 11 | build/ 12 | develop-eggs/ 13 | dist/ 14 | downloads/ 15 | eggs/ 16 | .eggs/ 17 | lib/ 18 | lib64/ 19 | parts/ 20 | sdist/ 21 | var/ 22 | wheels/ 23 | pip-wheel-metadata/ 24 | share/python-wheels/ 25 | *.egg-info/ 26 | .installed.cfg 27 | *.egg 28 | MANIFEST 29 | 30 | # PyInstaller 31 | # Usually these files are written by a python script from a template 32 | # before PyInstaller builds the exe, so as to inject date/other infos into it. 33 | *.manifest 34 | *.spec 35 | 36 | # Installer logs 37 | pip-log.txt 38 | pip-delete-this-directory.txt 39 | 40 | # Unit test / coverage reports 41 | htmlcov/ 42 | .tox/ 43 | .nox/ 44 | .coverage 45 | .coverage.* 46 | .cache 47 | nosetests.xml 48 | coverage.xml 49 | *.cover 50 | *.py,cover 51 | .hypothesis/ 52 | .pytest_cache/ 53 | 54 | # Translations 55 | *.mo 56 | *.pot 57 | 58 | # Django stuff: 59 | *.log 60 | local_settings.py 61 | db.sqlite3 62 | db.sqlite3-journal 63 | 64 | # Flask stuff: 65 | instance/ 66 | .webassets-cache 67 | 68 | # Scrapy stuff: 69 | .scrapy 70 | 71 | # Sphinx documentation 72 | docs/_build/ 73 | 74 | # PyBuilder 75 | target/ 76 | 77 | # Jupyter Notebook 78 | .ipynb_checkpoints 79 | 80 | # IPython 81 | profile_default/ 82 | ipython_config.py 83 | 84 | # pyenv 85 | .python-version 86 | 87 | # pipenv 88 | # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. 89 | # However, in case of collaboration, if having platform-specific dependencies or dependencies 90 | # having no cross-platform support, pipenv may install dependencies that don't work, or not 91 | # install all needed dependencies. 92 | #Pipfile.lock 93 | 94 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow 95 | __pypackages__/ 96 | 97 | # Celery stuff 98 | celerybeat-schedule 99 | celerybeat.pid 100 | 101 | # SageMath parsed files 102 | *.sage.py 103 | 104 | # Environments 105 | .env 106 | .venv 107 | env/ 108 | venv/ 109 | ENV/ 110 | env.bak/ 111 | venv.bak/ 112 | 113 | # Spyder project settings 114 | .spyderproject 115 | .spyproject 116 | 117 | # Rope project settings 118 | .ropeproject 119 | 120 | # mkdocs documentation 121 | /site 122 | 123 | # mypy 124 | .mypy_cache/ 125 | .dmypy.json 126 | dmypy.json 127 | 128 | # Pyre type checker 129 | .pyre/ 130 | 131 | */DS_Store 132 | .DS_Store 133 | .vscode 134 | -------------------------------------------------------------------------------- /Git/.DS_Store: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/.DS_Store -------------------------------------------------------------------------------- /Git/CopyPublicKey.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/CopyPublicKey.png -------------------------------------------------------------------------------- /Git/CopySSHURL.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/CopySSHURL.png -------------------------------------------------------------------------------- /Git/CreateRepo-README.md: -------------------------------------------------------------------------------- 1 | # Creating and Cloning Git Repository 2 | 3 | Instructions on how to create and clone git repository for courses 4 | 5 | ## Create New Repository on GitHub 6 | 7 | 1. Login to your [GitHub.com](https://github.com/login) account 8 | 2. Click + button on the top right corner next to your profile 9 | 10 | ![Create Repository](CreateRepo.png) 11 | 12 | 3. on the Create a new repository page 13 | - Note you can change these settings once the repo is created 14 | 15 | 1. provide username, typically short course name/no. followed by your Mavzone username, e.g. CS1-rbasnet, CS2-rbasnet, CS0-rbasnet, AdvPy-rbasnet, AdvJS-rbasnet, CS420-rbasnet, etc. 16 | 17 | 2. provide some description 18 | 3. make your repo private 19 | - has some limitations (max # of collaborators can be 3 e.g.) for free account, but most course repo must be private so others can't see your assignments and projcts 20 | 4. Add a README file 21 | - select the appropriate language from the template depnding on what language is used in the course, e.g. C++ for course using C++, Python, etc. 22 | 5. No license is required for course repo 23 | 6. Click Create repository once everyting is filled up 24 | 25 | ![Create Repository](CreateRepoForm.png) 26 | 27 | 4. Add collaborators to your repo 28 | - Note: your instructor will be always one of the collaborators to check your work and grade 29 | - you can add your teammates if working in group 30 | - collaborator must have a GitHub account 31 | 32 | 1. go to your repository's main page by clicking Profile icon -> Your Repositories menu item 33 | 34 | ![Your Repositories](collaborator.png) 35 | 2. click Repository's Settings tab 36 | 3. Manage Access 37 | ![Manage Access](ManageAccess.png) 38 | 4. click Invite a collaborator 39 | 5. search collaborator by username or full name and select the right one from the list, e.g. rambasnet, wmacevoy, etc. 40 | 41 | ![Invite Collaborator](Invite.png) 42 | 43 | ## Clone a Repository from GitHub 44 | 45 | - You must clone the repository locally on your system inorder to add contents (files and folders etc.) 46 | - git must be installed and ssh configured on the system see instructions inside each system specific folder 47 | 48 | 1. open Terminal on Mac and Ubuntu, Ubuntu Bash Terminal on Windows 49 | 2. change working directory if necessary using **cd** command 50 | 3. create folder structure if necessary, e.g.: 51 | Note: text after # is comment on Bash and can be ignored 52 | 53 | ```bash 54 | pwd # print current direcotry's full path 55 | mkdir Fall2020 # Create root directory for Fall 2020 Semester 56 | cd Fall2020 57 | mdkir CS1 # create course specific directory, CS1 for CSCI 111, e.g. 58 | cd CS1 59 | ``` 60 | 61 | 4. copy SSH URL from repository's main page 62 | 1. click Clone with SSH 63 | 2. clip a little clipboard icon to copy the URL; select and Ctrl+C on Windows/Linux or Command+C on Mac also does it 64 | 65 | ![Copy SSH URL](CopySSHURL.png) 66 | 67 | 5. clone your course repository in the current working directory 68 | - paste the copied SSH URL 69 | - right click to paste on WSL 70 | - right click and Paste option on Mac on Linux Terminal 71 | - URL should look like git@github.com:\/\.git 72 | 73 | ```bash 74 | git clone git@github.com:rambasnet/CS1-rbasnet.git # replace with your repo's URL 75 | ls # notice your repo listed 76 | ``` 77 | 78 | 6. Open the repo folder with your favourite editor (VS Code, e.g.) and create files and folders as required by the course 79 | - see using Git with Visual Studio Code Editor instructions 80 | -------------------------------------------------------------------------------- /Git/CreateRepo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/CreateRepo.png -------------------------------------------------------------------------------- /Git/CreateRepoForm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/CreateRepoForm.png -------------------------------------------------------------------------------- /Git/Git-Config-README.md: -------------------------------------------------------------------------------- 1 | # Configure Git 2 | 3 | - you must have git installed with Command Line Interface and Bash Terminal 4 | - you need to configure git only once on each system you are using Git on 5 | 6 | 1. Create your free account on [https://gitub.com](https://github.com/join), if you don't have one yet 7 | - pick a username that closely represents you such as your firstname and lastname; depends on availability 8 | 9 | 2. open a Terminal (Ubuntu App on Windows WSL) 10 | 3. Let git know who you are. Use your real name and email you registered on GitHub 11 | 12 | ```bash 13 | git config --global user.name "" 14 | git config --global user.email "" 15 | ``` 16 | 17 | ![Git Config](git-config.png) 18 | 19 | 4. Setup SSH Authentication 20 | - Note: using ssh keys is not required but is recommended as it let's you authenticate with GitHub server or other git hosting sites (GitHub, GitLab, Bitbucket, etc.) so you don't have to type username/password every time 21 | - and YES, you'll be have to authenticate quite frequently while pulling and pushing code from the server 22 | - ssh keys will make your life a lot easier 23 | 24 | 5. Generate ssh keys 25 | - Note: pick default location to save the key and just hit enter key for password without picking a password 26 | - simply hit enter until you get the **\$** prompt back 27 | 28 | ```bash 29 | ssh-keygen 30 | ``` 31 | 32 | ![SSH Keys](ssh-keys.png) 33 | 34 | 6. list the content of the public key file to copy to GitHub 35 | 36 | ```bash 37 | cat ~/.ssh/id_rsa.pub 38 | ``` 39 | 40 | 7. **select/highlight** the contents from: ssh-rsa…. all the way to the end and **right click** to copy 41 | ![Copy Public Key](CopyPublicKey.png) 42 | 43 | 8. add the copied public key to GitHub profile settings 44 | 1. click on your github avatar on your dashboard page github.com/\ 45 | 2. click Settings 46 | 47 | ![Profile Settings](../resources/GitHub-profile.png) 48 | 3. click SSH and GPG keys and New SSH key button 49 | 50 | ![New SSH key](../resources/GitHubSSH.png) 51 | 4. enter Ctrl+v to paste the copied public key in the Key text box 52 | - for Title, give it a descriptive name like "WSL-Ubuntu", "Windows Laptop" where the key is copied from 53 | 5. click Add SSH Key 54 | 55 | ![Add SSH Key](../resources/AddSSH.png) 56 | 57 | 9. Test to see if WSL Ubuntu can be authenticated with GitHub 58 | 59 | ```bash 60 | ssh -T git@github.com 61 | ``` 62 | 63 | ![SSH Test](../resources/SSHTest.png) 64 | -------------------------------------------------------------------------------- /Git/Git-Install-Mac.md: -------------------------------------------------------------------------------- 1 | # Install command-line developer tools (g++, git, etc.) 2 | 3 | 1. open a Terminal 4 | 2. run the following commands on the Terminal 5 | 6 | ```bash 7 | x-code-select install #installs compiler and many other relevant command-line tools 8 | g++ --version # check if g++ is installed 9 | git --version # check if git is installed 10 | ``` 11 | -------------------------------------------------------------------------------- /Git/Git-Install-Ubuntu-README.md: -------------------------------------------------------------------------------- 1 | # Install Git on WSL and Ubuntu 2 | 3 | 1. run Ubuntu Bash Terminal 4 | 2. git should be already installed; double check by typing the following command on Bash Terminal 5 | 6 | ```bash 7 | git --version 8 | ``` 9 | 10 | 3. If you get error while checking git version, install git typing the following command 11 | 12 | ```bash 13 | sudo apt install git 14 | ``` 15 | -------------------------------------------------------------------------------- /Git/Invite.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/Invite.png -------------------------------------------------------------------------------- /Git/ManageAccess.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/ManageAccess.png -------------------------------------------------------------------------------- /Git/README.md: -------------------------------------------------------------------------------- 1 | # Git Installation on Configuration 2 | 3 | ## Install Git on Mac 4 | 5 | - follow the instructions here [Git-Install-Mac.md](Git-Install-Mac.md) 6 | 7 | ## Install Git on Ubuntu and WSL Windows 8 | 9 | - follow the instructions here [Git-Install-Ubuntu-README.md](Git-Install-Ubuntu-README.md) 10 | 11 | ## Configure Git on Windows WSL, Mac and Linux 12 | 13 | - follow the instructions here [Git-Config-README.md](Git-Config-README.md) 14 | 15 | ## Using Git with VSCode and Terminal 16 | 17 | - follow the instructions here [../VSCode/VSCode-Git-README.md](../VSCode/VSCode-Git-README.md) 18 | 19 | ## Creating a Github Repository 20 | 21 | - follow the instruction here [CreateRepo-README.md](CreateRepo-README.md) -------------------------------------------------------------------------------- /Git/collaborator.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/collaborator.png -------------------------------------------------------------------------------- /Git/git-config.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/git-config.png -------------------------------------------------------------------------------- /Git/ssh-keys.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Git/ssh-keys.png -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2020 Ram Basnet 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /Linux/.DS_Store: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Linux/.DS_Store -------------------------------------------------------------------------------- /Linux/CPP-README.md: -------------------------------------------------------------------------------- 1 | # Install C++ compiler and relevant tools on Linux 2 | 3 | 1. run a Terminal 4 | 2. run the following commands on the Bash Terminal 5 | 6 | ```bash 7 | sudo apt install build-essential #installs compiler and many other relevant tools 8 | sudo apt install ccache # compiler cache - speeds up compiling the same source files many 9 | g++ --version # check if g++ is installed 10 | ``` 11 | -------------------------------------------------------------------------------- /Linux/Jupyter-README.md: -------------------------------------------------------------------------------- 1 | # Install Jupyter Notebook 2 | 3 | - install notebook and xeus-cling kernel to run C++ code on Jupyter Notebook for teaching and learning C++ 4 | 5 | 1. run Bash Terminal 6 | 2. run the following commands 7 | 8 | ```bash 9 | conda install notebook # Note: it takes a while; if update looks paused, hit enter 10 | conda install -c conda-forge xeus-cling 11 | conda install -c conda-forge jupyter_contrib_nbextensions 12 | conda install -c conda-forge jupyter_nbextensions_configurator 13 | jupyter nbextensions_configurator enable --user 14 | ``` 15 | 16 | - enter **y** to proceed when asked on the installation steps 17 | -------------------------------------------------------------------------------- /Linux/Linux-CPP-README.md: -------------------------------------------------------------------------------- 1 | # Setting up C++ Development Environment on Ubuntu Linux 2 | 3 | ## Tools 4 | 5 | - Visual Studio Code 6 | - git version control 7 | - GNU g++ compiler 8 | - Jupyter Notebook 9 | - C++ kernel for Jupyter Notebook 10 | 11 | ## Install Visual Studio Code 12 | 13 | - recommended editor for writing C++ code, compiling and debugging 14 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 15 | - download and install VS Code for Ubuntu (.deb) from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 16 | - install install .deb file using a terminal 17 | - Note: do not type `< >` placeholder brackets with the command 18 | 19 | ```bash 20 | cd 21 | sudo dpkg -i 22 | ``` 23 | 24 | ## Configure Visual Studio Code 25 | 26 | - follow the instructions in [../VSCode/VSCode-CPP-README.md](../VSCode/VSCode-CPP-README.md) 27 | 28 | ## Run Bash/Shell Terminal 29 | 30 | 1. search and run Terminal 31 | 2. add it to favourites for quick access 32 | 33 | ## Install C++ Compiler and relevant tools 34 | 35 | - follow the instructions in [CPP-README.md](CPP-README.md) 36 | 37 | ## Install Git 38 | 39 | - follow the instructions in [../Git/Git-Install-Ubuntu-README.md](../Git/Git-Install-Ubuntu-README.md) 40 | 41 | ## Configure Git 42 | 43 | - follow the instructions in [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 44 | 45 | ## Install miniconda Python Package Manager 46 | 47 | - follow the instructions in [Miniconda-README.md](Miniconda-README.md) 48 | 49 | ## Install Jupyter Notebook 50 | 51 | - follow the instructions in [Jupyter-README.md](Jupyter-README.md) 52 | 53 | ## Run Jupyter Notebook server 54 | 55 | 1. run Bash Terminal 56 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 57 | 58 | ```bash 59 | cd 60 | jupyter notebook # run jupyter notebook from the current working directory 61 | ``` 62 | 63 | 3. if a browser doesn’t open, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 64 | 65 | ## Stop Jupyter Notebook server 66 | 67 | 1. to stop jupyter notebook, enter control+c keys on the same Terminal that's running Jupyter server 68 | 69 | ```bash 70 | control+c # press two buttons simultanesouly to stop jupyter notebook server 71 | ``` 72 | -------------------------------------------------------------------------------- /Linux/Linux-JavaScript-README.md: -------------------------------------------------------------------------------- 1 | # Setting up JavaScript (NodeJS) Development Environment on Ubuntu Linux 2 | 3 | ## Tools 4 | 5 | - Visual Studio Code 6 | - git version control 7 | - Python3 8 | - NodeJS 9 | - Jupyter Notebook 10 | 11 | ## Install Visual Studio Code 12 | 13 | - recommended editor for writing C++ code, compiling and debugging 14 | - editor that has many built-in features including git, terminal and many third party extensions to support many programming languages and dev tools 15 | - download and install VS Code for Ubuntu (.deb) from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 16 | 17 | ## Run Bash Terminal/Shell 18 | 19 | 1. search and run Terminal 20 | 2. add it to favourites for quick access 21 | 22 | ## Install Git 23 | 24 | - follow the instructions in [../Git/README.md](../Git/README.md) 25 | 26 | ## Configure Git 27 | 28 | - follow the instructions in [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 29 | 30 | ## Install miniconda Python Package Manager 31 | 32 | - follow the instructions in [Miniconda-README.md](Miniconda-README.md) 33 | 34 | 35 | ## Install NodeJS and Tools 36 | 37 | ```bash 38 | conda update conda 39 | conda create -n nodejs 40 | conda env list 41 | conda activate nodejs 42 | conda install -c conda-forge nodejs 43 | conda install jupyter 44 | conda install -c conda-forge jupyter_contrib_nbextensions 45 | conda install -c conda-forge jupyter_nbextensions_configurator 46 | jupyter nbextensions_configurator enable --user 47 | npm install -g ijavascript 48 | ijsinstall 49 | ``` 50 | 51 | ## Run Jupyter Notebook server 52 | 53 | 1. run Bash Terminal 54 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 55 | 56 | ```bash 57 | cd 58 | jupyter notebook # run jupyter notebook from the current working directory 59 | ``` 60 | 61 | 3. if a browser doesn’t open, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 62 | 63 | ## Stop Jupyter Notebook server 64 | 65 | 1. to stop jupyter notebook, enter control+c keys on the same Terminal that's running Jupyter server 66 | 67 | ```bash 68 | control+c # press two buttons simultanesouly to stop jupyter notebook server 69 | ``` 70 | -------------------------------------------------------------------------------- /Linux/Linux-Python3-README.md: -------------------------------------------------------------------------------- 1 | # Setting up Python3 Development Environment on Ubuntu Linux 2 | 3 | ## Tools 4 | 5 | - Visual Studio Code 6 | - git version control 7 | - Python3 8 | - Jupyter Notebook 9 | 10 | ## Install Visual Studio Code 11 | 12 | - recommended editor for writing C++ code, compiling and debugging 13 | - editor that has many built-in features including git, terminal and many third party extensions to support many programming languages and dev tools 14 | - download and install VS Code for Ubuntu (.deb) from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 15 | 16 | ## Configure Visual Studio Code 17 | 18 | - follow the instructions in [../VSCode/VSCode-Python-README.md](../VSCode/VSCode-Python-README.md) 19 | 20 | ## Run Bash Terminal/Shell 21 | 22 | 1. search and run Terminal 23 | 2. add it to favourites for quick access 24 | 25 | ## Install Git 26 | 27 | - follow the instructions in [../Git/README.md](../Git/README.md) 28 | 29 | ## Configure Git 30 | 31 | - follow the instructions in [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 32 | 33 | ## Install miniconda Python Package Manager 34 | 35 | - follow the instructions in [Miniconda-README.md](Miniconda-README.md) 36 | 37 | ## Install Jupyter Notebook 38 | 39 | - follow the instructions in [Jupyter-README.md](Jupyter-README.md) 40 | 41 | ## Run Jupyter Notebook server 42 | 43 | 1. run Bash Terminal 44 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 45 | 46 | ```bash 47 | cd 48 | jupyter notebook # run jupyter notebook from the current working directory 49 | ``` 50 | 51 | 3. if a browser doesn’t open, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 52 | 53 | ## Stop Jupyter Notebook server 54 | 55 | 1. to stop jupyter notebook, enter control+c keys on the same Terminal that's running Jupyter server 56 | 57 | ```bash 58 | control+c # press two buttons simultanesouly to stop jupyter notebook server 59 | ``` 60 | -------------------------------------------------------------------------------- /Linux/Miniconda-Install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Linux/Miniconda-Install.png -------------------------------------------------------------------------------- /Linux/Miniconda-README.md: -------------------------------------------------------------------------------- 1 | # Installing Miniconda3 Python3 Package Manager on Ubuntu 2 | 3 | - miniconda3 install provides Python3 as well 4 | - miniconda3 can be used to install various other Python3 packages such as jupyter notebook, machine learning libraries, etc. 5 | 6 | 1. open Ubuntu Bash Terminal 7 | 2. type or copy paste the following commands 8 | 9 | ```bash 10 | cd ~ # change current working directory to user's home directory 11 | curl -o Miniconda3.sh https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh 12 | ls # make sure you see Miniconda3.sh file in the current folder 13 | bash Miniconda3.sh # run the downloaded file with bash program 14 | ``` 15 | 16 | ![Minicodna Install](Miniconda-Install.png) 17 | 18 | 3. follow the instructions on the screen; when you see --More--, just hit space bar key to get the end of the license terms and see >>> 19 | - enter **yes** to accept the license terms 20 | - press **ENTER key** to confirm the default location 21 | - this may take a while 22 | - enter **yes** to initialize Miniconda3 23 | 24 | 4. close and reopen Terminal once Miniconda3 is installed 25 | 5. check current conda version installed 26 | 27 | ```bash 28 | conda --version 29 | ``` 30 | 31 | - if you see conda command not found error close and start a new bash terminal and type the command again 32 | 33 | 6. check python installed 34 | 35 | ```bash 36 | python --version # you should see Python 3.x.x 37 | ``` 38 | 39 | 7. update conda 40 | 41 | ```bash 42 | conda update conda 43 | ``` 44 | 45 | - enter **y** if asked to Proceed -------------------------------------------------------------------------------- /Linux/README.md: -------------------------------------------------------------------------------- 1 | # Development Environment Setup Instructions on Ubuntu Linux 2 | 3 | If you're running Ubuntu Linux, follow the instructions in this section 4 | 5 | ## C++ Dev Environment Setup on Ubuntu 6 | 7 | - follow the instructions on [Linux-CPP-README.md](Linux-CPP-README.md) to setup C++ development environment 8 | 9 | ## Python3 Dev Environment Setup on Ubuntu 10 | 11 | - follow the instructions on [Linux-Python3-README.md](Linux-Python3-README.md) to setup Python3 Dev Environment on Ubuntu 12 | 13 | ### JavaScript Dev Environment Setup on Ubuntu 14 | 15 | - follow the instructions on [Linux-JavaScript-README.md](Linux-JavaScript-README.md) 16 | -------------------------------------------------------------------------------- /Mac/.DS_Store: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Mac/.DS_Store -------------------------------------------------------------------------------- /Mac/Mac-CPP-README.md: -------------------------------------------------------------------------------- 1 | # Setting up C++ Development Environment on Mac 2 | 3 | ## Tools 4 | 5 | - Visual Studio Code 6 | - git version control 7 | - g++ compiler 8 | - Jupyter Notebook 9 | - C++ kernel for Jupyter Notebook 10 | 11 | ## Install Visual Studio Code 12 | 13 | - recommended editor for writing C++ code, compiling and debugging 14 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 15 | - download and install VS Code for Mac from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 16 | 17 | ## Configure Visual Studio Code 18 | 19 | - follow the instructions found in [../VSCode/VSCode-CPP-README.md](../VSCode/VSCode-CPP-README.md) 20 | 21 | ## Run Bash Terminal 22 | 23 | - any time you need to run bash commands, you must do it from Terminal app 24 | 25 | 1. follow these steps to run Terminal 26 | 2. search (using command+space bar keys) for Terminal 27 | 3. click to run Terminal App 28 | 4. Right click Terminal app on dock -> Options -> Keep in Dock (for quick access in the future) 29 | 30 | ## Install command-line developer tools (g++, git, etc.) 31 | 32 | 1. open a Terminal 33 | 2. run the following commands on the Terminal 34 | 35 | ```bash 36 | x-code-select install #installs compiler and many other relevant command-line tools 37 | g++ --version # check if g++ is installed 38 | git --version # check if git is installed 39 | ``` 40 | 41 | ## Configure Git 42 | 43 | - the instruction is virtually the same for WSL Ubuntu and Mac 44 | - follow the instructions on [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 45 | 46 | ## Install miniconda Python3 package manager 47 | 48 | - follow the instructions on [Mac-Miniconda-README.md](Mac-Miniconda-README.md) 49 | 50 | ## Install Jupyter Notebook and C++ Kernel 51 | 52 | - follow the instructions on [../Linux/Jupyter-README.md](../Linux/Jupyter-README.md) 53 | 54 | ## Run Jupyter Notebook server 55 | 56 | 1. open a Terminal 57 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 58 | 59 | ```bash 60 | cd 61 | jupyter notebook # run jupyter notebook from the current working directory 62 | ``` 63 | 64 | 3. if a browser doesn’t open automatically, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 65 | 66 | ## Stop Jupyter Notebook server 67 | 68 | 1. to stop jupyter notebook, enter control C keys simultaneously on the same Terminal that's running Jupyter server 69 | 2. do it a few times if it doesn't stop 70 | 71 | ```bash 72 | press control C keys 73 | ``` 74 | -------------------------------------------------------------------------------- /Mac/Mac-JavaScript-README.md: -------------------------------------------------------------------------------- 1 | # Setting up Python3 Development Environment on Mac 2 | 3 | ## Tools 4 | 5 | - Visual Studio Code 6 | - git version control 7 | - Python3 8 | - NodeJS 9 | - Jupyter Notebook 10 | 11 | ## Install Visual Studio Code 12 | 13 | - recommended editor for writing C++ code, compiling and debugging 14 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 15 | - download and install VS Code for Mac from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 16 | 17 | ## Run Bash Terminal 18 | 19 | - any time you need to run bash commands, you must do it from Terminal app 20 | 21 | 1. follow these steps to run Terminal 22 | 2. search (using command+space bar keys) for Terminal 23 | 3. click to run Terminal App 24 | 4. Right click Terminal app on dock -> Options -> Keep in Dock (for quick access in the future) 25 | 26 | ## Install command-line developer tools (g++, git, etc.) 27 | 28 | 1. open a Terminal 29 | 2. run the following commands on the Terminal 30 | 31 | ```bash 32 | x-code-select install #installs compiler and many other relevant command-line tools 33 | g++ --version # check if g++ is installed 34 | git --version # check if git is installed 35 | ``` 36 | 37 | ## Configure Git 38 | 39 | - follow the instructions on [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 40 | 41 | ## Install miniconda Python3 package manager 42 | 43 | - follow the instructions on [Mac-Miniconda-README.md](Mac-Miniconda-README.md) 44 | 45 | ## Install NodeJS and Tools 46 | 47 | ```bash 48 | conda update conda 49 | conda create -n nodejs 50 | conda env list 51 | conda activate nodejs 52 | conda install -c conda-forge nodejs 53 | conda install jupyter 54 | conda install -c conda-forge jupyter_contrib_nbextensions 55 | conda install -c conda-forge jupyter_nbextensions_configurator 56 | jupyter nbextensions_configurator enable --user 57 | npm install -g ijavascript 58 | ijsinstall 59 | ``` 60 | 61 | ## Run Jupyter Notebook server 62 | 63 | 1. open a Terminal 64 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 65 | 66 | ```bash 67 | cd 68 | conda activate nodejs 69 | jupyter notebook # run jupyter notebook from the current working directory 70 | ``` 71 | 72 | 3. if a browser doesn’t open automatically, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 73 | 74 | ## Stop Jupyter Notebook server 75 | 76 | 1. to stop jupyter notebook, enter control C keys simultaneously on the same Terminal that's running Jupyter server 77 | 2. do it a few times if it doesn't stop 78 | 79 | ```bash 80 | press control & C keys simultanesouly 81 | ``` 82 | -------------------------------------------------------------------------------- /Mac/Mac-Miniconda-README.md: -------------------------------------------------------------------------------- 1 | # Installing Miniconda Python3 Package Manager on Mac 2 | 3 | - miniconda install provides Python3 as well 4 | - miniconda can be used to install various other Python packages such as jupyter notebook, machine learning libraries, etc. 5 | 6 | 1. open a Terminal 7 | 2. find out if your Mac is running Intel or Apple M1/M2 that's based on ARM64 architecture and follow either 3.a or 3.b based on the result 8 | 9 | ```bash 10 | uname -m 11 | ``` 12 | 13 | ![Uname](../resources/mac_uname.png) 14 | 15 | 3.a if the result of `uname -m` is **x86_64**, type or copy paste the following commands 16 | 17 | ```bash 18 | cd ~ # change current working directory to user's home directory 19 | curl -o Miniconda3-intel.sh https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh 20 | ls # make sure you see Miniconda3.sh file in the current folder 21 | bash Miniconda3-intel.sh # run the downloaded file with bash program 22 | ``` 23 | 24 | ![Miniconda Install](../resources/Miniconda-Install.png) 25 | 26 | 3.b if the result of `uname -m` is **arm64**, type or copy paste the following commands 27 | 28 | ```bash 29 | cd ~ # change current working directory to user's home directory 30 | curl -o Miniconda3-arm64.sh https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh 31 | ls # make sure you see Miniconda3.sh file in the current folder 32 | bash Miniconda3-arm64.sh # run the downloaded file with bash program 33 | ``` 34 | 35 | 4. follow the instructions on the screen; when you see :, just hit space bar key to get the end of the End User License Agreement and see >>> 36 | - enter **yes** to accept the license terms 37 | - press **ENTER key** to confirm the default location 38 | - this may take a while 39 | - enter **yes** to initialize Miniconda3 40 | 41 | 5. close and reopen Terminal once Miniconda3 is installed 42 | 6. check current conda version installed 43 | 44 | ```bash 45 | conda --version 46 | ``` 47 | 48 | - if you see conda command not found error close and start a new bash terminal and type the command again 49 | 50 | 7. check python installed 51 | 52 | ```bash 53 | python --version # you should see Python 3.x.x 54 | ``` 55 | 56 | 8. update conda 57 | 58 | ```bash 59 | conda update conda 60 | ``` 61 | 62 | - enter **y** if asked to Proceed 63 | 64 | -------------------------------------------------------------------------------- /Mac/Mac-Python3-README.md: -------------------------------------------------------------------------------- 1 | # Setting up Python3 Development Environment on Mac 2 | 3 | ## Tools 4 | 5 | - Visual Studio Code 6 | - git version control 7 | - Python3 8 | - Jupyter Notebook 9 | 10 | ## Install Visual Studio Code 11 | 12 | - recommended editor for writing C++ code, compiling and debugging 13 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 14 | - download and install VS Code for Mac from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 15 | 16 | ## Configure Visual Studio Code 17 | 18 | - follow the instructions found in [../VSCode/VSCode-Python-README.md](../VSCode/VSCode-Python-README.md) 19 | 20 | ## Run Bash Terminal 21 | 22 | - any time you need to run bash commands, you must do it from Terminal app 23 | 24 | 1. follow these steps to run Terminal 25 | 2. search (using command+space bar keys) for Terminal 26 | 3. click to run Terminal App 27 | 4. Right click Terminal app on dock -> Options -> Keep in Dock (for quick access in the future) 28 | 29 | ## Install command-line developer tools (g++, git, etc.) 30 | 31 | 1. open a Terminal 32 | 2. run the following commands on the Terminal 33 | 34 | ```bash 35 | x-code-select install #installs compiler and many other relevant command-line tools 36 | g++ --version # check if g++ is installed 37 | git --version # check if git is installed 38 | ``` 39 | 40 | ## Configure Git 41 | 42 | - follow the instructions on [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 43 | 44 | ## Install miniconda Python3 package manager 45 | 46 | - follow the instructions on [Mac-Miniconda-README.md](Mac-Miniconda-README.md) 47 | 48 | ## Run Jupyter Notebook server 49 | 50 | 1. open a Terminal 51 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 52 | 53 | ```bash 54 | cd 55 | jupyter notebook # run jupyter notebook from the current working directory 56 | ``` 57 | 58 | 3. if a browser doesn’t open automatically, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 59 | 60 | ## Stop Jupyter Notebook server 61 | 62 | 1. to stop jupyter notebook, enter control C keys simultaneously on the same Terminal that's running Jupyter server 63 | 2. do it a few times if it doesn't stop 64 | 65 | ```bash 66 | press control & C keys simultanesouly 67 | ``` 68 | -------------------------------------------------------------------------------- /Mac/README.md: -------------------------------------------------------------------------------- 1 | # Development Environment Setup on Mac 2 | 3 | If you're running Mac, follow the instructions in this section 4 | 5 | ## C++ Dev Environment Setup on Mac 6 | 7 | - follow the instructions on [Mac-CPP-README.md](Mac-CPP-README.md) to setup of C++ Dev Environment on Mac. 8 | 9 | ## Python3 Dev Environment Setup on Mac 10 | 11 | - follow the instructions on [Mac-Python3-README.md](Mac-Python3-README.md) to setup Python3 development environment on mac 12 | 13 | ## JavaScript Dev Environment Setup on Mac 14 | 15 | - follow the instructions on [Mac-JavaScript-README.md](Mac-JavaScript-README.md) -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Development Environment Setup 2 | 3 | Instructions to Setup Development Environments for various Programming Languages (C, C++, Python, NodeJS, etc.) on Windows 10, Mac and Linux 4 | 5 | ## Instruction Notes 6 | 7 | - **\$** is default prompt for regular user and is always there on Mac and Ubuntu Bash Terminal 8 | - you don't type it as a part of command 9 | - **#** on bash command is comment ignored by the Bash Terminal 10 | - you don't need to type # and rest of the comment as a part of command 11 | - any command that starts with **sudo** keyword requires superuser/admin priviledge and prompts for your password 12 | - **\< ... \>** - is a place holder that must be replaced (including the angular brackets) with the actual content in place 13 | 14 | ## Windows 10/11 15 | 16 | If you're running Windows, follow the instructions in [this README](Windows/README.md) in Windows folder. 17 | 18 | ## Mac 19 | 20 | If you're running Mac, follow the instructions in [this README](Mac/README.md) in Mac folder. 21 | 22 | ## Virtual Box and Ubuntu Linux VM Setup 23 | 24 | If you want to install Ubuntu virtual machine as a VM in Virtual Box, follow the instructions [here](https://docs.google.com/document/d/1kmjY_8B1UuRr4IMsJefEGnq92zuq7Y9UJCvUJeIj94A/edit?usp=sharing) 25 | 26 | ## Ubuntu Linux 27 | 28 | If you're running Ubuntu Linux, follow the instructions in this [README](Linux/README.md) 29 | 30 | ## Using Git 31 | 32 | ### Create and Clone GitHub Repository 33 | 34 | - follow the instructions on [Git/CreateRepo-README.md](Git/CreateRepo-README.md) 35 | 36 | ### Using Git with Visual Studio (VS) Code GUI and CLI 37 | 38 | - follow the instructions on [VSCode/VSCode-Git-README.md](VSCode/VSCode-Git-README.md) 39 | 40 | ### Deeper Git Instructions 41 | 42 | - read the Google doc [here](https://docs.google.com/document/d/1M0YeBfFPy5YPpfX7312R9-IldjagimvEma_YhgeLPcw/edit#heading=h.ssqvh5gmotj4) 43 | 44 | ### Git Command Cheatsheet 45 | 46 | - [https://github.github.com/training-kit/downloads/github-git-cheat-sheet.pdf](https://github.github.com/training-kit/downloads/github-git-cheat-sheet.pdf) 47 | 48 | ### GitHub Markdown Cheatsheet 49 | 50 | - quick reference and showcase [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) 51 | 52 | ### Student Sample GitHub Repo 53 | 54 | - students should strive to organize their repository with uptodate README file 55 | - see a sample repo [here](https://github.com/rambasnet/csci000-astudent) 56 | 57 | ## Linux and Mac Bash Commands References 58 | 59 | - In Depth Linux Bash Commands and Scripts [http://linuxcommand.org/](http://linuxcommand.org/) 60 | - Quick Reference [pdf here](https://files.fosswire.com/2007/08/fwunixref.pdf) 61 | 62 | ## Online Code Editors and IDE 63 | 64 | - [https://repl.it/](https://repl.it/) 65 | - Online IDE - [https://www.online-ide.com/](https://www.online-ide.com/) 66 | - Online IDE and debugger - [https://www.onlinegdb.com/online_c++_compiler](https://www.onlinegdb.com/online_c++_compiler) 67 | - [https://coliru.stacked-crooked.com/](https://coliru.stacked-crooked.com/) 68 | - [http://cpp.sh](http://cpp.sh/) 69 | 70 | ## Jupyter Notebook Shortcuts 71 | 72 | - [https://www.dataquest.io/blog/jupyter-notebook-tips-tricks-shortcuts/](https://www.dataquest.io/blog/jupyter-notebook-tips-tricks-shortcuts/) 73 | -------------------------------------------------------------------------------- /VSCode/Code-Git-GUI.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/VSCode/Code-Git-GUI.png -------------------------------------------------------------------------------- /VSCode/CreateFolderFile.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/VSCode/CreateFolderFile.png -------------------------------------------------------------------------------- /VSCode/GUI-add-Commit.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/VSCode/GUI-add-Commit.png -------------------------------------------------------------------------------- /VSCode/GUI-push.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/VSCode/GUI-push.png -------------------------------------------------------------------------------- /VSCode/Git-CLI.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/VSCode/Git-CLI.png -------------------------------------------------------------------------------- /VSCode/GitHubCheck.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/VSCode/GitHubCheck.png -------------------------------------------------------------------------------- /VSCode/README.md: -------------------------------------------------------------------------------- 1 | # Visual Studio (VS) Code Installation and Configuration 2 | 3 | - recommended editor for writing C++, Python, JavaScript codes, compiling and debugging 4 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 5 | 6 | ## VS Code Installation on Windows/WSL 7 | 8 | - follow the instructions on [VSCode-Install-README.md](../Windows/VSCode/VSCode-Install-README.md) 9 | 10 | ## VS Code Installation on Mac 11 | 12 | - download and install VS Code for Mac from [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 13 | 14 | ## Configure VS Code of C++ Development 15 | 16 | - follow the instructions in [VSCode-CPP-README.md](VSCode-CPP-README.md) 17 | 18 | ## Configure VS Code for Python Development 19 | 20 | - follow the instructions in [VSCode-Python-README.md](VSCode-Python-README.md) 21 | 22 | ## Using Git GUI Client on VS Code 23 | 24 | - follow the instructions in [VSCode-Git-README.md](VSCode-Git-README.md) 25 | -------------------------------------------------------------------------------- /VSCode/VSCode-CPP-README.md: -------------------------------------------------------------------------------- 1 | # Configure VS Code for C++ Development 2 | 3 | ## Run Extensions Marketplace 4 | 5 | 1. run Visual Studio Code 6 | 2. open extensions marketplace - View->Extensions 7 | ![Extensions](../resources/View-Extensions.png) 8 | 9 | ## Install C/C++ extension 10 | 11 | 1. open extension marketplace 12 | 2. search C/C++ and install 13 | ![C/C++ Extension](../resources/CPPExtension.png) 14 | 3. close and restart VS Code 15 | -------------------------------------------------------------------------------- /VSCode/VSCode-Git-README.md: -------------------------------------------------------------------------------- 1 | # Using Git 2 | 3 | - Git can be used with various Graphical User Interface (GUI)-based applications or using Command Line Interface (CLI) 4 | - VS Code provides GUI interface to work with your git repository 5 | - GUI interface makes it easy to work with git repository (e.g. add, commit, push, pull, etc.) 6 | - command line is an alternative and this document provides instructions for both GUI and Command line interface of git 7 | - Git must be configured, before the GUI or CLI can be used to work with your repository 8 | 9 | ## Git GUI Interface on VS Code 10 | 11 | 1. open VS Code on your system 12 | - Note that Windows WSL Ubuntu must have Remote-WSL extension installed to access files from Windows as well as WSL Ubuntu 13 | 2. display Integreted Terminal on VS Code 14 | - click Terminal menu and click New Terminal 15 | - select bash as the default shell 16 | 3. open your repository 17 | 1. click File -> Open Folder and browse the repository folder that's cloned on the system 18 | - click Show Local if the repository is cloned on Windows system 19 | - by default it'll show folders and files on WSL Ubuntu system 20 | - e.g. if CS1-rbasnet is the repository cloned in user's home directory 21 | - hit OK button once you found your repo to open it 22 | ![Open Repo](Code-Git-GUI.png) 23 | 3. create a test folder and file 24 | 1. click Explorer and create a test folder and test.txt file inside it, if you hover your mouse on repository name, you'll see New File and New Folder buttons 25 | - write some text to the test.txt file and save the file 26 | ![Create Folder](CreateFolderFile.png) 27 | 4. track changed files and commit changes to the local repository 28 | 1. click Source Control icon on the left panel 29 | 2. click + on each file that you want to stage changes 30 | 3. write some message in the text box 31 | 4. click check button to commit locally 32 | ![Add, Commit](GUI-add-Commit.png) 33 | 5. push changes to the remote repository (GitHub.com) 34 | - click more ... buttom and select Pull, Push -> Push 35 | ![Push](GUI-push.png) 36 | 6. Check your GitHub.com repository and make sure you see test folder and test.txt file 37 | - if you're on the repo page, you'll need to refresh/reload the page 38 | ![GitHub Check](GitHubCheck.png) 39 | 6. when workin in team or want to work from different system, you must first pull to avoid conflicts 40 | 1. click ... more button on Source Control panel. 41 | 2. click Pull, Push and click Pull 42 | 43 | ## CLI Git commands 44 | 45 | - open Bash Terminal separately or Integrated Terminal on VS Code 46 | - current working director must be repositry's root folder to issue git commands 47 | - the most commonly used commands are: add, commit, push and pull 48 | 49 | ```bash 50 | cd 51 | git status # check the status 52 | git add 53 | git commit -m "write a brief message" 54 | git push # send/upload the updates to remote repo 55 | git status # make sure everything is uptodate 56 | git pull # pull/dowloand updates from remote repo 57 | ``` 58 | 59 | ![CLI Git](Git-CLI.png) 60 | 61 | - verify the remote repository on GitHub is uptodate 62 | 63 | -------------------------------------------------------------------------------- /VSCode/VSCode-Python-README.md: -------------------------------------------------------------------------------- 1 | # Configure VS Code for Python Development 2 | 3 | ## Run Extensions Marketplace 4 | 5 | 1. run Visual Studio Code 6 | 2. open extensions marketplace - View->Extensions 7 | ![Extensions](../resources/View-Extensions.png) 8 | 9 | ## Install Python extension 10 | 11 | 1. open extension marketplace 12 | 2. search Python and install 13 | ![Python Extension](../resources/VSCodePythonExtension.png) 14 | 3. restart VS Code 15 | -------------------------------------------------------------------------------- /Windows/CmdPrompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/CmdPrompt.png -------------------------------------------------------------------------------- /Windows/README.md: -------------------------------------------------------------------------------- 1 | # Development Evnvironment Setup Instructions on Windows 10/11 2 | 3 | If you're running Windows 10/11, follow the instructions in this section. Windows instructions use WSL Ubuntu Bash Terminal to install Linux-based tool chains. 4 | 5 | NOTE: Certain tool chains may not work with WSL. So, it's highly recommended that you first install Ubuntu Linux Virtual Machine (VM) and follow the instruction for Linux development environment setup. In order to run VM smoothly, your system must have atleast 8 GB RAM and 4 cores so you can allocate half of the resources (4GB RAM and 2 cores -- ideal amount) to your VM. Alternativley, you can format and install Ubuntu Linux as the host Operating System especially if your system doesn't have adequate resources. 6 | 7 | ## C++ Dev Environment Setup on Personal Windows System 8 | 9 | - follow the instructions on [Windows-CPP-README.md](Windows-CPP-README.md) to setup C++ Dev Environment on Windows 10 | 11 | ## Python3 Development Environment Setup on Personal Windows System 12 | 13 | - follow the instructions on [Windows-Python3-README.md](Windows-Python3-README.md) to setup Python Dev Environment on Windows 14 | 15 | ## Install WSL on CMU Labs Windows System 16 | 17 | - On CS Labs Windows System, follow these instructions: 18 | 19 | - NOTE: Pick a system and stick to it for the rest of the semester! Otherwise, you may have to install WSL and all the tools on every system you use. 20 | 21 | 1. Double click/run WSL shortcut on your Desktop or search for WSL 22 | 23 | 2. Click Install and go through the installation process enter yes on every prompt! It may take several minutes. 24 | 25 | 4. Once everything is installed and you get bash terminal, type the following command to update your Linux 26 | 27 | ```bash 28 | sudo apt update 29 | ``` 30 | - type in your password 31 | 32 | 5. Once WSL is installed, you can click WSL desktop shortcut or search for WSL to run Ubuntu Bash Terminal 33 | 34 | 6. How to Map F: drive to WSL Ubuntu file system 35 | 36 | ```bash 37 | mkdir -p /mnt/f 38 | mount -t drvfs '\\homefs\home\' /mnt/f 39 | ls /mnt/f 40 | ``` 41 | 42 | Note: = your MavZone username without `< >` 43 | 44 | - You should see all your personal F: drive files and folders if mapped correctly 45 | 46 | 7. Your C: drive is already mounted at `/mnt/c` 47 | 48 | ```bash 49 | ls /mnt/c 50 | ``` 51 | 52 | 8. VS Code is already installed on CS Lab computers 53 | 9. Follow the rest of the instructions on [Windows-CPP-README.md](Windows-CPP-README.md) to setup C++ Dev Environment including g++ compilers, git, jupyter notebook, etc. 54 | -------------------------------------------------------------------------------- /Windows/Username.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/Username.png -------------------------------------------------------------------------------- /Windows/VSCode/.DS_Store: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/.DS_Store -------------------------------------------------------------------------------- /Windows/VSCode/AdditionalTasks.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/AdditionalTasks.png -------------------------------------------------------------------------------- /Windows/VSCode/CloseStartTerminal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/CloseStartTerminal.png -------------------------------------------------------------------------------- /Windows/VSCode/CodeDestination.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/CodeDestination.png -------------------------------------------------------------------------------- /Windows/VSCode/CodeInstaller.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/CodeInstaller.png -------------------------------------------------------------------------------- /Windows/VSCode/DefaultShell.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/DefaultShell.png -------------------------------------------------------------------------------- /Windows/VSCode/DefaultShellBinBash.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/DefaultShellBinBash.png -------------------------------------------------------------------------------- /Windows/VSCode/InstallStep.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/InstallStep.png -------------------------------------------------------------------------------- /Windows/VSCode/PCProperties.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/PCProperties.png -------------------------------------------------------------------------------- /Windows/VSCode/README.md: -------------------------------------------------------------------------------- 1 | # VS Code Installation and Configuration on Windows WSL 2 | 3 | - recommended editor for writing C++ code, compiling and debugging 4 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 5 | 6 | ## VS Code Installation on Windows WSL 7 | 8 | - follow the instructions in [VSCode-Install-README.md](VSCode-Install-README.md) 9 | 10 | ## Configure Visual Studio Code for C++ Development 11 | 12 | - follow the instructions in [../../VSCode/VSCode-CPP-README.md](../../VSCode/VSCode-CPP-README.md) 13 | 14 | ## Configure Visual Studio Code for Python Development 15 | 16 | - follow the instructions in [../../VSCode/VSCode-Python-README.md](../../VSCode/VSCode-Python-README.md) 17 | 18 | ## Configure Integreted Bash Terminal 19 | 20 | - follow the instructions on [VSCode-Terminal-README.md](VSCode-Terminal-README.md) 21 | -------------------------------------------------------------------------------- /Windows/VSCode/Remote-WSL.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/Remote-WSL.png -------------------------------------------------------------------------------- /Windows/VSCode/StartMenu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/StartMenu.png -------------------------------------------------------------------------------- /Windows/VSCode/SystemType.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/SystemType.png -------------------------------------------------------------------------------- /Windows/VSCode/VSCode-Install-README.md: -------------------------------------------------------------------------------- 1 | # Visual Studio (VS) Code Installation Instruction on Windows 2 | 3 | ## Install VS Code on Windows 4 | 5 | 1. find the system type (32bit or 64bit or ARM) of your Windows system 6 | 1. search and run "This PC" -> Properties 7 | ![This PC Properties](PCProperties.png) 8 | 2. note system type 9 | ![System Type](SystemType.png) 10 | 11 | 2. download the right version of VS Code installer for your machine from here 12 | 1. on your browser go to [https://code.visualstudio.com/download](https://code.visualstudio.com/download) 13 | 14 | 2. if your system type is 32-bit, click 32 bit and if your system is 64-bit download 64-bit System Installer 15 | ![VS Code Installer](CodeInstaller.png) 16 | 17 | 3. run the dowloaded Installer program and follow the Setup wizard 18 | 1. select "I Accept the agreement" 19 | 2. select default destination folder 20 | ![Destination](CodeDestination.png) 21 | ![Start Menu](StartMenu.png) 22 | ![Additional Tasks](AdditionalTasks.png) 23 | ![Install](InstallStep.png) 24 | 25 | ## Launch VS Code App from Windows 26 | 27 | 1. run Ubuntu App/WSL to run Bash Termimal 28 | 2. enter the following command on Bash Terminal 29 | 30 | ```bash 31 | code . 32 | ``` 33 | 34 | ## Configure VS Code for WSL Ubuntu 35 | 36 | - if VS Code is configured properly both Ubuntu files and folders and Windows file system can be accessed easily from VS Code File -> Open Menu 37 | 38 | 1. run Ubuntu App to run Bash Termimal 39 | 2. enter the following command 40 | 41 | ```bash 42 | code . 43 | ``` 44 | 45 | 4. install Remote - WSL extension from Microsoft in WSL:Ubuntu 46 | - click on Extensions icon on the left pane 47 | - search Remote WSL 48 | - install Remote WSL by Microsoft 49 | ![Remote WSL Install](Remote-WSL.png) 50 | 51 | 5. Note that when VS Code is ran from WSL Ubuntu, you should see WSL:Ubuntu on the bottom left 52 | ![WSL:Ubuntu](WSL-Code.png) 53 | 54 | ## Launch VS Code App with Remote Extension 55 | 56 | 1. open Ubuntu Bash Termimal 57 | 2. enter the following command on the Ubuntu Bash Terminal 58 | 59 | ```bash 60 | code . 61 | ``` 62 | 3. you should see WSL:Ubuntu on the bottom left 63 | ![WSL:Ubuntu](WSL-Code.png) 64 | 65 | ## Configure Integreted Terminal on VS Code 66 | 67 | - follow the instructions on [VSCode-Terminal-README.md](VSCode-Terminal-README.md) 68 | -------------------------------------------------------------------------------- /Windows/VSCode/VSCode-Terminal-README.md: -------------------------------------------------------------------------------- 1 | # Configure Terminal on VS Code (WSL Ubuntu) 2 | 3 | ## Open Terminal on VS Code 4 | 5 | 1. open VS Code 6 | 2. make sure you see WSL:Ubuntu green box on the bottom left corner 7 | 3. click Terminal Tab and click New Terminal from menu list 8 | ![Open Terminal](CloseStartTerminal.png) 9 | 10 | ## Close Terminal on VS Code 11 | 12 | 1. click **trash can** icon on the terminal or click **x** button 13 | ![Open Terminal](CloseStartTerminal.png) 14 | 15 | ## Pick Default Shell 16 | 17 | 1. Click drop-down list on terminal window 18 | 2. click **Select Default Shell** 19 | 3. pick **/bin/bash** or **WSL ...** 20 | ![Select Default Shell](DefaultShellBinBash.png) -------------------------------------------------------------------------------- /Windows/VSCode/WSL-Code.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/WSL-Code.png -------------------------------------------------------------------------------- /Windows/VSCode/WSLCodeSecAccess.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/VSCode/WSLCodeSecAccess.png -------------------------------------------------------------------------------- /Windows/WSL/README.md: -------------------------------------------------------------------------------- 1 | 2 | # Enable WSL and Install Ubuntu App on Windows 10 and 11 3 | 4 | - Official Instruction for Windows 10: [https://docs.microsoft.com/en-us/windows/wsl/install-win10](https://docs.microsoft.com/en-us/windows/wsl/install-win10 5 | ) 6 | - Windows 10 and 11 allows Ubuntu installation as an app 7 | - follow this instruction to install WSL Ubuntu 8 | 9 | 1. turn Windows Subsystem for Linux features on following these steps: 10 | 1. search for "Turn Windows features on or off" App without quotes 11 | 12 | ![Search Feature](WSL-Search-Feature.png) 13 | 14 | 2. run the Windows Feature app 15 | 3. find and check Windows Subsystem for Linux towards the bottom of the list 16 | 17 | ![Windows Features](WSL-Check-Feature.png) 18 | 19 | 4. on Windows 11, Check the "Virtual Machine Platform" as well 20 | 5. click ok button 21 | - Note, it may take a while to apply the setting 22 | 6. restart your computer 23 | 24 | ![Restart](WSL-Restart.png) 25 | 26 | Note: If the above step don't work: 27 | 1. ensure virtualization is enabled in bios: 28 | 2. If errors are persisting, install the wsl2 kernel update here [https://docs.microsoft.com/en-us/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package](https://docs.microsoft.com/en-us/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package) (Under step 4) 29 | 30 | 2. install Ubuntu App following these steps 31 | 1. search for Microsoft Store and run it 32 | 33 | ![Microsoft Store](WSL-Store.png) 34 | 35 | 2. search and open Ubuntu App 36 | 37 | 3.1 On Windows 11, install the Ubuntu App 38 | 39 | ![Ubuntu Install](WSL-Ubuntu-Install.png) 40 | 41 | - Note, dowload may take some time depending on Internet speed (>4GB download) 42 | 43 | 3.2 On Windows 10, install the Ubuntu 20.04 LTS App 44 | 45 | 4. once installed, Launch the app 46 | 47 | ![Ubuntu Launch](WSL-Ubuntu-Launch.png) 48 | 49 | 5. when prompted, pick username and password 50 | - Notes: pick simple easy to remember username (e.g. user) and password (e.g. user) 51 | - this password is required to install other tools on Ubuntu 52 | - when entering password, you'll not see any feedback (* or dots); that's the Linux way of hiding password 53 | - just type password in the dark and hit enter; believe me it'll work! 54 | 55 | ![Ubuntu Account](WSL-Ubuntu-Account.png) 56 | 57 | 3. update WSL Ubuntu 58 | - type the following command on Bash Terminal 59 | 60 | ```bash 61 | sudo apt update 62 | ``` 63 | 64 | ![Update Ubuntu](WSL-Update.png) 65 | 66 | 4. How to run WSL/Ubuntu Bash Terminal 67 | - search Ubuntu or WSL and open it 68 | 69 | ![Run Ubuntu](WSL-Run-Ubuntu.png) -------------------------------------------------------------------------------- /Windows/WSL/WSL-Check-Feature.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Check-Feature.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Restart.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Restart.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Run-Ubuntu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Run-Ubuntu.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Search-Feature.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Search-Feature.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Store-Ubuntu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Store-Ubuntu.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Store.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Store.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Ubuntu-Account.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Ubuntu-Account.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Ubuntu-Install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Ubuntu-Install.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Ubuntu-Launch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Ubuntu-Launch.png -------------------------------------------------------------------------------- /Windows/WSL/WSL-Update.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WSL-Update.png -------------------------------------------------------------------------------- /Windows/WSL/WindowsDrive.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/Windows/WSL/WindowsDrive.png -------------------------------------------------------------------------------- /Windows/Windows-CPP-README.md: -------------------------------------------------------------------------------- 1 | # Setting up C++ Development Environment on Windows 2 | 3 | - using Windows Subsystem Layer (WSL) and Ubuntu App 4 | 5 | ## Tools 6 | 7 | - Visual Studio Code 8 | - Ubuntu Bash Terminal 9 | - git version control 10 | - GNU g++ compiler 11 | - Jupyter Notebook 12 | - C++ kernel for Notebook 13 | 14 | ## How to Find your username 15 | 16 | - you must know your Windows username to complete some of steps 17 | - follow these steps to find your username on Windows 18 | 19 | 1. on Windows search for Command Prompt app 20 | 2. run Command Prompt app 21 | ![Command Prompt](CmdPrompt.png) 22 | 3. type the following command on prompt, the output is your Windows username 23 | 24 | ```bash 25 | echo %username% 26 | ``` 27 | 28 | ![Username](Username.png) 29 | 30 | ## Install Visual Studio Code 31 | 32 | - recommended editor for writing C++ code, compiling and debugging 33 | - editor that has many built-in features including git, terminal and many third party extensions to support coding in many programming languages 34 | - follow the instruction provided in [VSCode/VSCode-Install-README.md](VSCode/VSCode-Install-README.md) 35 | 36 | ## Configure Visual Studio Code 37 | 38 | - follow the instructions in [../VSCode/VSCode-CPP-README.md](../VSCode/VSCode-CPP-README.md) 39 | 40 | ## Enable WSL and Install Ubuntu App 41 | 42 | - follow the instructions in [WSL/README.md](WSL/README.md) 43 | 44 | ## How to Run Ubuntu Bash Terminal/Shell 45 | 46 | - any time you need to run Ubuntu Bash Terminal (also called Shell), follow this step 47 | 1. search and run Ubuntu 48 | ![Run Ubuntu](WSL/WSL-Run-Ubuntu.png) 49 | 50 | ## Install C++ Compiler and relevant tools 51 | 52 | - follow the instructions in [../Linux/CPP-README.md](../Linux/CPP-README.md) 53 | 54 | ## Install Git 55 | 56 | - follow the instructions in [../Git/README.md](../Git/README.md) 57 | 58 | ## Configure Git 59 | 60 | - follow the instructions in [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 61 | 62 | ## Install Miniconda Python Package Manager 63 | 64 | - follow the instructions in [../Linux/Miniconda-README.md](../Linux/Miniconda-README.md) 65 | 66 | ## Install Jupyter Notebook 67 | 68 | - follow the instructions in [../Linux/Jupyter-README.md](../Linux/Jupyter-README.md) 69 | 70 | ## How to Run Jupyter Notebook Server 71 | 72 | 1. run Bash Terminal 73 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 74 | 75 | ```bash 76 | cd 77 | jupyter notebook # run jupyter notebook from the current working directory 78 | ``` 79 | 80 | 3. if a browser doesn’t open automatically, copy (highlight and release mouse) link shown on the Terminal and paste (Ctrl+v) it to a browser (e.g., Chrome) 81 | 82 | ## How to Stop Jupyter Notebook Server 83 | 84 | 1. to stop jupyter notebook, enter control+c keys on the same Terminal that's running Jupyter server 85 | 86 | ```bash 87 | control+c # press two buttons simultanesouly to stop jupyter notebook server 88 | ``` 89 | 90 | ## How to Access Windows C Drive Files and Folders from Ubuntu Bash Terminal 91 | 92 | 1. run Ubuntu Terminal 93 | 2. type the following command 94 | 95 | ```bash 96 | cd /mnt/c/Users/ 97 | ``` 98 | 99 | ![Access Windows](WSL/WindowsDrive.png) 100 | -------------------------------------------------------------------------------- /Windows/Windows-Python3-README.md: -------------------------------------------------------------------------------- 1 | # Setting up Python3 Development Environment on Windows 10 2 | 3 | - using Windows Subsystem Layer (WSL) and Ubuntu App 4 | 5 | ## Tools 6 | 7 | - Visual Studio Code 8 | - Ubuntu Bash Terminal 9 | - git version control 10 | - Python 3 11 | - Jupyter Notebook 12 | 13 | ## How to Find Windows 10 username 14 | 15 | - you must know your Windows username to complete some of steps 16 | - follow these steps to find your username on Windows 17 | 18 | 1. on Windows search for Command Prompt app 19 | 2. run Command Prompt app 20 | ![Command Prompt](CmdPrompt.png) 21 | 3. type the following command on prompt, the output is your Windows username 22 | 23 | ```bash 24 | echo %username% 25 | ``` 26 | 27 | ![Username](Username.png) 28 | 29 | ## Install Visual Studio Code 30 | 31 | - recommended editor for writing C++ code, compiling and debugging 32 | - editor that has many built-in features including git, terminal and many third party plugins to support many programming languages 33 | - follow the instruction provided in [VSCode/VSCode-Install-README.md](VSCode/VSCode-Install-README.md) 34 | 35 | ## Configure Visual Studio Code 36 | 37 | - follow the instructions in [../VSCode/VSCode-Python-README.md](../VSCode/VSCode-Python-README.md) 38 | 39 | ## Enable WSL and Install Ubuntu App 40 | 41 | - follow the instructions in [WSL/README.md](WSL/README.md) 42 | 43 | ## Run Ubuntu Bash Terminal/Shell 44 | 45 | - any time you need to run Ubuntu Bash Terminal (also called Shell), follow this step 46 | 1. search and run Ubuntu 47 | ![Run Ubuntu](WSL/WSL-Run-Ubuntu.png) 48 | 49 | ## Install Git 50 | 51 | - follow the instructions in [../Git/README.md](../Git/README.md) 52 | 53 | ## Configure Git 54 | 55 | - follow the instructions in [../Git/Git-Config-README.md](../Git/Git-Config-README.md) 56 | 57 | ## Install miniconda Python Package Manager 58 | 59 | - follow the instructions in [../Linux/Miniconda-README.md](../Linux/Miniconda-README.md) 60 | 61 | ## Install Jupyter Notebook 62 | 63 | - follow the instructions in [../Linux/Jupyter-README.md](../Linux/Jupyter-README.md) 64 | 65 | ## How to Run Jupyter Notebook server 66 | 67 | 1. run Bash Terminal 68 | 2. change the working directory to the folder that contains your notebooks or should contain when you create new notebook 69 | 70 | ```bash 71 | cd 72 | jupyter notebook # run jupyter notebook from the current working directory 73 | ``` 74 | 75 | 3. if a browser doesn’t open, copy and paste (Ctrl+v) link (just highlight and release mouse) shown on terminal to a browser 76 | 77 | ## How to Stop Jupyter Notebook server 78 | 79 | 1. to stop jupyter notebook, enter control+c keys on the same Terminal that's running Jupyter server 80 | 81 | ```bash 82 | control+c # press two buttons simultanesouly to stop jupyter notebook server 83 | ``` 84 | 85 | ## How to Access Windows C: files and folders from Ubuntu Bash Terminal 86 | 87 | 1. run Ubuntu Terminal 88 | 2. type the following command 89 | 90 | ```bash 91 | cd /mnt/c/Users/ 92 | ``` 93 | 94 | ![Access Windows](WSL/WindowsDrive.png) 95 | 96 | -------------------------------------------------------------------------------- /resources/AddSSH.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/AddSSH.png -------------------------------------------------------------------------------- /resources/CPPExtension.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/CPPExtension.png -------------------------------------------------------------------------------- /resources/GitHub-profile.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/GitHub-profile.png -------------------------------------------------------------------------------- /resources/GitHubSSH.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/GitHubSSH.png -------------------------------------------------------------------------------- /resources/Miniconda-Install.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/Miniconda-Install.png -------------------------------------------------------------------------------- /resources/SSHTest.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/SSHTest.png -------------------------------------------------------------------------------- /resources/VSCodePythonExtension.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/VSCodePythonExtension.png -------------------------------------------------------------------------------- /resources/View-Extensions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/View-Extensions.png -------------------------------------------------------------------------------- /resources/mac_uname.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/rambasnet/DevEnvSetup/ab55ff6002fcb117e398792fd9f52b4cebde0625/resources/mac_uname.png --------------------------------------------------------------------------------