Page MenuHomePhabricator

Add Lua module and Template tool types
Closed, ResolvedPublic

Description

The toolinfo.json spec currently defines tool types of web app, desktop app, bot, gadget, user script, command line tool, coding framework, and other. In presentations and other discussions @bd808 and @Bmueller have included Lua modules and "complex templates" as additional classifications for on-wiki technical contributions that Toolhub can help track. We can make this more official and discoverable by adding types named "lua module", and "template" in the specification and Toolhub's back and frontend code.

  • Add to jsonschema/toolinfo/current.yaml schema
  • Generate 1.2.1.{json,yaml} schemas
  • Update jsonschema/toolinfo/CHANGELOG.rst
  • Add /toolinfo/1.2.0 to ignoreSchemas in .jsonschema-tools.yaml
  • Add to toolhub.apps.toolinfo.models.Tool.TOOL_TYPE_CHOICES
  • Generate database migration for new TOOL_TYPE_CHOICES values
  • Generate new python translation files for new TOOL_TYPE_CHOICES values (make messages)
  • Add "search-filter-tool-type-..." messages to vue/src/assets/locales/i18n/{en,qqq}.json
  • Add fallback icons to vue/src/components/tools/ToolImage.vue
  • Document at https://meta.wikimedia.org/wiki/Toolhub/Data_model

Event Timeline

@sdkim Any objections or tweaks you would like to see before marking this as groomed?

sdkim triaged this task as Medium priority.Nov 23 2021, 6:26 PM

Not sure about what icons to choose for the new tool types

Change 742108 had a related patch set uploaded (by Slavina Stefanova; author: Slavina Stefanova):

[wikimedia/toolhub@main] ui: Add lua module and template tool types

https://gerrit.wikimedia.org/r/742108

Not sure about what icons to choose for the new tool types

https://materialdesignicons.com/ is a nice tool to use to look at the various built-in icons.

Change 742108 merged by jenkins-bot:

[wikimedia/toolhub@main] ui: Add lua module and template tool types

https://gerrit.wikimedia.org/r/742108

Changes are deployed to https://toolhub-demo.wmcloud.org/ for acceptance testing. I made https://toolhub-demo.wmcloud.org/tools/mw-template-codesample as an example toolinfo record for a Template.

bd808 updated Other Assignee, added: Slst2020.

Referenced https://toolhub-demo.wmcloud.org/tools/wikitech-module-sal as the lua module example and have checked API for new tool types persisted

✅ Acceptance Testing

Change 749220 had a related patch set uploaded (by BryanDavis; author: Bryan Davis):

[operations/deployment-charts@master] toolhub: Bump container version to 2021-12-20-122341-production

https://gerrit.wikimedia.org/r/749220

Change 749220 merged by jenkins-bot:

[operations/deployment-charts@master] toolhub: Bump container version to 2021-12-23-121200-production

https://gerrit.wikimedia.org/r/749220