Ferreteria: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
(Created page with "Ferreteria is a web application framework I'm writing in PHP. It originally emerged from writing VbzCart, when I realized a lot of the classes and techniques I'd creat...")
No edit summary
Line 1: Line 1:
[[Ferreteria]] is a web application framework I'm writing in PHP. It originally emerged from writing [[VbzCart]], when I realized a lot of the classes and techniques I'd created (starting with the database classes) could be used for other applications as well.
<hide>
[[page type::article]]
[[thing type::software]]
[[thing type::project]]
[[software type::library]]
[[language::PHP]]
[[category:software]]
</hide>
==About==
'''Ferreteria''' is a code library that provides a basic [[application framework]] along with some utility functions that can be used separately. It was originally written for [[VbzCart]], but became useful in its own  right as it developed. The name literally means "hardware" in Spanish; I used it because I came across the word in a hardware store full of useful tools, which made it seem somehow appropriate as a name for a software toolkit, and also because I seem to be using the affix "ferret" in a lot of my software projects.


Because it does not use JavaScript (JS), it is very fast; response-times tend to be comparable to a "single-page app" framework written in JS, except that the initial load is as quick as subsequent reloads and all of the navigation links are bookmarkable.
It is written in [[PHP]], but should be portable to other languages without too much difficulty.
==Features==
==Pages==
* '''User management'''
* [[/install]]
** log-in control: email-based account creation, password reset
* by version: (versions 1-3 need to be renamed to 0.1-0.3 because they're all pre-release)
** user-group assignment, group-permissions assignment
** '''[[/v0.4|version 0.4]]''': recordsets split into single-row records and multiple-row recordsets; using status objects more
* '''State persistence via URL'''
** '''[[/v3|version 3]]''': had to temporarily abandon several weeks of work on this in January 2019
** The only cookie stored is a single "session" cookie, which usually just stores the minimum needed for session security.
*** [[/v3/class]]es
*** Most app-state data is stored in the URL path, without even using the <code>?query</code> part of the URL, for practical and aesthetic reasons.
*** [[/v3/fx]] (functions)
* '''Database wrappers'''
*** [[/v3/usage/forms]]: early v3 usage documentation, probably needs update
** classes for different types of tables, records
** '''[[/v2|version 2]]''', 2017-2019: basically Ferreteria 1 with db.v2
** classes for handling forms, controls, data fields
*** [[/v2/class]]: class structure
** functions for specific tables can be built by descending from more general classes
*** [[/v2/usage]]: how to do things in Ferreteria, how the pieces work
** URL-linkable tables, records
** '''[[/v1|version 1]]''' never really had much documentation
==Reference==
*** [[/v1/usage/forms]]
* {{htyp}}: official documentation
* [[/errors]]: elaboration on various error messages
* [[/archive]]: obsolete pages
* [[/modules]]: available drop-in modules (includes table design pages)
 
==Links==
===Official===
* [https://gitlab.com/woozalia/ferreteria GitLab]: official code repository
* [http://rm.vbz.net/projects/ferreteria Redmine @ vbz]: official project tracker

Revision as of 01:04, 9 January 2020

<hide> page type::article thing type::software thing type::project software type::library language::PHP </hide>

About

Ferreteria is a code library that provides a basic application framework along with some utility functions that can be used separately. It was originally written for VbzCart, but became useful in its own right as it developed. The name literally means "hardware" in Spanish; I used it because I came across the word in a hardware store full of useful tools, which made it seem somehow appropriate as a name for a software toolkit, and also because I seem to be using the affix "ferret" in a lot of my software projects.

It is written in PHP, but should be portable to other languages without too much difficulty.

Pages

  • /install
  • by version: (versions 1-3 need to be renamed to 0.1-0.3 because they're all pre-release)
  • /errors: elaboration on various error messages
  • /archive: obsolete pages
  • /modules: available drop-in modules (includes table design pages)

Links

Official