About
- Displays general information about all the ports.
- Fetches and displays build history of the ports.
- Collects and displays installation statistics (system configurations and installed ports) from users who opt-in by installing the port mpstats.
- Makes available all the collected data through API.
Credits
The MacPorts Webapp was written by Arjun Salyan as a Google Summer of Code 2019 project, mentored by Mojca Miklavec and Umesh Singla. The server is administered by Clemens Lang.
History
The first MacPorts statistics web application and the initial client were written by Derek Ingrouville as a Google Summer of Code 2011 project. Some documentation for the source written in GSoC can be found in the Wiki. The source code for the server is available in MacPorts' Subversion repository at /branches/gsoc11-statistics.
Technologies
The web application is based on the Django Framework and utilises a PostgreSQL database. It runs inside a Docker container with nginx and uWSGI serving the content.
Dependencies
The app is dependent on the following:
- Buildbot JSON API: Allows fetching the build history.
- portindex2json.tcl: Converts PortIndex into JSON format. Written by Joshua Root.
- mprsyncup job: Runs portindex2json.tcl and distributes PortIndex.json through rsync.
- mpstats: Port that
submits
installation statistics.
The client implementation as the
mpstatsport is the work of Derek Ingrouville, Joshua Root and Clemens Lang. The source of the client is currently available at /trunk/dports/sysutils/mpstats in the MacPorts Subversion repository.
