conda-incubator / conda-store-ui

conda-store-ui is a frontend for conda-store powered by react
https://conda-incubator.github.io/conda-store-ui/
BSD 3-Clause "New" or "Revised" License
14 stars 21 forks source link

conda-store-ui

conda-store logo

Information Links
Project License conda-store documentation conda-store-ui documentation
Workflows GitHub Workflow Status (with event) - Release GitHub Workflow Status - GitHub pages
Releases GitHub release (the latest by date) npm release version

About

conda-store-ui is an add-on Graphical User Interface to conda-store. If you're looking for the JupyterLab Extension, you can find it at jupyterlab-conda-store

Get Started πŸ’»

To learn how to use conda-store-ui alongside conda-store, please visit the conda-store-ui documentation.

Development πŸ‘©πŸ»β€πŸ’»

Please refer to the conda-store docs: Contribute code - conda-store-ui.

Making a release πŸš€

To create a new version of this package: the release captain will open an issue with the release template and follow the steps outlined in the issue.

πŸ”— You can find more details about out release process and versioning approach in our Maintenance docs.

Running Tests

This repo contains two types of tests: Jest and Playwright

Jest tests

To run the Jest tests, run the following command:

yarn test

Playwright tests

Steps to install and set up:

conda env create -f environment_dev.yml
conda activate cs-ui-dev-env
playwright install chromium
cp .env.example .env
corepack enable
yarn install --immutable
yarn build

Line by line, here's what the commands above do:

  1. Create Conda environment
  2. Activate Conda environment
  3. Install Playwright-usable browser
  4. Copy environment variables
  5. Use Corepack to set Yarn to correct version
  6. Use Yarn to install JavaScript dependencies
  7. Build app

To run the tests, you will need to run the following commands in two separate terminal windows or tabs:

  1. In the first terminal window/tab, enter the following:
    conda activate cs-ui-dev-env
    yarn start
  2. Wait for server to start (you'll know it's ready when it says "webpack 5.xx.x compiled successfully"). Open a new terminal window or tab and enter the following:
    conda activate cs-ui-dev-env
    pytest

If you need to debug, try replacing the last command with:

PWDEBUG=1 pytest

[!NOTE] PW stands for Playwright. PWDEBUG=1 puts Playwright in debug mode.

Code of Conduct 🀝

To guarantee a welcoming and friendly community, we require all community members to follow our Code of Conduct.

License πŸ“ƒ

conda-store-ui is developed under the BSD-3 LICENSE.