The did project is a Python-based command-line tool designed to generate activity reports by aggregating work done across various systems and time periods. The core functionality allows users to query what they accomplished during specific intervals such as the last week, month, quarter, or year, as well as specific days of the week. The tool is invoked with straightforward syntax like "did last week" or "did this month" and supports flexible date ranges through command-line parameters.
The project's architecture centers on a plugin system that enables integration with multiple data sources and tracking systems. The README excerpt documents plugins for git repositories, Trac issue tracking systems, and Bugzilla bug tracking platforms, with configuration examples showing how to set up each. The plugin system allows users to define multiple sections in their configuration file, each pointing to different tools or repositories they want to include in their activity reports. This modular approach means the tool can be extended to support additional data sources beyond those included by default.
Output formatting is highly customizable. The tool generates plain text reports with a default maximum width of 79 characters, but users can adjust this width or disable it entirely. Multiple output formats are supported including plain text, Markdown, and MoinMoin wiki syntax. Users can control the level of detail shown through brief and verbose modes, and the tool supports generating reports for multiple email addresses simultaneously, enabling team reports or consolidated statistics across multiple user aliases.
Configuration is managed through a config file typically located at ~/.did/config, where users specify their email address, preferred output width, and settings for each integrated plugin. The tool provides extensive debugging capabilities through debug levels that can be set via command-line flags or environment variables, helping users troubleshoot integration issues.
The repository maintains connections with major open-source projects including Microsoft's VSCode, the Rust language repository, and Microsoft's TypeScript project, suggesting its use within significant development communities. The project is tagged with hacktoberfest and reports topics, indicating its participation in community contribution initiatives and its role in helping developers document their work systematically.
