= I/O Cartographer
Welcome to the ''I/O Cartographer'' project site!  A Qt front-end for visualizing and exploring straced file I/O telemetry.  Tired of using `grep` to mitigate the fire-hose of information that `strace` spits out?  Use this tool to help make sense of it using an interactive UI.

[[Image(iocartographer.png)]]

== Download
Download the latest alpha, released on ''(January 20, 2025)'':

[https://gauss.extollit.com/downloads/IOCartographer-0.0.4a.whl I/O Cartographer @ 0.0.4a] 

=== Change Log
Here is a brief list of changes over recent versions.  For a complete log with detailed information, and if you have developer access to this Trac project, then refer to the [timeline:now?show=changeset timeline] for a commit history.
||= Version =||= Changes =||
||v0.0.4a||Removed erroneous reporting of "memfd:" sources (as depicted above)||
||v0.0.3a||Corrected missing description of "File Type" column in "Record Search" help documentation||
||v0.0.2a||Added missing "System-D" package to the project definition so that it installs automatically||
||v0.0.1a||Introduction of I/O Cartographer! 🥳🎉||

== Installing
=== Prerequisites
- Python & Python Dev @ v3.10
  - **NOTE**: ''If your system is running a version of Python other than 3.10 you may have to install this wheel inside a Python 3.10 virtual env instead.''

=== Procedure
I/O Cartographer is packaged as a Python ''wheel''.  To install it (and all of its dependencies) simply run `pip` like so (depending on what version you have downloaded):

{{{#!sh
pip install IOCartographer-<version>.whl
}}}

== Product Help
Help for using the application can be found within the application itself.  This includes a browse-able help center, context-sensitive help, and tool-tips.

== Submitting Feedback
If you want to submit feedback for improving I/O Cartographer, including submitting bug reports, please consider [/newticket filing a new ticket].

== Licensing
Please refer to the menu ''Help → License'' inside the application for the End-User License Agreement.