feat: add import taxonomy feature [FC-0036]

src/taxonomy/TaxonomyListPage.jsx

@@ -1,18 +1,42 @@
 import React from 'react';
 import {
+  Button,
   CardView,
   Container,
   DataTable,
   Spinner,
 } from '@edx/paragon';
-import { injectIntl, intlShape } from '@edx/frontend-platform/i18n';
+import {
+  Add,
+} from '@edx/paragon/icons';
+import { injectIntl, intlShape, useIntl } from '@edx/frontend-platform/i18n';
 import { StudioFooter } from '@edx/frontend-component-footer';
+
 import Header from '../header';
 import SubHeader from '../generic/sub-header/SubHeader';
+import { importTaxonomy } from './import-tags';
 import messages from './messages';
 import TaxonomyCard from './TaxonomyCard';
 import { useTaxonomyListDataResponse, useIsTaxonomyListDataLoaded } from './api/hooks/selectors';
 
+const TaxonomyListHeaderButtons = () => {
+  const intl = useIntl();
+  return (
+    <>
+      <Button variant="outline-primary" disabled>
+        {intl.formatMessage(messages.downloadTemplateButtonLabel)}
+      </Button>
+      <Button
+        iconBefore={Add}
+        onClick={() => importTaxonomy(intl)}
+        data-testid="taxonomy-import-button"
+      >
+        {intl.formatMessage(messages.importButtonLabel)}
+      </Button>
+    </>
+  );
+};
+
 const TaxonomyListPage = ({ intl }) => {
   const useTaxonomyListData = () => {
     const taxonomyListData = useTaxonomyListDataResponse();
@@ -22,12 +46,6 @@ const TaxonomyListPage = ({ intl }) => {
 
   const { taxonomyListData, isLoaded } = useTaxonomyListData();
 
-  const getHeaderButtons = () => (
-    // Download template and import buttons.
-    // TODO Add functionality to this buttons.
-    undefined
-  );
-
   const getOrgSelect = () => (
     // Organization select component
     // TODO Add functionality to this component
@@ -49,7 +67,7 @@ const TaxonomyListPage = ({ intl }) => {
           <SubHeader
             title={intl.formatMessage(messages.headerTitle)}
             titleActions={getOrgSelect()}
-            headerActions={getHeaderButtons()}
+            headerActions={<TaxonomyListHeaderButtons />}
             hideBorder
           />
         </Container>

src/taxonomy/TaxonomyListPage.test.jsx

@@ -8,6 +8,7 @@ import initializeStore from '../store';
 
 import TaxonomyListPage from './TaxonomyListPage';
 import { useTaxonomyListDataResponse, useIsTaxonomyListDataLoaded } from './api/hooks/selectors';
+import { importTaxonomy } from './import-tags/data/utils';
 
 let store;
 
@@ -16,6 +17,10 @@ jest.mock('./api/hooks/selectors', () => ({
   useIsTaxonomyListDataLoaded: jest.fn(),
 }));
 
+jest.mock('./import-tags/data/utils', () => ({
+  importTaxonomy: jest.fn(),
+}));
+
 const RootWrapper = () => (
   <AppProvider store={store}>
     <IntlProvider locale="en" messages={{}}>
@@ -65,4 +70,22 @@ describe('<TaxonomyListPage />', async () => {
       expect(getByTestId('taxonomy-card-1')).toBeInTheDocument();
     });
   });
+
+  it('calls the import taxonomy action when the import button is clicked', async () => {
+    useIsTaxonomyListDataLoaded.mockReturnValue(true);
+    useTaxonomyListDataResponse.mockReturnValue({
+      results: [{
+        id: 1,
+        name: 'Taxonomy',
+        description: 'This is a description',
+      }],
+    });
+    await act(async () => {
+      const { getByTestId } = render(<RootWrapper />);
+      const importButton = getByTestId('taxonomy-import-button');
+      expect(importButton).toBeInTheDocument();
+      importButton.click();
+      expect(importTaxonomy).toHaveBeenCalled();
+    });
+  });
 });

src/taxonomy/import-tags/__mocks__/index.js

@@ -0,0 +1,2 @@
+// eslint-disable-next-line import/prefer-default-export
+export { default as taxonomyImportMock } from './taxonomyImportMock';

src/taxonomy/import-tags/__mocks__/taxonomyImportMock.js

@@ -0,0 +1,4 @@
+export default {
+  name: 'Taxonomy name',
+  description: 'Taxonomy description',
+};

src/taxonomy/import-tags/data/api.js

@@ -0,0 +1,31 @@
+// @ts-check
+import { camelCaseObject, getConfig } from '@edx/frontend-platform';
+import { getAuthenticatedHttpClient } from '@edx/frontend-platform/auth';
+
+const getApiBaseUrl = () => getConfig().STUDIO_BASE_URL;
+
+export const getTaxonomyImportApiUrl = () => new URL(
+  'api/content_tagging/v1/taxonomies/import/',
+  getApiBaseUrl(),
+).href;
+
+/**
+ * Import a new taxonomy
+ * @param {string} taxonomyName
+ * @param {string} taxonomyDescription
+ * @param {File} file
+ * @returns {Promise<Object>}
+ */
+export async function importNewTaxonomy(taxonomyName, taxonomyDescription, file) {
+  const formData = new FormData();
+  formData.append('taxonomy_name', taxonomyName);
+  formData.append('taxonomy_description', taxonomyDescription);
+  formData.append('file', file);
+
+  const { data } = await getAuthenticatedHttpClient().post(
+    getTaxonomyImportApiUrl(),
+    formData,
+  );
+
+  return camelCaseObject(data);
+}

src/taxonomy/import-tags/data/api.test.js

@@ -0,0 +1,38 @@
+import MockAdapter from 'axios-mock-adapter';
+import { initializeMockApp } from '@edx/frontend-platform';
+import { getAuthenticatedHttpClient } from '@edx/frontend-platform/auth';
+
+import { taxonomyImportMock } from '../__mocks__';
+
+import {
+  getTaxonomyImportApiUrl,
+  importNewTaxonomy,
+} from './api';
+
+let axiosMock;
+
+describe('import taxonomy api calls', () => {
+  beforeEach(() => {
+    initializeMockApp({
+      authenticatedUser: {
+        userId: 3,
+        username: 'abc123',
+        administrator: true,
+        roles: [],
+      },
+    });
+    axiosMock = new MockAdapter(getAuthenticatedHttpClient());
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should call import taxonomy', async () => {
+    axiosMock.onPost(getTaxonomyImportApiUrl()).reply(201, taxonomyImportMock);
+    const result = await importNewTaxonomy('Taxonomy name', 'Taxonomy description');
+
+    expect(axiosMock.history.post[0].url).toEqual(getTaxonomyImportApiUrl());
+    expect(result).toEqual(taxonomyImportMock);
+  });
+});

src/taxonomy/import-tags/data/utils.js

@@ -0,0 +1,82 @@
+import messages from '../messages';
+import { importNewTaxonomy } from './api';
+
+// eslint-disable-next-line import/prefer-default-export
+export const importTaxonomy = async (intl) => {
+  /*
+    * This function is a temporary "Barebones" implementation of the import
+    * functionality with `prompt` and `alert`. It is intended to be replaced
+    * with a component that shows a `ModalDialog` in the future.
+    * See: https://github.com/openedx/modular-learning/issues/116
+    */
+  /* eslint-disable no-alert */
+  /* eslint-disable no-console */
+
+  const selectFile = async () => new Promise((resolve) => {
+  /*
+   * This function get a file from the user. It does this by creating a
+   * file input element, and then clicking it. This allows us to get a file
+   * from the user without using a form. The file input element is created
+   * and appended to the DOM, then clicked. When the user selects a file,
+   * the change event is fired, and the file is resolved.
+   * The file input element is then removed from the DOM.
+  */
+    const fileInput = document.createElement('input');
+    fileInput.type = 'file';
+    fileInput.accept = '.json,.csv';
+    fileInput.addEventListener('change', (event) => {
+      const file = event.target.files[0];
+      if (!file) {
+        resolve(null);
+      }
+      resolve(file);
+      document.body.removeChild(fileInput);
+    });
+
+    document.body.appendChild(fileInput);
+    fileInput.click();
+  });
+
+  const getTaxonomyName = () => {
+    let taxonomyName = null;
+    while (!taxonomyName) {
+      taxonomyName = prompt(intl.formatMessage(messages.promptTaxonomyName));
+
+      if (taxonomyName == null) {
+        break;
+      }
+
+      if (!taxonomyName) {
+        alert(intl.formatMessage(messages.promptTaxonomyNameRequired));
+      }
+    }
+    return taxonomyName;
+  };
+
+  const getTaxonomyDescription = () => prompt(intl.formatMessage(messages.promptTaxonomyDescription));
+
+  const file = await selectFile();
+
+  if (!file) {
+    return;
+  }
+
+  const taxonomyName = getTaxonomyName();
+  if (taxonomyName == null) {
+    return;
+  }
+
+  const taxonomyDescription = getTaxonomyDescription();
+  if (taxonomyDescription == null) {
+    return;
+  }
+
+  importNewTaxonomy(taxonomyName, taxonomyDescription, file)
+    .then(() => {
+      alert(intl.formatMessage(messages.importTaxonomySuccess));
+    })
+    .catch((error) => {
+      alert(intl.formatMessage(messages.importTaxonomyError));
+      console.error(error.response);
+    });
+};