BCIT's CISA1360 Final Project in Python https://youtu.be/gVCEGnfhxrs

Working demonstration is posted at: https://100.24.142.145/carpoolmashup/allmembersmapcgi.py

Obtain a Google API KEY with these API Products:

 Directions API
 Distance Matrix API
 Geocoding API
 Maps JavaScript API
 Routing API

copy to your linux (or windows, if you have git on windows, but all instruction below are for linux)

git clone https://github.com/studio-1b/CarPoolMashupPython.git
cd CarPoolMashupPython
cd Python

You need python installed, and be comfortable with command line. If you don't have python installed, run

apt install python3

Add the following to bottom of your ""~/.bashrc"" file

export GOOGLE_GEOCODE_API_KEY=<GOOGLE API_KEY>
export GOOGLE_MAP_JS_API_KEY=<GOOGLE API_KEY>

and re-login, or run the above commands in linux command line to set them in current environment

if you had to re-login, change directory to "CarPoolMashupPython/Python". To run the source code in Python run the command below, which will instruct the web browser to listen to port 8080, to access the map application.

python3 main.py 8080

Read for additional instructions to run, if you encounter problems

cat "CLI testdata script.txt" 

BTW: "readme.txt" has surpisingly useless data. I was using it as project task list.

Using your internet browser (ie. chrome), visit:

https://localhost:8080

The above gives access to the map part of the application. This part allows you to see carpool destination and on map, then lists all the members that goto there and on map, then lists different pools you can group them into, then you can show the optimal path for that pool to arrive at destination. It also has a option, to show on map a pool separation, using a naive spanning tree traversal, of all members into separate pools, assuming 3 to 4 in pool.

The command line portion of the program you should see already as a menu, after running the python3 command. This CLI menu is to add/change data, shown in carpool. It has a menu, so it should be easy enough to figure out. You can create members, or carpool destinations using the CLI, as well as functions available in map.

1. have the constructor of request, take the incoming tcp connection
2. have a serverconfig base object, which main's config inherits from and populates the necessary fields
3. the server constructor acccepts a serverconfig
4. server has a .nonblockingstart() method wich creates another thread, creates the socket on it, runs a loop listening basically moving socket code from main, to server.

But I don't plan on working on this project in future.
It was fun, but there are no Web Servers that accept python as scripting language

1. Install docker on Linux
2. run the script "sudo ./build_docker.sh", to create a container
3. To see the container, run "docker image ls"
4. run the script "sudo ./run_as_docker.sh", and access https://localhost:8080     if you want to use a port 80,     look for 8080 in script and change it to what you want,     BUT leave 80 alone     (bc it has to match EXPOSE and CMD in dockerfile)

This container image was built with slightly different Dockerfile, than the one in source code. It runs by default on port 80 (above shows the built image runs on 8080). The instructions below tells to pull and run the image from the public internet repository where I uploaded a already built carpool container image. This command also change the listening port to 8000 (using port forwarding). There is a reason, I used port 8000. It is b/c port 80 is often used by any webserver running on your computer and they will often conflict. Also, notice the API keys still need to be supplied as arguments.

docker run -x GOOGLE_GEOCODE_API_KEY=<GOOGLE API_KEY> -x GOOGLE_MAP_JS_API_KEY=<GOOGLE API_KEY>
-it -8000:80 public.ecr.aws/y8w3p2i4/carpoolmashup-with-testdata:latest

if you use the instructions above, direct your browser to:

https://localhost:8000

or if the container is running on a different computer, than the one the browser is running on, find the ip address for the container host, using the commands below ...for windows

ipconfig

Ethernet adapter Ethernet ... :
(or Wireless LAN adapter Local Area Connection ... :)
    Connection-specific DNS Suffix  . :
    Link-local IPv6 Address . . . . . : fe80::e023:889:8b1c:bc97%4
    IPv4 Address. . . . . . . . . . . : 192.168.1.102

...for linux (eth0 may be different for you, but always starts w/ "e"thernet or "w"ireless)

ifconfig
ip addr

eth0: ...
        inet 192.168.1.102  ...
...

or

2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
...
inet 192.168.1.102/24 ...

and paste (the 192.168.1.102, in above is example, use the output from your computer)

https://<ipaddress>:8000

For about USD$24/mo, you can run the container above in Amazon AWS, and get a public IP address. The public IP address is temporary, though. And will be release and re-assigned when you shutdown (or restart) the container

Click the link below to read directions for running Carpool in a container, on Amazon AWS ECS Fargate Aws/README.md

Images for Web Console for CarPoolMashup

Images for CLI Console for CarPoolMashup

executing python3 main.py, returns unable to find "requests": run "pip3 install requests"

executing python3 main.py, return "urllib3 v2.0 only supports OpenSSL 1.1.1+, currently the 'ssl' module is compiled with LibreSSL 2.8.3": run "pip install urllib3==1.26.6"