james
james copied to clipboard
James is a collection of object-oriented Pascal primitives for Lazarus and Delphi
James
James is a collection of object-oriented Pascal primitives.
ATTENTION: We're still in a very early alpha version, the API may and will change frequently. Please, use it at your own risk, until we release version 1.0.
Table of Contents
- Overview
- Dependencies
-
Installing
- Dependencies
- On Lazarus
- On Delphi
- Testing
- License
Overview
This API is being written in Free Pascal and Lazarus. However, it is also compatible with Delphi.
The main goal is to replace common procedural code, which has so many conditionals and "controllers", to a declarative and object-oriented code.
We want to write elegant, clean, organized, interface-based, and maintainable code using OOP.
The code follows a restrict rules about naming and style, as prefixes and suffixes, to help programmers to find the correct class or method to do the job quickly.
Installing
Clone the repository in some directory in your computer.
Dependencies
First of all, you should have these libraries installed in your environment:
-
mORMot — client-server ORM SOA MVC framework for Delphi 6 up to latest Delphi and FPC
- see the corresponding documentation to install it.
On Lazarus
It has been tested using these versions:
- FPC 3.1.1 revision 40491
- Lazarus 2.1.0 revision 59757
To install on Lazarus:
- Make sure that you have
mormot_base.lpk
available - see dependencies - Open the package in
/pkg/JamesLib.lpk
- Compile it
- That's all.
The IDE will be aware about JamesLib Package to use in any project.
On Delphi
There is no package for Delphi users yet.
Considering <james>
as the path where you have saved the sources, you must include these paths in your project:
- Search Path
<james>\src;<james>\src\delphi
If you are using an old Delphi version as Delphi 7, you also might need to download these:
- FastMM4 — A memory manager for Delphi and C++ Builder with powerful debugging facilities
- DUnit — An Xtreme testing framework for Delphi programs
And make sure that these libraries are in your Delphi search path.
Testing
Make sure that everything is working in your environment opening the /test/TestAll
project, compiling and running.
License
This project is released under MIT license. See LICENSE.