Framework Upgrade: Version 3.1

Framework has been upgraded to version 3.1.0, which has a list of incompatibilites with previous version.

What Were the Goals

The goal was to create an API that encapsulates all MVC logic not related to STDIN type (Abstract MVC API) then use STDOUT/STDERR MVC APIs as its clients. This was a core change that affected most framework components:

Release Date	Name	Description
Apr 4, 2021	Abstract MVC API	API containing parts of a MVC API that do not relate to STDIN type (console, url request or exception to be handled). DONE & TESTED!
Apr 18, 2021	STDERR MVC API	All logic already set in Abstract MVC API needs to be removed then documentation and unit tests need to change too. DONE & TESTED
Apr 24, 2021	STDOUT MVC API	All logic already set in Abstract MVC API needs to be removed then documentation and unit tests need to change too. DONE & TESTED
Apr 25, 2021	Framework Engine API	All logic that pointed to classes now in Abstract MVC API needs to change along with documentation and unit tests. DONE & TESTED
Apr 25, 2021	Framework Skeleton API	All logic that pointed to classes now in Abstract MVC API needs to change along with documentation and unit tests. DONE & TESTED
Apr 25, 2021	Framework Configuration API	All logic that pointed to classes now in Abstract MVC API needs to change along with documentation and unit tests. DONE

This way no code will be repeated and elegance of design was greatly strengthened. At the same time, because entire framework was changed, it requires developers to change their project code as well when upgrading!

Upgrade Steps from Version 3.0 to 3.1

If you're a 3.0 user already, please follow these steps to upgrade your project:

open console and run:
git clone https://github.com/aherne/lucinda-framework.git
copy all files from lucinda-framework/application folder into your project application folder, replacing existing ones
If you've manually modified any of these files, compare them manually!
delete application/renderers folder
make any new view resolver you have created @ application/resolvers folder extend Lucinda\MVC\ViewResolver
open stdout.xml in your project and do following replacements:
- modify attribute default_page to become default_route @ application tag
- modify attribute page to become id @ route tag
- modify attribute name to become format @ formats tag
- modify tag formats to become resolvers
- modify tag format to become resolver
open stderr.xml in your project and do following replacements:
- add attribute default_route with value default to application tag
- modify value of attribute resolvers @ paths tag from application/renderers to application/resolvers
- move tag display_errors into root XML
- modify attribute class to become id @ exception tag
- move attributes in exceptions tag into a new tag:
  <exception id="default" controller="ErrorsController" error_type="LOGICAL" http_status="500">
- modify tag exceptions to become routes
- modify tag exception to become route
- modify value of attribute class @ resolver tag from HtmlRenderer to HtmlResolver
- modify value of attribute class @ resolver tag from JsonRenderer to JsonResolver
go to your project root, open console and run:
composer update

□ ×