Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Upgrade to fypp v3.2 #79

Merged
merged 1 commit into from
May 3, 2024
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
36 changes: 33 additions & 3 deletions external/fypp/CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,36 @@ Change Log
==========


3.2
===

Added
-----

* Option ``--file-var-root`` to render file variables (``_FILE_``,
``_THIS_FILE``) as relative paths with respect to a specified root.


3.1
===

Added
-----

* Global variables _SYSTEM_ and _MACHINE_ to query environment.

* Emission of standard (#line pragma styled) line directives.

* Factory method arguments in Fypp constructor: evaluator_factory,
parser_factor, builder_factory and renderer_factory.


Changed
-------

* Support for Python 2.7, 3.3 and 3.4 dropped, support for Python 3.9 added.


3.0
===

Expand All @@ -13,7 +43,7 @@ Added

* Add block / contains / endblock construct as alternative for call / nextarg /
endcall.

* Escaping of preprocessor comments

* Possibility of specifying character encoding for file I/O with UTF-8 as
Expand Down Expand Up @@ -104,7 +134,7 @@ Added
* Python-like consistent global and local scopes and scope lookup rules.

* Predefined variables _THIS_FILE_ and _THIS_LINE_.

* Additional flags in line numbering directives when opening a file or returning
to a previous file.

Expand Down Expand Up @@ -135,7 +165,7 @@ Changed

* Function setvar() accepts arbitrary number of argument pairs.

* Reverse order exception printing, exception first occuring printed as last.
* Reverse order exception printing, exception first occurring printed as last.

* Command line tool formats error messages in GNU-like format.

Expand Down
53 changes: 42 additions & 11 deletions external/fypp/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -170,21 +170,52 @@ Main features
Installing
==========

Fypp needs a working Python interpreter. It is compatible with Python 2 (version
2.6 and above) and Python 3 (all versions).
Fypp needs a working Python 3 interpreter (Python 3.5 or above).

Automatic install
-----------------
When you install Fypp, you obtain the command line tool ``fypp`` and the Python
module ``fypp.py``. Latter you can import if you want to access the
functionality of Fypp directly from within your Python scripts.

Use Pythons command line installer ``pip`` in order to download the stable
release from the `Fypp page on PyPI <http://pypi.python.org/pypi/fypp>`_ and
install it on your system::

pip install fypp
Installing via conda
--------------------

This installs both, the command line tool ``fypp`` and the Python module
``fypp.py``. Latter you can import if you want to access the functionality of
Fypp directly from within your Python scripts.
The last stable release of Fypp can be easily installed as conda package by
issuing ::

conda install -c conda-forge fypp


Installing via pip
------------------

You can also use Pythons command line installer ``pip`` in order to download the
stable release from the `Fypp page on PyPI <http://pypi.python.org/pypi/fypp>`_
and install it on your system.

If you want to install Fypp into the module system of the active Python 3
interpreter (typically the case when you are using a Python virtual
environment), issue ::

pip3 install fypp

Alternatively, you can install Fypp into the user space (under `~/.local`) with
::

pip3 install --user fypp


Installing via MSYS2 pacman
---------------------------

On Windows you can use the `MSYS2 toolchain <https://www.msys2.org/>`_ to install
Fypp in a MinGW terminal. To install Fypp use::

pacman -S mingw-w64-x86_64-python-fypp

Make sure the selected architecture is matching your current MinGW terminal.
For all supporting MinGW architectures visit check the package index
`here <https://packages.msys2.org/base/mingw-w64-python-fypp>`_.


Manual install
Expand Down
Loading
Loading