microsoft / codespaces-teaching-template-py Goto Github PK

Hi all 👋

We need create a Brazilian Portuguese translation and make sure it is working according to the English content.

Main folder: https://github.com/education/codespaces-teaching-template-py

Please compare each file below to its original in English and if required, please send a PR.

To send the localization, please, create the folder pt-BR under translations.

There are mentions abour NodeJS in the devcontainer directory, remove those references as they are not needed

This needs to go in the Dev Container configuration

Hello! I'm trying to get started using this template, but I'm having issues creating a basic script and running it. I also see errors in the file itself:

Give the repository a try with Codespaces and report any feedback

• Head over to https://github.com/microsoft/codespaces-teaching-template-py/ and go through the README
• Follow the README and create a new Codespace
• Use the example-notebook.ipynb and try out the cells
• Capture inconsistencies and list possible improvements

See the docs on how to do this, add it to the top of the readme: https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-codespaces-badge

Getting problems trying to install azure-opendatasets

Collecting zipp>=3.1.0
  Using cached zipp-3.8.1-py3-none-any.whl (5.6 kB)
Using legacy 'setup.py install' for pyspark, since package 'wheel' is not installed.
Using legacy 'setup.py install' for fusepy, since package 'wheel' is not installed.
Installing collected packages: fusepy, backports.weakref, azureml-dataprep-rslex, azureml-dataprep-native, azure-common, applicationinsights, zipp, websocket-client, urllib3, typing-extensions, tabulate, pyyaml, pyspark, PySocks, pyrsistent, PyJWT, pycparser, portalocker, pkgutil-resolve-name, pkginfo, pathspec, oauthlib, numpy, jsonpickle, jmespath, jeepney, isodate, idna, humanfriendly, distro, contextlib2, cloudpickle, charset-normalizer, certifi, bcrypt, backports.tempfile, attrs, argcomplete, scipy, requests, pyarrow, pandas, knack, importlib-resources, dotnetcore2, cffi, requests-oauthlib, pynacl, jsonschema, docker, cryptography, azure-core, SecretStorage, pyopenssl, paramiko, msrest, azure-mgmt-core, adal, ndg-httpsclient, msrestazure, msal, azure-mgmt-storage, azure-mgmt-resource, azure-mgmt-keyvault, azure-mgmt-containerregistry, azure-mgmt-authorization, msal-extensions, azure-graphrbac, azureml-core, azure-identity, azureml-telemetry, azureml-dataprep, azureml-dataset-runtime, azureml-opendatasets
  Running setup.py install for fusepy ... error
  error: subprocess-exited-with-error
  
  × Running setup.py install for fusepy did not run successfully.
  │ exit code: 1
  ╰─> [10 lines of output]
      running install
      running build
      running build_py
      creating build
      creating build/lib
      copying fuse.py -> build/lib
      running install_lib
      copying build/lib/fuse.py -> /home/vscode/venv/lib/python3.8/site-packages
      byte-compiling /home/vscode/venv/lib/python3.8/site-packages/fuse.py to fuse.cpython-38.pyc
      error: [Errno 13] Permission denied: '/home/vscode/venv/lib/python3.8/site-packages/__pycache__/fuse.cpython-38.pyc.140528026631728'
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

× Encountered error while trying to install package.
╰─> fusepy

note: This is an issue with the package mentioned above, not pip.
hint: See above for output from the failure.

Add a section for producing feedback and what the process looks like.

So that creating the codespace is faster. Use the docs as a reference https://docs.github.com/en/codespaces/prebuilding-your-codespaces/configuring-prebuilds

I recommend opening the example notebook to understand what is included in the repository (e.g. there is no API or HTTP server). Some high-level items to address:

• update Codespaces template section to mention the Jupyter Notebook + Pandas
• on "Run it" section, use a link for the template (full link is https://github.com/microsoft/codespaces-teaching-template-py/generate )
• Step 2 has a nested single step
• Update "Challenges" with "Next steps" or similar. The "challenge" word is too similar to "problem"

Using Copilot, add instructions on how to create a lesson using GitHub Copilot. Use a new Jupyter Notebook that demonstrates using Copilot to write in Markdown as well as the Python cells to expand further on the actual lessons.

Hi all 👋

We need review the existing Spanish translation and make sure it is working according to the English content.

Main folder: https://github.com/education/codespaces-teaching-template-py

Please compare each file below to its original in English and if required, please send a PR.

The localized files should be in the translations/es folder.

🚀After your review, if you find that there is no need to submit a pull request with file changes, please comment on this issue with the status DONE for each file.

That means adding dependencies to a requirements.txt file:

• ipykernel
• ipywidgets

And on VSCode config we need to:

• install Jupyter externsions + Python.

Apparently flake8 has some soon to be deprecated settings:

The initial README for an educator should cover:

• What is Codespaces and why is it useful
• Why use it in a classroom
• What this templates comes with (e.g. Python 3.8, Jupyter Notebook support)
• How to modify for anything else
• Extensions are enabled and VSCode is pre-configured
• Why this repo is a template and how to use templates (maybe?)

Beyond the dependencies, include examples on what that looks in the Jupyter Notebook. The idea is to get an educator some "out-of-the-box" experience when entering a codespace with everything ready and available to work with Python