oer_africa.bulk_import
======================

.. py:module:: oer_africa.bulk_import


Attributes
----------

.. autoapisummary::

   oer_africa.bulk_import.plugin
   oer_africa.bulk_import._PLUGIN_DIR
   oer_africa.bulk_import.SEARCH_TERM
   oer_africa.bulk_import.API_URL


Functions
---------

.. autoapisummary::

   oer_africa.bulk_import.bulk_translate
   oer_africa.bulk_import.bulk_translate_to_json
   oer_africa.bulk_import._fetch_raw
   oer_africa.bulk_import.bulk_import_async
   oer_africa.bulk_import.bulk_import


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

.. py:data:: plugin

.. py:data:: _PLUGIN_DIR

.. py:data:: SEARCH_TERM
   :value: 'Milk'


.. py:data:: API_URL
   :value: 'https://www.oerafrica.org/jsonapi/node/resource?filter[fulltext]=Milk&page[limit]=50&sort=-changed'


.. py:function:: bulk_translate(resources: list[dict]) -> collections.abc.Iterator[server.plugins.ome_plugin.EducationResource]

.. py:function:: bulk_translate_to_json(resources: list[dict]) -> str

   Translate a list of OER Africa resource dicts into a JSON list string.


.. py:function:: _fetch_raw(url: str) -> str
   :async:


.. py:function:: bulk_import_async(url: str = API_URL) -> list
   :async:


   Fetch OER Africa resources and write OME metadata records.

   Cached raw API response is stored in oer_africa_bulk.json.
   Translated OME metadata is stored in oer_africa_ome_metadata.json.


.. py:function:: bulk_import(url: str = API_URL) -> list

   Synchronous wrapper around bulk_import_async.