Wikimedia-specific EventLogging code

Clone this repo:
  1. 05f6ce7 Merge "build: Remove EventBus phan stubs" by jenkins-bot · 2 hours ago master
  2. 0c2043d build: Remove EventBus phan stubs by Kosta Harlan · 15 hours ago
  3. ceeca0d Add PrefUpdateInstrumentationTest to the Database group by Dreamy Jazz · 23 hours ago wmf/branch_cut_pretest
  4. ccf0fa9 Localisation updates from https://translatewiki.net. by Translation updater bot · 28 hours ago
  5. a721db7 Localisation updates from https://translatewiki.net. by Translation updater bot · 3 days ago wmf/1.42.0-wmf.24

WikimediaEvents

WikimediaEvents houses Wikimedia-specific instrumentation code utilizing EventLogging.

This extension was previously known as 'CoreEvents'; it was renamed so that its name properly reflects its scope, which is not specific to MediaWiki core.

Although the code in this extension was developed with Wikimedia use-cases in mind, you may find that the functionality it implements is useful. You are welcome to use and adapt this extension under the terms of its license.

Ownership

The infrastructure that delivers the instruments is currently maintained by the Data Products team.

The owners of individual instruments is documented in OWNERS.md.

Indeed, when you create a new instrument, you are expected to document the ownership of your instrument. This expectation is enforced by the OwnersStructureTest PHPUnit test, which will fail if the files that make up the instrument aren't listed alongside contact details for you and/or your team and a description of it.

Type Checking

As of I63943fe97730953035a658f967a3d90cea9525a4, you can opt in to using TypeScript to type check your instrument during CI. To do so, add the relative path to your instrument file(s) to the "include" section in tsconfig.json, e.g.

{
  "include": [
    "./path/to/your/instrument.js",

    "modules/index.d.ts"
  ]
}

License

WikimediaEvents is distributed under the GNU General Public License, Version 2, or, at your discretion, any later version. The GNU General Public License is available via the Web at http://www.gnu.org/licenses/gpl-2.0.html.