Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/recipes/scaffold_an_app_via_the_portal.rst
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.. _scaffold_an_app_via_the_portal :
.. _scaffold_an_app_via_the_portal:



Expand Down
2 changes: 2 additions & 0 deletions docs/tethys_sdk/paths.rst
Original file line number Diff line number Diff line change
Expand Up @@ -236,6 +236,8 @@ For the ``workspace`` and ``media`` paths the location of the paths from all app

The ``public`` and the ``resources`` directories are relative to the source code of the app (i.e. not centralized). Even when the ``collectstatic`` command is used to copy all static files to a central location the :ref:`tethys_paths_api` will return the the public directory that is relative to the app source code.

.. _tethys_paths_cli:

Command Line Interface
==========================
The Paths API can be accessed through the command line interface (CLI) using the ``paths`` command. This command provides a way to list paths for specific apps or users and add files to those destinations.
Expand Down
95 changes: 72 additions & 23 deletions docs/whats_new.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,50 +4,99 @@
What's New
**********

**Last Updated:** November 2024
**Last Updated:** November 2025

Refer to this article for information about each new release of Tethys Platform.

Release |version|
==================
=================

Major Features
Django 3.2 Support Dropped
--------------------------

* Tethys Platform has dropped support for Django 3.2 due to its end-of-life status.
* Users are encouraged to upgrade to Django 4.2 or later to take advantage of the latest features and security updates.
* Tethys Platform has been compatible with Django 4.2 and Django 5.x since version 4.3 allowing you to migrate before updating to Tethys Platform 4.4.

See: :ref:`development_installation` and `PR 1202 <https://github.com/tethysplatform/tethys/pull/1202>`_

Component Apps
--------------

* Build dynamic, pure-Python Tethys Apps using ReactPy--no JavaScript required.

See: :ref:`tethys_components`

Scaffold Apps Graphically
-------------------------

* Tethys Portal features an option to scaffold and import apps graphically.
* This feature is currently only supported for admin/staff users in development mode (i.e. DEBUG=True).

See: :ref:`scaffold_an_app_via_the_portal`

Cookie Privacy Consent
----------------------

* Tethys Portal now supports an optional cookie privacy consent management using the `django-cookie-consent <https://django-cookie-consent.readthedocs.io/en/latest/>`_ library.
* When enabled, end users will be presented with a cookie consent banner upon their first visit to the portal.
* App developers can add a new cookies.yaml file to their apps to declare and categorize cookies used by their apps.

See: :ref:`cookie_consent`

Paths API CLI
--------------

Django 4/5 Support
..................
* Tethys Platform now includes a new CLI for the Paths API, allowing for easier management and interaction with paths in Tethys apps.
* Use the Paths CLI to find the location of the various workspaces and media directories associated with Tethys apps.
* Add files to app and user workspaces and media directories directly from the command line.

* Tethys Platform 4.3 is compatible with Django versions 4.2 - 5.x. It is now recommended to explicitly specify the version of Django that you want when you create your tethys environment.
See: :ref:`paths_cmd` and :ref:`tethys_paths_cli`

See: :ref:`development_installation`
Recipes
-------

New Logo
........
* Introducing Recipes--a new documentation tool featuring condensed, step-by-step guides for common Tethys Platform tasks.
* Recipes are designed to help both new and experienced users quickly find and implement solutions for various Tethys Platform functionalities.
* Recipes are reference guides that complement the more detailed tutorials and reference documentation.
* More recipes will be added over time.

* The new logo design that is on the `Tethys Platform <https://www.tethysplatform.org/>`_ website is now in the default configuration of the Tethys Portal.
See: :ref:`recipes`

Single App Mode
...............
Automated PyPI Package Uploads
------------------------------

* Tethys can now be used to deploy just a single app by setting the new `MULTIPLE_APP_MODE` setting to `False`.
* Tethys Platform now features automated uploads to PyPI for new releases.
* This enables support for installing Tethys Platform with pip and other PyPI-based package managers.

See: :ref:`tethys_portal_config_settings`
See: The "Pip" tab on :ref:`quickstart` and :ref:`getting_started_install_tethys`

Paths API
.........
Container Scanning
------------------

* The new Paths API replaces the Workspaces API (which will still be supported until version 5.0) and provides access to the new Media directories and the App Resources directory. It also makes better use of the Python `pathlib` library.
* Tethys Platform Docker images are now automatically scanned for vulnerabilities.
* Many vulnerabilities have been identified and resolved in the official Docker images starting with version 4.4.
* For the most secure image, use images for the latest versions of Python and Django that are supported by Tethys Platform.

See: :ref:`tethys_paths_api`
See: `PR 1197 <https://github.com/tethysplatform/tethys/pull/1197>`_

Async Support for the Jobs Table Gizmo
......................................
Clear Option for Collectstatic
------------------------------
* A new option has been added to the `tethys manage collectstatic` command to clear existing static files before collecting new ones.
* A new `STATIC_ROOT_CLEAR` environment variable (default "True") has been added to the Docker image to enable static files reset on every start-up.
* This prevents stale static files persisting across deployments when the static files are stored in a persistent volume.

* Jobs Table actions callbacks are now asynchronous enabling them to run without blocking the webserver. Custom actions can also be `async`.
See: :ref:`tethys_manage_cmd` and `PR 1188 <https://github.com/tethysplatform/tethys/pull/1188>`_

See: :ref:`jobs-table`
Bug Fixes
---------

For a full list of changes in version 4.3 refer to `<https://github.com/tethysplatform/tethys/releases/tag/4.3.0>`_
* `Component App fixes <https://github.com/tethysplatform/tethys/pull/1206>`_
* `SINGLE_APP_MODE Url Fix with React App <https://github.com/tethysplatform/tethys/pull/1204>`_
* `Fix Conda deprecated API: conda.cli.python_api -> conda.testing.conda_cli <https://github.com/tethysplatform/tethys/pull/1198>`_
* `Quotas bug fix <https://github.com/tethysplatform/tethys/pull/1192>`_
* `Scaffold fixes <https://github.com/tethysplatform/tethys/pull/1182>`_
* `Updated MFA Admin placeholder name <https://github.com/tethysplatform/tethys/pull/1208>`_

Prior Release Notes
===================
Expand Down
39 changes: 39 additions & 0 deletions docs/whats_new/prior_releases.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,45 @@ Prior Release Notes
Information about prior releases is shown here.


Release 4.3
===========

Django 4/5 Support
------------------

* Tethys Platform 4.3 is compatible with Django versions 4.2 - 5.x. It is now recommended to explicitly specify the version of Django that you want when you create your tethys environment.

See: :ref:`development_installation`

New Logo
--------

* The new logo design that is on the `Tethys Platform <https://www.tethysplatform.org/>`_ website is now in the default configuration of the Tethys Portal.

Single App Mode
---------------

* Tethys can now be used to deploy just a single app by setting the new `MULTIPLE_APP_MODE` setting to `False`.

See: :ref:`tethys_portal_config_settings`

Paths API
---------

* The new Paths API replaces the Workspaces API (which will still be supported until version 5.0) and provides access to the new Media directories and the App Resources directory. It also makes better use of the Python `pathlib` library.

See: :ref:`tethys_paths_api`

Async Support for the Jobs Table Gizmo
--------------------------------------

* Jobs Table actions callbacks are now asynchronous enabling them to run without blocking the webserver. Custom actions can also be `async`.

See: :ref:`jobs-table`

For a full list of changes in version 4.3 refer to `<https://github.com/tethysplatform/tethys/releases/tag/4.3.0>`_


Release 4.2
===========

Expand Down