About
Abilian Core is an enterprise application development platform based on the Flask micro-framework, the SQLAlchemy ORM, good intentions and best practices (for some value of "best").
The full documentation is available on http://docs.abilian.com/.
Goals & principles
- Development must be easy and fun (some some definition of "easy" and "fun", of course)
- The less code (and configuration) we write, the better
- Leverage existing reputable open source libraries and frameworks, such as SQLAlchemy and Flask
- It must lower errors, bugs, project's time to deliver. It's intended to be a rapid application development tool
- It must promote best practices in software development, specially Test-Driven Development (as advocated by the GOOS book)
Features
Here's a short list of features that you may find appealing in Abilian:
Infrastructure
- Plugin framework
- Asynchronous tasks (using Celery)
- Security model and service
Domain model and services
- Persistent domain object model, based on SQLAlchemy
- Audit
Content management and services
- Simple file-based content repository
- Indexing service
- Document preview and transformation
Social
- Users, groups and social graph (followers)
- Activity streams
User Interface and API
- Forms (based on WTForms)
- CRUD (Create, Retrieve, Edit/Update, Remove) interface from domain models
- Labels and descriptions for each field
- Various web utilities: view decorators, class-based views, Jinja2 filters, etc.
- A default UI based on Bootstrap 3 and several carefully selected jQuery plugins such as Select2
- REST and AJAX API helpers
- i18n: support for multi-language via Babel, with multiple translation dictionaries
Management and admin
- Initial settings wizard
- Admin and user settings framework
- System monitoring (using Sentry)
Current status
Abilian Core is currently alpha software, in terms of API stability.
It is currently used in several applications that have been developped by Abilian over the last two years:
- Abilian SBE (Social Business Engine) - an enterprise 2.0 (social collaboration) platform
- Abilian EMS (Event Management System)
- Abilian CRM (Customer / Contact / Community Relationship Management System)
- Abilian Le MOOC - a MOOC prototype
- Abilian CMS - a Web CMS
In other words, Abilian Core is the foundation for a small, but growing, family of business-critical applications that our customers intend us to support in the coming years.
So while Abilian Core APIs, object model and even architecture, may (and most probably will) change due to various refactorings that are expected as we can't be expected to ship perfect software on the firt release, we also intend to treat it as a valuable business asset and keep maintaining and improving it in the foreseeable future.
Roadmap & getting involved
If you need help or for general discussions about the Abilian Platform, we recommend joing the Abilian Users forum on Google Groups.
For features and bug requests (or is it the other way around?), we recommend that you use the GitHub issue tracker.
Read the Contributing Guide for more information.
Install
If you are a Python web developer (which is the primary target for this project), you probably already know about:
- Python 3.8+
- Virtualenv
- Poetry (https://poetry.eustace.io/)
So, after you have created and activated a virtualenv for the project, just run:
poetry
To use some features of the library, namely document and images transformation, you will need to install the additional native packages, using our operating system's package management tools (dpkg, yum, brew...):
- A few image manipulation libraries (
libpng,libjpeg) - The
poppler-utils,unoconv,LibreOffice,ImageMagickutilities
Look at the fabfile.py for the exact list.
Testing
Abilian Core come with a full unit and integration testing suite. You can run it with make test (once your virtualenv has been activated and all required dependencies have been installed, see above).
Alternatively, you can use tox to run the full test suite in an isolated environment.
Licence
Abilian Core is licensed under the LGPL.
Credits
Abilian Core has been created by the development team at Abilian (currently: Stefane and Bertrand), with financial support from our wonderful customers, and R&D fundings from the French Government, the Paris Region and the European Union.
We are also specially grateful to:
- Armin Ronacher for his work on Flask.
- Michael Bayer for his work on SQLAlchemy.
- Everyone who has been involved with and produced open source software for the Flask ecosystem (Kiran Jonnalagadda and the HasGeek team, Max Countryman, Matt Wright, Matt Good, Thomas Johansson, James Crasta, and many others).
- The creators of Django, Pylons, TurboGears, Pyramid and Zope, for even more inspiration.
- The whole Python community.
1 Dec 15, 2022
4 Aug 17, 2022
1 Feb 6, 2022
19 Aug 12, 2022
13 Nov 10, 2022
93 Jan 8, 2023
8 Dec 14, 2022
12 Nov 29, 2022
1 Jan 31, 2022
1 Nov 3, 2021
44 Nov 15, 2022
1 Jul 17, 2022
4 Jan 2, 2022
19 Jan 1, 2023
10 Aug 19, 2022
1 Nov 17, 2021
2 Dec 5, 2021
10 Oct 7, 2022
3 Jun 28, 2022