Terra UI Components
Intro
Forking the Repo
Start by forking the repo on GitHub, then clone it locally and install dependencies.
git clone https://github.com/YOUR_GITHUB_USERNAME/components terra-ui-components
cd terra-ui-components
npm install
Developing
Once you've cloned the repo, run the following command.
npm start
This will spin up the dev server. After the initial build, a browser will open automatically. There is currently no hot module reloading (HMR), as browser's don't provide a way to reregister custom elements, but most changes to the source will reload the browser automatically.
Building
To generate a production build, run the following commands.
npm run build # to build the Lit components
Creating New Components
To scaffold a new component, run the following command, replacing terra-tag-name with the desired tag name.
npm run create terra-tag-name
This will generate source files, a stylesheet, a Jupyter widget, and a docs page for you. When you start the dev server, you'll find the new component in the "Components" section of the sidebar. Do a git status to see all the changes this command made.
Testing Components in Jupyter Lab
Install the uv package manager (https://github.com/astral-sh/uv), it's a lightweight tool that makes working with virtual environments and packages much easier.
Then run the following:
uv venv- create a virtual environment (only have to do this the first time)source .venv/bin/activate- activate ituv pip install -e ".[dev]"- install dependencies (see pyproject.toml)- open base.py and point dependencies to localhost (do not commit these changes) TODO: fix this so we auto-detect local development
npm run start:python- spins up Jupyter lab and should open the browser for you
For an example of how to use the components in a Jupyter Notebook, open the /notebooks/playground.ipynb notebook in Jupyter Lab.
Publishing to NPM and PyPI
The Lit components are available on NPM at: https://www.npmjs.com/package/@nasa-terra/components The Python widgets are available on PyPI: https://pypi.org/project/terra_ui_components/
To build a new version and publish it, you can use NPM commands. The Python equivalents will be run automatically for you (see the "scripts" in package.json for details). You will need access to both repositories in order to publish.
# commit all your changes first
npm version patch # bump the version, you can use "major", "minor", "patch", etc.
npm publish --access=public
License
Terra UI Components were created by the NASA GES DISC team, on top of the amazing library Shoelace.
Shoelace was created by Cory LaViska and is available under the terms of the MIT license.
3 maintainers
Metadata
3 maintainers
Release files for terra_ui_components 0.0.198
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| terra_ui_components-0.0.198.tar.gz | 4.5 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| terra_ui_components-0.0.198-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.5 MB
Release files / terra_ui_components-0.0.198.tar.gz
| Download URL | terra_ui_components-0.0.198.tar.gz |
|---|---|
| Size | 4.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a76f301e58c6bdf8c945055c05764188fdd3313a220b3d08d00b3b8527d39c1
|
|
BLAKE2b-256 checksum How to use checksums |
728074c4496fa6e1852da7bd987f09647b2783d6f05c832ab2f384f6503c8fc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-httpx/0.28.1
|
Release files / terra_ui_components-0.0.198-py3-none-any.whl
| Download URL | terra_ui_components-0.0.198-py3-none-any.whl |
|---|---|
| Size | 30.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
903cb1205e0b1ca79541ef2f14a9fc30a04fce68bad4c56329a4e513edaf628d
|
|
BLAKE2b-256 checksum How to use checksums |
c348b9370a048ca902199b0ee09a666cbccca979c9fc98fab88584659f7aab7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-httpx/0.28.1
|
Security for terra_ui_components 0.0.198
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
