Goal: To be able to run Scheme on Windows, particularly the flavor “Simply Scheme”.
There is a great computer science book called Simply Scheme by Brian Harvey and Matthew Wright. Professor Brian Harvey also taught a great class CS61A at the University of California, Berkeley. Our goal is to be able to run Simply Scheme so that we can follow along the book and its exercises.
Illustrated by Polly Jordan, from page 4 of the book Simply Scheme
Simply Scheme uses custom Scheme commands to teach some important programming concepts. These commands are not available on regular Scheme but their value cannot be undermined in helping to learn more easily concepts taught in the book like recursion, higher order functions, composition, abstraction and more.
The best and easiest way to run scheme on Windows is via DrRacket from the Racket language site. Racket download provides a nice integrated learning environment DrRacket and it can be extended to run Simply Scheme via a package “Danny Yoo’s Simply Scheme”.
2. Start Racket, then click on File -> Package Manager
3. Click the tab “Available from Catalog”, then type “simply” in the filter. You should see “simply-scheme” listed. Select “simply-scheme” and click the Install button.
4. After installation, close the dialog box and restart the DrRacket
5. Choose Language -> New Language from the menu bar. Then select Simply Scheme as shown below.
6. You should be able to run Simply Scheme programs now. Here is an example program that implements “Pig Latin”.
7. Bonus: If you like Emacs Key bindings then enable it in Edit -> Preferences -> Editing. Make sure the option is “unchecked” for Enable keybindings in menus.
Enjoy Simply Scheme!
I remind myself: It can be easy to learn new languages and syntax. Then tedious to keep up to date with endless frameworks. But great programming concepts are timeless, so it’s a good idea to learn them well.
This post explains how to install and configure Apache and PHP on Windows. Sure, there are convenient options like: Bitnami WAMP Stack, WampServer or XAMPP. But over the years I found that installing each stack separately is more reliable and provides greater flexibility. You will probably also want MariaDB for a database which you can download and install from here: https://mariadb.org. The database itself doesn’t have to be configured directly with either Apache or PHP so there are no steps provided here for the database. You only need to enable a line in PHP ini for PHP to provide the database functions.
Versions
Windows 10, 64-bit
PHP 7.4.x
Apache 2.4.x
PHP
Download PHP from the php.net Windows download page. We will use PHP as an Apache module, so make sure to get the Thread Safe version.
After downloading the zip file, unzip it to a convenient location on your hard drive. I usually keep all my stand-alone programs that I use under ~/bin folder. So the location of my unzipped PHP folder is: C:\Users\sanji\bin\php-7.4.27-Win32-vc15-x64
Copy the file php.ini-development and rename it to php.ini, then edit it:
# The default input vars, upload and post sizes are small
# so I make sure they are big enough
max_input_vars = 5000
post_max_size = 100M
upload_max_filesize = 100M
max_file_uploads = 50
# Only for local development machine, I set the max execution time at 120 seconds
# instead of the default 30 seconds, because some PHP application updates fail
# locally without a high enough timeout threshold
max_execution_time = 120
# I usually set the full-path because sometimes just specify "ext" doesn't work
extension_dir = "C:\Users\sanji\bin\php-7.4.27-Win32-vc15-x64\ext"
# I have the following extensions enabled which
# is also good for WordPress development
extension=bz2
extension=curl
extension=fileinfo
extension=gd2
extension=mbstring
extension=exif ; Must be after mbstring as it depends on it
extension=mysqli
extension=openssl
extension=pdo_mysql
I also added the location “C:\Users\sanji\bin\php-7.4.27-Win32-vc15-x64” to the Path in my Windows Environment Variables under System Properties.
Nothing more needs to be configured for PHP. Let’s get Apache installed and configured.
Apache
Apache binaries are not provided by the official Apache HTTPD project. You can can get either from ApacheHaus or Apache Lounge. Here is the download page screenshot of the binary for Apache 2.4.52 x64 on ApacheHaus:
After downloading the zip file, unzip it at a convenient location on your drive. The full path on my machine is: C:\Users\sanji\bin\Apache24. For convenience, I also added to the environment Path variable “C:\Users\sanji\bin\Apache24\bin” via Windows System Properties.
The file “Apache24\conf\httpd.conf” needs to be edited.
# Change the following to the location where you
# unzipped the downloaded Apache zip file
Define SRVROOT "/Users/sanji/bin/Apache24"
# I use port 8080 instead of the default port 80
Listen 8080
# I use virtual hosts, so following needs to be enabled
# and the httpd-vhosts.conf file included
LoadModule vhost_alias_module modules/mod_vhost_alias.so
Include conf/extra/httpd-vhosts.conf
# The following modules are also enabled
LoadModule rewrite_module modules/mod_rewrite.so
# The following settings enable PHP
LoadModule php7_module "/Users/sanji/bin/php-7.4.27-Win32-vc15-x64/php7apache2_4.dll"
<FilesMatch \.php$>
SetHandler application/x-httpd-php
</FilesMatch>
PHPIniDir "/Users/sanji/bin/php-7.4.27-Win32-vc15-x64"
# I also had to add the following line to get curl working with PHP
# (aside from enabling curl in php.ini)
LoadFile "/Users/sanji/bin/php-7.4.27-Win32-vc15-x64/libssh2.dll"
ApacheHaus uses “extra/httpd-ahssl.conf” for SSL configuration. I use the port 4430. Here is my “Apache24\conf\extra\httpd-ahssl.conf” change:
# I changed the default port 443 to 4430
Listen 4430 https
Finally here is my vhosts configuration file.
# I serve all my sites from the folder "C:\Users\sanji\pdn"
# So the following entry affects all my development sites
<Directory "/Users/sanji/pdn">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
DirectoryIndex index.html index.php
</Directory>
# I use port 4430 for SSL
# Here are settings for a site called viaye.san, you can create your own by
# editing the C:\Windows\System32\drivers\etc\hosts file
# To generate and self-sign SSL certificates, please see
# https://oak.dev/2021/02/03/create-a-self-signed-certificate-on-windows-for-local-development/
# I like to keep my docroot under "www" and the
# access and error logs under the "logs" folder
<VirtualHost *:4430>
SSLEngine on
ServerName viaye.san
DocumentRoot "/Users/sanji/pdn/viaye/www"
ErrorLog "/Users/sanji/pdn/viaye/logs/error.log"
CustomLog "/Users/sanji/pdn/viaye/logs/access.log" common
SSLCertificateFile "/Users/sanji/_pepper/_ssl_local/viaye.san/cert.pem"
SSLCertificateKeyFile "/Users/sanji/_pepper/_ssl_local/viaye.san/server.key"
</VirtualHost>
That’s it for configuration. The final step is to add httpd as a Windows service. Head over to C:\Users\sanji\bin\Apache24\bin and run:
httpd -k install
You can now start, restart the Apache HTTPD server from the Windows Services panel as seen below:
We need to a create self-signed certificate for local development so that the local development server behaves similar to a live production server. Additionally the certificate must not generate warnings in the browser (Chromium based browsers only) that the certificate is self-signed and can’t be trusted.
Developing locally with plain http is just fine. But sometimes we need to mimic development with production so that TLS encryption via https is available also on our development machines. We also don’t want to see ugly security warnings from browsers. The following article shows how to create self-signed certificates on Windows that doesn’t generate browser warnings on Chrome and other Chromium based browsers.
The article is a bit long but please grab a coffee and follow along. The result is worth the effort as you only need to generate the certificate once in a very long time. I set the expiry date 10 years in the future for the domains I create for local development.
Goal: Create an imaginary domain pdb.oak.san with a self-signed certificate that works on major browsers (except Firefox) without generating a warning. Works great on Chromium based browsers like Chrome, Canary, Microsoft Edge and Opera, IE.
Step 1: Setup hostname
Open Notepad in Administrator mode: Click Windows Start icon in task bar and start typing Notepad, right click the Notepad icon and click Run as administrator
Inside Notepad, open the file: C:\Windows\System32\drivers\etc\hosts
We want to create an imaginary domain: pdb.oak.san, add the following line to the hosts file:
127.0.0.1 pdb.oak.san
Save the file and close
Step 2: Create a client-side self-signed certificate
Open PowerShell in Administrator mode: Click Windows Start icon in task bar and start typing PowerShell, right click the PowerShell icon and click Run as administrator
Type the following to generate a self-signed certificate for domain pdb.oak.san with friendly name pdb.oak.san that expires after 10 years:
Step 3: Copy the certificate created in Step 2 to Trusted Root Certification Authorities, then export it
Open Management Console for Certificates: Click Windows Start icon and start typing certificates, click Manage computer certificates
On the left panel, click Personal -> Certificates, you should see the client-side certificate for pdb.oak.san created above in Step 2
On the left panel, open the tree for (but don’t left click the folder) Certification Authorities -> Certificates
With the right mouse button, drag and drop the certificate to the location opened in the previous step
Now export the certificate: right-click the certificate, All Tasks -> Export…
Welcome screen appears, click Next
Select Yes, export the private key, click Next
Keep the default values for .PFX, click Next
Type a password for the private key, click Next
Browse for a location and give the certificate a name (cert.pfx), click Next
Finally click Finish
You will get a notice that the export was successful
Step 4: Create the server-side certificate and key
Pre-requisite: you need to have OpenSSL https://www.openssl.org/ installed. Since you are a developer and on Windows, it’s highly likely you already have https://git-scm.com/ installed, so you should also have OpenSSL installed. Otherwise we recommend installing Git for Windows with Git Bash support – this will automatically also install OpenSSL.
Open Command Prompt and change directory to the location where you exported the certificate with .PFX extension cert.pfx in Step 3 above.
Type the following commands in the Command Prompt one by one. When prompted for password, type the password you used in Step 3 above when exporting the .PFX certificate.
You should now have the following files in the folder, we will be using the cert.pem and server.key files. You can delete the other files if you want to.
You can use Apache or Nginx to test the https connection for the pdb.oak.san domain. We will create a simple Go server as it can be created really fast with a few lines of code. Create a file called main.go and type the code below. Make sure cert.pem and server.key is in the same folder as the main.go file.
package main
import (
"fmt"
"net/http"
)
func handleHome(w http.ResponseWriter, r *http.Request) {
_, _ = fmt.Fprintln(w, "Home page to test the TLS cert and secure https connection")
}
func main() {
http.HandleFunc("/", handleHome)
s:=http.Server{}
_ = s.ListenAndServeTLS("cert.pem", "server.key")
}
Build and run the Go server: go build main.go, then run the resulting executable program main.exe
Now if we visit https://pdb.oak.san/ in a browser, we can see the home page with the following content: “Home page to test the TLS cert and secure https connection”
We can also check the certificate by clicking on the lock icon in the browser address bar:
For Nginx Users
To test on Nginx instead of writing Go code, you can use the configuration below.
Make sure to copy your cert.pem and server.key to the locations for ssl_certificate and ssl_certificate_key.
Folder paths like C:\Users\sanji\pdn\pdb.oak.san\www should of course match the locations in your own computer.
server {
listen 443 ssl;
server_name pdb.oak.san;
root C:\Users\sanji\pdn\pdb.oak.san\www;
access_log C:\Users\sanji\pdn\pdb.oak.san\logs\access.log;
error_log C:\Users\sanji\pdn\pdb.oak.san\logs\error.log;
index index.html;
ssl_certificate C:\Users\sanji\pdn\pdb.oak.san\ssl\cert.pem;
ssl_certificate_key C:\Users\sanji\pdn\pdb.oak.san\ssl\server.key;
}
The video below shows the steps I took to setup SSL on an imaginary domain on my local machine. The video is 20 minutes; maybe I could have been done the video in 10 minutes or less. But here I am showing the actual problems I am running into and the steps I am taking to solve them.
Setting up domains, servers and certificates in real-life is not without problems. This is not a scripted video. It shows the problems I face and how I resolve them.
The reason to call this post “definitive” is because it contains the exact information (without adding anything extra) for implementing WordPress language files (aka internationalization).
The 4-Steps
1. The plugin entry point “.php” file needs the following Text Domain WordPress directive, considering foo-bar as the plugin name:
* Text Domain: foo-bar
Where is the The Text Domain used? For example, in the 2nd argument of _e() and __() functions.
2. Create a “lang” folder (to put all your .mo and .po translation files) under your plugin folder:
~/wp-content/plugins/foo-bar/lang
Folder name “lang” is preferred to “languages” because it’s shorter.
3. Create the .mo and .po language translation files via PoeEdit and make sure to prefix them with the plugin name:
foo-bar-en_US.mo
foo-bar-en_US.po
foo-bar-fr_FR.mo
foo-bar-fr_FR.po
PoeEdit is a bit awkward to use at first, but it gets the job done. Beginners need to refer to a quick-guide on how to generate the .mo and .po files.
4. Load the language translation files from the plugin entry point “.php” file like this (the folder pointing to the language files is a relative path):
add_action('plugin_loaded', function () {
load_plugin_textdomain('foo-bar', false, 'foo-bar/lang');
});
For better code organization a static function under a class is highly recommended, instead of the anonymous function above (the 2nd argument to add_action).
2 Common Mistakes to Avoid
Don’t forget to prefix the language files with the plugin name (see step 1 above).
Don’t forget to specify relative folder and not absolute folder (see step 4 above).
In my opinion the real-offensive element is actually the browser notification banner that gets attached to the media control popup. This is what I mean:
Both Chrome and Firefox notification banner attaches to this volume popup. Disable it like this:
Chrome
In Chrome address bar, type chrome://flags/
Then find the setting Hardware Media Key Handling and set it to Disabled.
Firefox
In Firefox address bar, type about:config
Then set media.hardwaremediakeys.enabled to false
Enjoy just the volume control bar without the ugly offensive banner!
Objective: You have multiple Visual Studio projects (using the same technology stack) under a single git repository and you need to manually add a .gitignore file.
Instead of copy/pasting an existing .gitignore file, let Visual Studio generate it for you.
2 Steps to Add the .gitignore File via Visual Studio
Inside Visual Studio, open your solution and click the tab “Team Explorer”
Then click “Add” under Ignore & Attributes Files -> Ignore File
Steps to add .ignore file in the Team Explorer tabAfter successfully adding the .gitignore file
This will add the .gitignore file in your root git repository folder. So you should not need to repeat the projects for other Visual Studio projects in the same folder (provided they are all using the same technology stack).
To upgrade a Phoenix project, edit mix.exs, look for the line (was upgraded from 1.5.1 to 1.5.4):
{:phoenix, "~> 1.5.4"},
To upgrade the Phoenix installer itself, run in the terminal (example shows upgrading phx_new 1.5.3 to phx_new 1.5.4):
> mix local.phx
Resolving Hex dependencies...
Dependency resolution completed:
New:
phx_new 1.5.4
* Getting phx_new (Hex package)
All dependencies are up to date
Compiling 10 files (.ex)
warning: redefining module Mix.Tasks.Local.Phx (current version loaded from ~/.mix/archives/phx_new-1.5.3/phx_new-1.5.3/ebin/Elixir.Mix.Tasks.Local.Phx.beam)
lib/mix/tasks/local.phx.ex:1
Generated phx_new app
Generated archive "phx_new-1.5.4.ez" with MIX_ENV=prod
Found existing entry: ~/.mix/archives/phx_new-1.5.3
Are you sure you want to replace it with "phx_new-1.5.4.ez"? [Yn] y
* creating c:/Users/sanji/.mix/archives/phx_new-1.5.4
> mix phx.new --version
Phoenix v1.5.4
Finally, if you updated mix.exs file for any project, run:
Write a list comprehension that finds all the Pythagorean triples for right triangles with sides shorter than 100. A Pythagorean triple is three integers a, b, and c, where a² + b² = c².
In Elixir it takes a line of code with pattern-matching to produce this.
Note the 3 patterns below, nested loops, scary I know. But at least rather than starting from 1 each time, we loop through 1 more than the last value of the outer loop.
a<-1..99,
b<-(a+1)..99,
c<-(b+1)..99
And the final pattern which make it all work like magic:
Write a function even_length? that uses pattern matching only to return false if the list you pass it has an odd number of elements, true otherwise.
This is a fun little exercise in Elixir. First we match a single item in the list (odd number) which is false. Then match exactly two items (even number) and return true. Then the 3rd function matches the first 2 elements (as throwaway) and recursively tails the list to match the first two patterns.
defmodule Lists do
def even_length?([_a]), do: false
def even_length?([_a, _b]), do: true
def even_length?([_a, _b | t]), do: even_length?(t)
end
oak.dev 