Pygame

.devcontainer.json

@@ -0,0 +1,89 @@
+// (delete the above line to manage this file manually)
+//////////////////////////////////////////////////////////////
+//
+// This file provides configuration options so that a PreTeXt 
+//   project can be edited and built using GitHub's Codespaces.
+// It is recommended to keep this in your repository even if you
+//   do not use this feature, as it will allow other to explore 
+//   your project easily.   
+// This file will be automatically generated by PreTeXt with the 
+//   latest updates unless you remove the first comment line above.
+//
+///////////////////////////////////////////////////////////////
+
+// commented out because we're not using this but ptx generates it automatically.
+
+// {
+//   "name": "PreTeXt-Codespaces",
+
+//   // This Docker image includes some LaTeX support, but is still not to large.  Note that if you keep your codespace running, it will use up your GitHub free storage quota.  Additional options are listed below.
+//   "image": "oscarlevin/pretext:small",
+//   // If you need to generate more complicated assets (such as sageplots) or use additional fonts when building to PDF, comment out the above line and uncomment the following line.
+//   // "image": "oscarlevin/pretext:full",
+//   // If you only intend to build for web and don't have any latex-image generated assets, you can use a smaller image:
+//   // "image": "oscarlevin/pretext:lite",
+
+//   // Add gh cli as a feature (to support codechat)
+//   "features": {
+//     "ghcr.io/devcontainers/features/github-cli:1": {}
+//   },
+
+//   // Respect the project's designated dependencies
+//   "postCreateCommand": "pip install -r requirements.txt",
+
+//   // Port forwarding
+//   // ---------------
+//   // This is needed by the CodeChat Server.
+//   "forwardPorts": [
+//     // The port used for a Thrift connection between the VSCode CodeChat
+//     // extension and the CodeChat Server.
+//     27376,
+//     // The port used for an HTTP connection from the CodeChat Client to
+//     // the CodeChat Server.
+//     27377,
+//     // The port used by a websocket connection between the CodeChat
+//     // Server and the CodeChat Client.
+//     27378
+//   ],
+//   // See the [docs](https://containers.dev/implementors/json_reference/#port-attributes).
+//   "portsAttributes": {
+//     "27376": {
+//       "label": "VSCode extension <-> CodeChat Server",
+//       "requireLocalPort": true
+//     },
+//     "27377": {
+//       "label": "CodeChat Client",
+//       "requireLocalPort": true
+//     },
+//     "27378": {
+//       "label": "CodeChat Client<->Server websocket",
+//       "requireLocalPort": true
+//       // This port needs to be public; however, there's no way to specify port visibility here. See `server.py` in the CodeChat Server for details.
+//     }
+//   },
+
+//   // Configure tool-specific properties.
+//   "customizations": {
+//     "codespaces": {
+//       "openFiles": ["source/main.ptx"]
+//     },
+//     "vscode": {
+//       "settings": {
+//         "editor.quickSuggestions": {
+//           "other": "off"
+//         },
+//         "editor.snippetSuggestions": "top",
+//         "xml.validation.enabled": false,
+//         "CodeChat.CodeChatServer.Command": "CodeChat_Server"
+//       },
+//       "extensions": [
+//         "ms-vscode.live-server",
+//         "oscarlevin.pretext-tools",
+//         "CodeChat.codechat"
+//       ]
+//     }
+//   }
+
+//   // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+//   // "remoteUser": "root"
+// }

.devcontainer/devcontainer.json

