Skip to content
  • Angus Gratton's avatar
    tools/ci.sh: Support publishing package and index files to GitHub Pages. · 1eb282ad
    Angus Gratton authored
    Opt-in feature to make it easier for folks to test packages that are still
    in development, open in Pull Requests, or even in independent forks.
    
    ---
    
    To enable this on your own GitHub fork of the micropython-lib repository
    then navigate to the fork's "Settings" -> "Secrets and variables" ->
    "Actions" -> "Variables" page, then click "New repository variable", and
    create a variable named MIP_INDEX with value true (or any "truthy" value).
    
    Once enabled then any time a branch is pushed to your fork and builds
    successfully, GitHub Actions will also push the built packages and package
    index to the gh-pages branch which is associated with the repo's GitHub
    Pages web site.  The packages can then be installed remotely via:
    
        mpremote mip --index \
          https://USERNAME.github.io/micropython-lib/mip/BRANCH_NAME PACKAGE_NAME
    
    or on a device as:
    
        mip.install(PACKAGE_NAME, index="https://USERNAME.github.io/micropython-lib/mip/BRANCHNAME")
    
    (Replace USERNAME, BRANCH_NAME and PACKAGE_NAME as applicable. If you've
    renamed your fork, change the name micropython-lib to match.)
    
    Note: As well as the MIP_INDEX repository variable, this functionality
    depends on both GitHub Actions and GitHub Pages being enabled on your
    repository in GitHub.  However both options should enable automatically,
    unless they have been manually disabled.
    
    This work was funded through GitHub Sponsors.
    1eb282ad