{"id":15975716,"url":"https://github.com/questionlp/wwdtm","last_synced_at":"2026-01-27T04:16:00.875Z","repository":{"id":42359665,"uuid":"417302079","full_name":"questionlp/wwdtm","owner":"questionlp","description":"Wait Wait Don't Tell Me! Stats Python Library Version 2","archived":false,"fork":false,"pushed_at":"2025-05-30T01:01:49.000Z","size":687,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-05T17:07:16.886Z","etag":null,"topics":["dataaccess","database","library","mysql","python","python3","wwdtm"],"latest_commit_sha":null,"homepage":"https://docs.wwdt.me","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/questionlp.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"questionlp"}},"created_at":"2021-10-14T22:41:33.000Z","updated_at":"2025-05-30T01:01:26.000Z","dependencies_parsed_at":"2023-12-25T07:23:59.257Z","dependency_job_id":"3780ab5d-2e76-469b-938f-7afd68aa7862","html_url":"https://github.com/questionlp/wwdtm","commit_stats":{"total_commits":190,"total_committers":3,"mean_commits":"63.333333333333336","dds":0.4,"last_synced_commit":"3e3d673996c64a0be53e9455b16c17fb9288b624"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/questionlp/wwdtm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Fwwdtm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Fwwdtm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Fwwdtm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Fwwdtm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/questionlp","download_url":"https://codeload.github.com/questionlp/wwdtm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questionlp%2Fwwdtm/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265450726,"owners_count":23767679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dataaccess","database","library","mysql","python","python3","wwdtm"],"created_at":"2024-10-07T22:04:37.445Z","updated_at":"2026-01-27T04:16:00.858Z","avatar_url":"https://github.com/questionlp.png","language":"Python","readme":"***********************\nWait Wait Stats Library\n***********************\n\nOverview\n========\n\nThis project provides a Python library that provides an interface to\nretrieve data from a copy of the `Wait Wait Stats Database`_.\n\nIf you are in need of a pre-built package to use to build applications, the\nlibrary is available at `PyPI`_.\n\nRequirements\n============\n\nStarting with version 2.21.0, the minimum supported version of Python has been\nchanged from Python 3.10 to 3.12. All versions prior to 3.12 will no longer\nbe supported.\n\nTesting for this library has been done using Python 3.12 and preliminary testing\nhas been started for Python 3.13.\n\nIn addition to the Python version requirement, the library depends on a copy\nof the `Wait Wait Stats Database`_ running on a MySQL Server (or a distribution\nof MySQL Server like Percona) running version 8.0 or higher.\n\nStarting with version 2.21.0, experimental support has been added for MariaDB\nversions 11.8 and 12.0. Test runs have been run successfully against a MariaDB\nServer 11.8 and 12.0 running on Debian 13. Versions prior to 11.8 have not and\nwill not be tested.\n\nIf you are planning to use MariaDB instead of MySQL, it is recommended that\nversion 11.8 is used over 12 due to the former being on a stable release train\nwhile the latter is on a rolling release train. Rolling releases can introduce\nregressions or breaking changes that are generally avoided with stable releases.\n\nRunning Tests\n=============\n\nIncluded in this repository are tests that are written for use with ``pytest``.\nTo run the tests, simply run: ``pytest`` from the root of the repository.\n\nA performance testing script is also included in the repository named,\n``perf_test.py`` that tests the core class methods. This script can be used\nto create a performance baseline and also used to track changes in performance\nbetween code changes or configuration changes.\n\nDocumentation\n=============\n\nThis project uses `reStructuredText`_ located in docstrings and individual\nfiles for its documentation and makes use of `Sphinx`_ to build an HTML\n(and other formats supported by Sphinx) version of documents. To build the\ndocumentation for this project, use ``venv``, ``virtualenv`` or a similar tool\nof your choice to create a virtual environment under ``docs/`` and install the\nrequired packages in ``docs/requirements.txt``, including Sphinx and the\n`Flask`_ theme.\n\nThe documentation style guide closely follows the one documented in the\n`Python Developer's Guide`_.\n\nOnce the required packages are installed, an HTML version of the documentation\ncan be generated by running:\n\n.. code-block:: shell\n\n    make html\n\nAn online version of the documentation is also available at `docs.wwdt.me`_\n\nBuilding\n========\n\nAfter tests have been successfully run, any and all documentation updates have\nbeen made, a release wheel can then be created for distribution. To create a\nwheel, run the following command with the virtualenv activated.\n\n.. code-block:: bash\n\n    python -m build\n\nKnown Issues\n============\n\nFor documentation on known issues with this project, check out the\n`Known Issues`_ documentation on `docs.wwdt.me`_.\n\n\n.. _PyPI: https://pypi.org/project/wwdtm/\n.. _reStructuredText: https://docutils.sourceforge.io/rst.html\n.. _Sphinx: https://www.sphinx-doc.org/en/master/\n.. _Flask: https://flask.palletsprojects.com/\n.. _Python Developer's Guide: https://devguide.python.org/documenting/#style-guide\n.. _docs.wwdt.me: https://docs.wwdt.me/\n.. _Known Issues: https://docs.wwdt.me/known_issues.html\n\nVersioning\n==========\n\nThis project does its best to follow `Semantic Versioning 2.0.0`_ starting with\nversion 2.0 of the library. There have been some semantic versioning errors made\nsince the initial release of version 2.0.\n\n.. _Semantic Versioning 2.0.0: https://semver.org/spec/v2.0.0.html\n\nContributing\n============\n\nIf you would like to contribute to this project, please refer to the\n`Contributing Guidelines`_ file in this repository.\n\nAI Generated Code\n-----------------\n\nPlease note that this project does not accept pull requests or bugfixes that\ninclude code that has been partially or wholly generated using AI.\n\n.. _Contributing Guidelines: https://github.com/questionlp/wwdtm/blob/main/CONTRIBUTING.md\n\nCode of Conduct\n===============\n\nThe Code of Conduct for this project is adapted from the Contributor Covenant,\nversion 3.0, permanently available at: https://www.contributor-covenant.org/version/3/0/.\n\nThe adapted version with instructions on how to report possible violations are\navailable in the `Code of Conduct`_ file in this repository.\n\n.. _Code of Conduct: https://github.com/questionlp/wwdtm/blob/main/CODE_OF_CONDUCT.md\n\nLicense\n=======\n\nThis library is licensed under the terms of the `Apache License 2.0`_.\n\n.. _Wait Wait Stats Database: https://github.com/questionlp/wwdtm_database\n.. _Apache License 2.0: https://github.com/questionlp/wwdtm/blob/main/LICENSE\n","funding_links":["https://github.com/sponsors/questionlp"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestionlp%2Fwwdtm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquestionlp%2Fwwdtm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestionlp%2Fwwdtm/lists"}