Introduction

mac-attrs-docker combines the functionality of macaddress and random-mac into a web app that evaluates the attributes of media access control (MAC) addresses.

Installing mac-attrs-docker

mac-attrs-docker is available on GitHub at https://github.com/critical-path/mac-attrs-docker. It is the Docker version of mac-attrs.

To install it, run the following command from your shell.

[user@host ~]$ git clone git@github.com:critical-path/mac-attrs-docker.git

Starting mac-attrs-docker

To start mac-attrs-docker for the first time, run the following command from your shell. This will build a Docker container from scratch.

[user@host mac-attrs-docker]$ docker-compose up --build

To restart it later, run the following command from your shell. This will preserve your progress.

[user@host mac-attrs-docker]$ docker-compose up

Using mac-attrs-docker

Using mac-attrs-docker is easy!

First, point your browser to any of the following URLs.

• http://localhost:8080/
• http://localhost:8080/home
• http://localhost:8080/home.html
• http://localhost:8080/index
• http://localhost:8080/index.html
• http://localhost:8080/mac-attrs
• http://localhost:8080/mac-attrs.html

Second, type a MAC address.

Third, click on the submit button.

Fourth, view the results.

Testing mac-attrs-docker

To conduct testing, run the following command from your shell.

[user@host mac-attrs-docker]$ docker-compose exec mac-attrs pytest --disable-warnings --cov --cov-report=term-missing