Use Windmill Hub resource types, and document custom resource type usage (#131)

* Document how to set up custom resource types

* Move resource types into dir

* Clarify how custom resource types might be used in this repo

* Use Windmill Hub resource types

Author: rudokemper

README.md

@@ -43,6 +43,12 @@ This repo also provides a shell script to batch push changes to a number of work
 
        (set -a; source .env; set +a; bin/push.sh)
 
+### Adding custom resource types
+
+At times, this repository may contain one or more [custom resource types](https://www.windmill.dev/docs/core_concepts/resources_and_types#create-a-resource-type) that are used by a number of the scripts in this repository. However, we commit to adding all of our resource types to [Windmill Hub](https://www.windmill.dev/docs/core_concepts/resources_and_types#sync-resource-types-with-windmillhub).
+
+There is no way to sync custom resource types to a Windmill workspace, so you will need to manually add them. The easiest way to do this is to paste them in to the JSON editor when creating a new resource type.
+
 ## Development
 
 In Windmill, scripts can be written in Python, TypeScript, Go, and a number of other languages. Flows and apps can 

c_arcgis_account.resource-type.json

@@ -3,11 +3,20 @@
 
 import json
 import logging
+from typing import TypedDict
 
 from twilio.rest import Client as TwilioClient
 
-# type names that refer to Windmill Resources
-c_twilio_message_template = dict
+
+# https://hub.windmill.dev/resource_types/274/twilio_message_template
+class twilio_message_template(TypedDict):
+    account_sid: str
+    auth_token: str
+    origin_number: str
+    recipients: list[str]
+    content_sid: str
+    messaging_service_sid: str
+
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -16,7 +25,7 @@
 def main(
     alerts_statistics: dict,
     community_slug: str,
-    twilio: c_twilio_message_template,
+    twilio: twilio_message_template,
 ):
     send_twilio_message(twilio, alerts_statistics, community_slug)
 

c_gfw_api.resource-type.json

@@ -33,7 +33,7 @@ schema:
         ingesting and writing alerts to the database via a Twilio message
         content template.
       default: null
-      format: resource-c_twilio_message_template
+      format: resource-twilio_message_template
   required:
     - alerts_statistics
     - community_slug

c_kobotoolbox_account.resource-type.json

@@ -5,22 +5,27 @@
 import logging
 import os
 from pathlib import Path
+from typing import TypedDict
 
 import requests
 
 from f.common_logic.db_operations import postgresql
 from f.common_logic.file_operations import save_data_to_file
 from f.connectors.geojson.geojson_to_postgres import main as save_geojson_to_postgres
 
-# type names that refer to Windmill Resources
-c_arcgis_account = dict
+
+# https://hub.windmill.dev/resource_types/271/arcgis_account
+class arcgis_account(TypedDict):
+    username: str
+    password: str
+
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
 
 def main(
-    arcgis_account: c_arcgis_account,
+    arcgis_account: arcgis_account,
     feature_layer_url: str,
     db: postgresql,
     db_table_name: str,
@@ -61,7 +66,7 @@ def main(
     )
 
 
-def get_arcgis_token(arcgis_account: c_arcgis_account):
+def get_arcgis_token(arcgis_account: arcgis_account):
     """
     Generate an ArcGIS token using the provided account credentials.
 

c_odk_config.resource-type.json

@@ -17,7 +17,7 @@ schema:
       type: object
       description: The name of the ArcGIS account to use for fetching the feature layer.
       default: null
-      format: resource-c_arcgis_account
+      format: resource-arcgis_account
       originalType: string
     attachment_root:
       type: string