@@ -0,0 +1,57 @@
+{
+  "name": "PreTeXt-Codespaces",
+
+  // This Docker image includes some LaTeX support, but is still not to large.  Note that if you keep your codespace running, it will use up your GitHub free storage quota.  Additional options are listed below.
+  "image": "oscarlevin/pretext:small",
+  // If you need to generate more complicated assets (such as sageplots) or use additional fonts when building to PDF, comment out the above line and uncomment the following line.
+  // "image": "oscarlevin/pretext:full",
+  // If you only intend to build for web and don't have any latex-image generated assets, you can use a smaller image:
+  // "image": "oscarlevin/pretext:lite",
+
+
+
+  // The following was the previous version of this file, which used the Codespaces base image.  It is still available for reference, but is not recommended.
+  // "image": "mcr.microsoft.com/devcontainers/python:3",
+  // "features": {
+  //   "ghcr.io/devcontainers/features/node:1": {},
+  //   "ghcr.io/rocker-org/devcontainer-features/pandoc:1": {}
+  // },
+  // "forwardPorts": [
+  // 	27377,
+  // 	27378
+  // ],
+  // "portsAttributes": {
+  // 	"27378": {
+  // 		"label": "CodeChat",
+  // 		"onAutoForward": "openPreview",
+  // 		"requireLocalPort": true,
+  // 		"elevateIfNeeded": true,
+  // 		"protocol": "https"
+  // 	}
+  // },
+  // "onCreateCommand": "pip install pretext",
+  // // Use 'postCreateCommand' to run commands after the container is created.
+  // "postCreateCommand": "sudo bash ./.devcontainer/postCreateCommand.sh",
+
+  // Configure tool-specific properties.
+  "customizations": {
+    "codespaces": {
+      "openFiles": [
+        "source/main.ptx"
+      ]
+    },
+    "vscode": {
+      "settings": {
+        "editor.quickSuggestions": {
+          "other": "off"
+        },
+        "editor.snippetSuggestions": "top",
+        "xml.validation.enabled": false
+      },
+      "extensions": ["ms-vscode.live-server", "oscarlevin.pretext-tools"]
+    }
+  }
+
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
+}

.github/workflows/pretext-cli.yml

@@ -0,0 +1,94 @@
+# (delete the above line to manage this file manually)
+
+# commented out because we're not using this but ptx generates it automatically.
+
+# name: PreTeXt-CLI Actions
+# on:
+#     # Runs on pull requests
+#     pull_request:
+#         branches: ["*"]
+#     # Runs on pushes to main
+#     push:
+#         branches: ["main"]
+#     # Runs on demand
+#     workflow_dispatch:
+
+# jobs:
+#     build:
+#         runs-on: ubuntu-latest
+#         container: oscarlevin/pretext:full
+
+#         steps:
+#             - name: Checkout source
+#               uses: actions/checkout@v4
+
+#             - name: install deps
+#               run: pip install -r requirements.txt
+
+#             - name: build deploy targets
+#               run: pretext build --deploys
+#             - name: stage deployment
+#               run: pretext deploy --stage-only
+
+#             - name: Bundle output/stage as artifact
+#               uses: actions/upload-artifact@v4
+#               with:
+#                   name: deploy
+#                   path: output/stage
+
+#     deploy-cloudflare:
+#         runs-on: ubuntu-latest
+#         needs: build
+#         if: vars.CLOUDFLARE_PROJECT_NAME != ''
+#         permissions:
+#           contents: read
+#           deployments: write
+
+#         steps:
+#             - name: Download artifact
+#               uses: actions/download-artifact@v4
+#               with:
+#                   name: deploy
+#                   path: deploy
+#             - name: Create 404.html
+#               run: echo "404 page not found" >> deploy/404.html
+#             - name: Publish to Cloudflare
+#               uses: cloudflare/pages-action@v1
+#               with:
+#                   apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+#                   accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+#                   projectName: ${{ vars.CLOUDFLARE_PROJECT_NAME }}
+#                   gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+#                   branch:  ${{ github.head_ref || github.ref_name }}
+#                   directory: deploy
+
+#     deploy-ghpages:
+#         runs-on: ubuntu-latest
+#         needs: build
+#         if: vars.PTX_ENABLE_DEPLOY_GHPAGES == 'yes' && github.ref == format('refs/heads/{0}', github.event.repository.default_branch)
+#         permissions:
+#             contents: read
+#             pages: write
+#             id-token: write
+#         concurrency:
+#             group: "page"
+#             cancel-in-progress: false
+#         environment:
+#             name: github-pages
+#             url: ${{ steps.deployment.outputs.page_url }}
+#         steps:
+#             - name: Download website artifact
+#               uses: actions/download-artifact@v4
+#               with:
+#                   name: deploy
+#                   path: deploy
+#             - name: Setup GitHub Pages
+#               id: check
+#               uses: actions/configure-pages@v4
+#             - name: Upload artifact
+#               uses: actions/upload-pages-artifact@v3
+#               with:
+#                   path: deploy
+#             - name: Deploy to Github Pages
+#               id: deployment
+#               uses: actions/deploy-pages@v4

