Merge branch 'chore/kolasu-alignment'

Author: alessiostalla

.github/workflows/pythonapp.yml

@@ -6,7 +6,7 @@ jobs:
   build:
     strategy:
       matrix:
-        python: [ '3.7', '3.8', '3.9', '3.10' ]
+        python: [ '3.7', '3.8', '3.9', '3.10', '3.11' ]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3

.gitignore

@@ -12,3 +12,4 @@ pyvenv.cfg
 __pycache__
 /.token
 /antlr-*.jar
+.DS_Store

.readthedocs.yaml

@@ -5,6 +5,11 @@
 # Required
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py

CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+All notable changes to this project from version 0.4.0 upwards are documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [0.5.0] – 2023-09-06
+
+### Added
+- AST transformers, aligned with the latest Kolasu 1.5.x version
+- `assert_asts_are_equal` function to support writing assertions in a test suite
+- documentation generation (published on https://pylasu.readthedocs.io)
+- export more symbols
+
+### Changed
+- Alignment with Kolasu:
+  - `PropertyDescriptor` renamed to `PropertyDescription` 
+  - `Node.properties` generates `PropertyDescription` instances rather than tuples
+
+### Fixed
+- `PossiblyNamed` implementation
+- `Concept.node_properties`

MANIFEST.in

@@ -0,0 +1 @@
+prune tests

README.md

@@ -20,14 +20,18 @@ flake8 . && flake8 tests
 
 ## Packaging and distributing
 
-Update version in pyproject.toml, setup.cfg and setup.py _(TODO do we need all three?)_, then run:
+Update version in `pyproject.toml`, `setup.cfg` and `pylasu/__version__.py` _(TODO do we need all three?)_,
+commit and check that CI completes normally. Then run:
 
 ```shell
 rm dist/*
 python -m build
 python -m twine upload dist/*
 ```
 
+**Note:** if we have [two-factor authentication (2FA)](https://pypi.org/help/#twofa) enabled on PyPI, 
+we have to [use an API token](https://pypi.org/help/#apitoken).
+
 If all goes well, tag the release:
 
 ```shell
@@ -57,4 +61,5 @@ make html
 If everything goes as it should, in `docs/_build/html` you'll find the generated documentation.
 
 We also host the documentation on ReadTheDocs. The project is [pylasu](https://readthedocs.org/projects/pylasu/). 
-Documentation needs to be built manually for each release for it to appear online on https://pylasu.readthedocs.io.
+Documentation needs to be [built manually](https://readthedocs.org/projects/pylasu/) for each release for it to appear
+online on https://pylasu.readthedocs.io.

pylasu/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.5.0"

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pylasu"
-version = "0.4.0"
+version = "0.5.0"
 authors = [
     { name="Lorenzo Addazi", email="lorenzo.addazi@strumenta.com" },
     { name="Alessio Stalla", email="alessio.stalla@strumenta.com" },

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = Pylasu
-version: 0.4.0
+version: 0.5.0
 
 [coverage:run]
 branch = True

setup.py

@@ -1,8 +1,18 @@
+import os
+
 from setuptools import find_packages, setup
+
+here = os.path.abspath(os.path.dirname(__file__))
+
+# Load the package's __version__.py module as a dictionary.
+about = {}
+with open(os.path.join(here, "pylasu", '__version__.py')) as f:
+    exec(f.read(), about)
+
 setup(
     name='pylasu',
     packages=find_packages(exclude=["tests"]),
-    version='0.4.0',
+    version=about['__version__'],
     description='Pylasu is an AST Library in the StarLasu family, targeting the Python language.',
     author='Strumenta S.R.L.',
     license='Apache License V2',