streamlit-gov-uk-components

A collection of Streamlit components that use or are inspired by the GOV.UK Design System

Installation

pip install streamlit-gov-uk-components

Available components

• Checkbox
• Smaller checkbox
• Checkbox list
• Smaller checkbox list
• Radio list
• Smaller radio list

Usage

Checkbox (example)

from streamlit_gov_uk_components import gov_uk_checkbox

selected = gov_uk_checkbox(
    label="Waste from animal carcasses",  # Label shown in browser
    id="waste-from-animal-carcasses",     # ID of checkbox in HTML
    key="waste-from-animal-carcasses",    # Streamlit component instance key
    default=True,                         # Initially selected?
)

Smaller checkbox (example)

from streamlit_gov_uk_components import gov_uk_checkbox_small

selected = gov_uk_checkbox_small(
    label="HM Revenue and Customs (HMRC)",  # Label shown in browser
    id="hmrc",                              # ID of checkbox in HTML
    key="hmrc",                             # Streamlit component instance key
    default=True,                           # Initially selected?
)

Checkbox list (example)

from streamlit_gov_uk_components import gov_uk_checkbox_list

selected = gov_uk_checkbox_list(
    # Tuple of (ID, label) pairs
    options=(
        ("waste-from-animal-carcasses", "Waste from animal carcasses"),
        ("waste-from-mines-or-quarries", "Waste from mines or quarries"),
        ("farm-or-agricultural-waste", "Farm or agricultural wastes"),
    ),
    key="waste",
    # Tuple of initially selected IDs
    default=("waste-from-animal-carcasses",),
)

Smaller checkbox list (example)

from streamlit_gov_uk_components import gov_uk_checkbox_small_list

selected = gov_uk_checkbox_small_list(
    # Tuple of (ID, label) pairs
    options=(
        ("hm-revenue-and-customs", "HM Revenue and Customs (HMRC)"),
        ("employment-tribunal", "Employment Tribunal"),
        ("ministry-of-defence", "Ministry of Defence"),
        ("department-for-transport", "Department for Transport"),
    ),
    key="waste",
    # Tuple of initially selected IDs
    default=("hm-revenue-and-customs",),
)

Radio list (example)

from streamlit_gov_uk_components import gov_uk_radio_list

selected = gov_uk_radio_list(
    # Tuple of (ID, label) pairs
    options=(
        ("england", "England"),
        ("scotland", "Scotland"),
        ("wales", "Wales"),
        ("northern-ireland", "Northern Ireland"),
    ),
    id="where-do-you-live",   # Base of HTML IDs for radios
    key="where-do-you-live",  # Streamlit component instance key
    default="england",        # Initially selected ID
)

Smaller radio list (example)

from streamlit_gov_uk_components import gov_uk_radio_small_list

selected = gov_uk_radio_small_list(
    # Tuple of (ID, label) pairs
    options=(
        ("monthly", "Monthly"),
        ("yearly", "Yearly"),
    ),
    id="filter",        # Base of HTML IDs for radios
    key="filter",       # Streamlit component instance key
    default="monthly",  # Initially selected ID
)

Local development

The examples serve as reasonable mini Streamlit applications that allow development of the components themselves. Two terminal session are typically needed.

One to run Streamlit itself...

pip install streamlit
STREAMLIT_GOV_UK_COMPONENTS_DEV=True streamlit run example_checkbox.py

... and one to run a development server that automatically recompiles and serves the HTML and Javascript of the front end of each component.

cd streamlit_gov_uk_components/frontend_checkbox
yarn install
./fix.sh
yarn run start

Releasing to PyPI

1. Ensure that each frontend component has been built. Each frontend component must be built, not just those that have changed, since the production builds of each are not checked into the repository.

   cd streamlit_gov_uk_components/frontend_checkbox
   yarn install
   ./fix.sh
   yarn run build
   

2. Ensure that there is a line in MANIFEST.in for each frontend component.

3. Bump the version inside setup.py

4. Commit with a Conventional Commit message with the bumped version, tag the commit with the bumped version, and push to GitHub.

   git add setup.py
   git commit -m "build(release): v0.0.4"
   git tag v0.0.4
   git push origin main --tags
   

5. Build and release to PyPI

   pip install build twine
   rm -r -f build dist && python -m build && python -m twine upload dist/*