.gitignore

@@ -1,3 +1,4 @@
+# (delete the above line to manage this file manually)
 __pycache__/
 build_info
 build
@@ -19,3 +20,107 @@ beta
 output
 published
 pdf
+venv/
+cli.log
+
+# Boilerplate list of files in a PreTeXt project for git to ignore
+# ensure this file is tracked
+!.gitignore
+
+# don't track unpublished builds or stage (note: Runestone uses `published`)
+output
+published
+
+# don't track assets generated from source
+generated-assets
+
+# don't track the executables.ptx file
+executables.ptx
+
+# don't track node packages
+node_modules
+
+# don't track error logs
+.error_schema.log
+logs
+
+# don't track OS related files (windows/macos/linux)
+.DS_Store
+.DS_Store?
+._*
+.AppleDouble
+.LSOverride
+.Spotlight-V100
+.Trashes
+Icon
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+*.lnk
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+[Dd]esktop.ini
+.directory
+.fuse_hidden*
+.Trash-*
+.nfs*
+
+# Don't include VSCode generated files
+.vscode
+*.code-workspace
+
+# Don't inlucde SublimeText files
+# Cache files for Sublime Text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+# Workspace files are user-specific
+*.sublime-workspace
+
+# Project files should be checked into the repository, unless a significant
+# proportion of contributors will probably not be using Sublime Text
+*.sublime-project
+
+# SFTP configuration file
+sftp-config.json
+sftp-config-alt*.json
+
+# Package control specific files
+Package Control.last-run
+Package Control.ca-list
+Package Control.ca-bundle
+Package Control.system-ca-bundle
+Package Control.cache/
+Package Control.ca-certs/
+Package Control.merged-ca-bundle
+Package Control.user-ca-bundle
+oscrypto-ca-bundle.crt
+bh_unicode_properties.cache
+
+# Sublime-github package stores a github token in this file
+# https://packagecontrol.io/packages/sublime-github
+GitHub.sublime-settings
+
+
+# Don't include Dropbox settings and caches
+.dropbox
+.dropbox.attr
+.dropbox.cache
+
+# Don't track codechat config (will be generated automatically)
+codechat_config.yaml
+
+# Don't track deprecated workflows
+.github/workflows/deploy.yml
+.github/workflows/test-build.yml

README.md

@@ -0,0 +1,23 @@
+# How to Think Like a Computer Scientist: Mines Edition
+This is a fork of the original [thinkcspy](https://github.com/runestoneinteractive/thinkcspy) made for Colorado School of Mines CSCI128:
+
+> This project began with the original How to Think Like a Computer Scientist text by Jeffrey Elkner, Peter Wentworth, Allen B. Downey, Chris Meyers, and Dario Mitchell. Since 2011 Brad Miller, David Ranum, Barbara Ericson, Mark Guzdial, and many others have built on the text making it interactive.
+
+> Programming is not a "spectator sport". It is something you do, something you participate in. It would make sense, then, that the book you use to learn programming should allow you to be active. That is our goal.
+
+> This book is meant to provide you with an interactive experience as you learn to program in Python. You can read the text, watch videos, and write and execute Python code. In addition to simply executing code, there is a unique feature called 'codelens' that allows you to control the flow of execution in order to gain a better understanding of how the program works.
+
+*Note: RST is deprecated, and the new pretext sources are in the pretext folder, but we will keep the _sources (old RST folder) directory until we are 100% sure that the book has been converted correctly and as thoroughly as possible.*
+
+## Development Environment
+Create and activate a virtual environment and install dependencies:
+
+`python -m venv venv`
+
+`source venv/bin/activate`
+
+`pip install -r requirements.txt`
+
+Then build the textbook: `pretext build web`
+
+..and finally, run the web server: `pretext view`