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.