Skip to main content

HyFI-Template: A Template for HyFI-based Projects

pypi-image license-image version-image release-date-image jupyter-book-image

A GitHub Template Repository for HyFI-based Projects

HyFI-Template is a ready-to-use GitHub template repository designed to streamline the process of initializing new projects based on HyFI, a robust framework for building interfaces for Python applications. HyFI leverages the power of the Hydra configuration system and the Pydantic data validation library, offering a comprehensive set of tools to create flexible and adaptable interfaces for various Python projects.

Features

HyFI-Template provides an ideal starting point for developers looking to build projects using the HyFI framework, with key features including:

  • Pre-configured structure: The template repository comes with a pre-defined project structure, ensuring a consistent and organized layout for HyFI-based applications.

  • Quick project initialization: With the make init-project command, developers can easily initialize a new project, automatically setting up the necessary files, directories, and configurations.

  • Hydra integration: The template repository is built around the Hydra configuration system, providing a flexible and powerful foundation for managing configurations in HyFI-based projects.

  • Pydantic integration: HyFI-Template incorporates the Pydantic data validation library, allowing developers to easily define and validate data structures for their application interfaces.

  • Best practices: The template repository follows industry best practices for Python project organization and structure, ensuring that developers have a solid starting point for building high-quality applications.

  • Customizable: Developers can easily customize the template repository to suit their specific requirements and preferences, tailoring it to the needs of their projects.

  • Documentation: The template repository includes clear instructions and guidelines for getting started with a HyFI-based project, helping developers quickly familiarize themselves with the framework and its features.

Getting Started

To begin using HyFI-Template for your project, simply follow these steps:

  1. Click the "Use this template" button on the HyFI-Template GitHub repository to create a new repository based on the template.
  2. Clone the newly created repository to your local machine.
  3. Run make init-project to initialize the project with the necessary files and configurations.
  4. Follow the provided documentation and guidelines to start building your HyFI-based application.

Or you can inject the template into an existing repository:

  1. From the root of your repository, run the following command:

    copier --data 'code_template_source=gh:entelecheia/hyfi-template' --answers-file .copier-config.yaml gh:entelecheia/hyperfast-python-template .
    
  2. Follow the provided documentation and guidelines to start building your HyFI-based application.

By using HyFI-Template as the foundation for your project, you'll be well on your way to creating powerful and adaptable interfaces for your Python applications.

Managing Actions Secrets and Variables in Your Project

When using the HyFI-Template for your project, there are several GitHub Actions secrets and variables that you need to add to ensure proper functioning of the release action and optional JupyterBook deployment.

Adding PYPI_API_TOKEN and TEST_PYPI_API_TOKEN

To automate the release process of your project to PyPI, you need to provide two tokens: PYPI_API_TOKEN and TEST_PYPI_API_TOKEN. These tokens will be used by the GitHub Actions workflow to authenticate with PyPI and TestPyPI, respectively.

  1. Generate an API token for your PyPI account by following the instructions in the official PyPI documentation.
  2. Generate an API token for your TestPyPI account by following the instructions in the official TestPyPI documentation.
  3. In your GitHub repository, go to the "Settings" tab and click on "Secrets" in the left sidebar.
  4. Click the "New repository secret" button.
  5. Add the PYPI_API_TOKEN secret with the value set to the token generated for your PyPI account.
  6. Add the TEST_PYPI_API_TOKEN secret with the value set to the token generated for your TestPyPI account.

By providing these tokens, your project's release action will have the necessary permissions to publish your package to PyPI and TestPyPI.

Optionally Adding CNAME for JupyterBook Deployment

If you plan to deploy the JupyterBook documentation to a custom domain, you'll need to add a CNAME variable to your GitHub repository.

  1. In your GitHub repository, go to the "Settings" tab and click on "Pages" in the left sidebar.
  2. Follow the instructions to configure your custom domain.
  3. In your GitHub repository, go to the "Settings" tab and click on "Repository Variables" in the left sidebar.
  4. Click the "New repository variable" button.
  5. Add a new variable with the key CNAME and set the value to your custom domain (e.g., your-custom-domain.com).

By adding the CNAME variable, the GitHub Pages action in your deploy-docs.yaml workflow will properly configure the deployment to use your custom domain.

With the CNAME repository variable properly configured, your project will be set up to handle JupyterBook deployment to your custom domain effectively.

Changelog

See the CHANGELOG for more information.

Contributing

Contributions are welcome! Please see the contributing guidelines for more information.

License

This project is released under the MIT License.

Metadata

Release files for hyfi-template 0.1.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hyfi-template 0.1.9
File Size Uploaded Provenance Actions
hyfi_template-0.1.9.tar.gz 10.5 kB Without provenance Details for hyfi_template-0.1.9.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hyfi-template 0.1.9
File Interpreter ABI Platform Actions
hyfi_template-0.1.9-py3-none-any.whl Python 3 none any Details for hyfi_template-0.1.9-py3-none-any.whl

Total release size: 23.0 kB

Release files / hyfi_template-0.1.9.tar.gz

Download URL hyfi_template-0.1.9.tar.gz
Size 10.5 kB
Tags Source
SHA-256 checksum
How to use checksums
01de891f487b10b32df39060ad67a7b8f70db72c0b1241fda99041fb3702c069
BLAKE2b-256 checksum
How to use checksums
1d424474e227a9669746cf1396ddd5d61efe96ae85a13177e14cc89c0c71e30f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.9.6 readme-renderer/37.3 requests/2.28.2 requests-toolbelt/0.10.1 urllib3/1.26.15 tqdm/4.65.0 importlib-metadata/6.5.0 keyring/23.13.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.6

Release files / hyfi_template-0.1.9-py3-none-any.whl

Download URL hyfi_template-0.1.9-py3-none-any.whl
Size 12.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cb99fa424abbdbc1b32fdfd728338b50af09300fb520e74f235dd7a4707b035d
BLAKE2b-256 checksum
How to use checksums
d6d5f70395b4b62e3a8430bc6c73df4440ed78db41effd6e43913e67e4dc61e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.9.6 readme-renderer/37.3 requests/2.28.2 requests-toolbelt/0.10.1 urllib3/1.26.15 tqdm/4.65.0 importlib-metadata/6.5.0 keyring/23.13.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.6

Security for hyfi-template 0.1.9

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.

Release history Release notifications | RSS feed

This release

0.1.9 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page