mystx.ext.github_readme_stats.wakatime
======================================

.. py:module:: mystx.ext.github_readme_stats.wakatime

.. autoapi-nested-parse::

   WakaTime 统计卡片指令。

   提供 ``GitHubWakaTimeDirective``，使用 GitHub Readme Stats 服务渲染 WakaTime 统计卡片。
   参考上游用法：https://github-readme-stats.vercel.app/api/wakatime?username=willianrod

   支持选项（与上游一致的常用项） :

   - ``username`` （必填）：WakaTime 用户名；
   - ``theme`` （可选）：主题名称，默认 ``default``；
   - ``layout`` （可选）：布局样式（例如 ``compact``）；
   - ``range`` （可选）：时间范围（如 ``last_7_days``、``last_30_days``、``last_6_months``、``last_year``、``all_time``）；
   - ``api_domain`` （可选）：自定义 WakaTime API 域名（如 Hakatime/Wakapi）；
   - ``custom_title`` （可选）：自定义标题；
   - ``hide_title`` （可选 flag）：隐藏标题；
   - ``hide_border`` （可选 flag）：隐藏边框。

   示例:

   .. code-block:: rst

       .. github-wakatime::
           :username: willianrod
           :layout: compact
           :theme: tokyonight
           :range: last_7_days



Classes
-------

.. autoapisummary::

   mystx.ext.github_readme_stats.wakatime.GitHubWakaTimeDirective


Module Contents
---------------

.. py:class:: GitHubWakaTimeDirective(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)

   Bases: :py:obj:`mystx.ext.github_readme_stats.base.BaseGitHubCardDirective`


   渲染 WakaTime 统计卡片。

   选项见模块文档说明。


   .. py:attribute:: option_spec

      Mapping of option names to validator functions.



   .. py:method:: run()

      根据选项构建 WakaTime 卡片 URL 并返回 HTML 节点。