Skip to content

Latest commit

 

History

History
167 lines (116 loc) · 5.45 KB

README.rst

File metadata and controls

167 lines (116 loc) · 5.45 KB
Raw

Nereid for Tryton

https://secure.travis-ci.org/openlabs/nereid.png?branch=develop https://coveralls.io/repos/openlabs/nereid/badge.png

Nereid is a web framework built over Flask, with Tryton as an ORM.

Copyright

Read COPYRIGHT

License

GPL3 - Read LICENSE

Installation

From PyPI using pip:

pip install trytond_nereid

Using github repository:

git clone [email protected]:openlabs/nereid.git
cd nereid
python setup.py install

Translation

Best practice for Nereid Translations is a little bit different from the usual procedure due to the different nature of the translatable messages in Nereid. For best results the following workflow is recommended:

  • Import translations as usual by installing the module with the desired language.
  • Run 'Set translations' to import new messages into the database.
  • This is the additional step recommended in Nereid: Run 'Update translations' just once to get the new translations copied to your language and updated with the proposal evtl. found on an (old) existent string.
  • Run 'Clean translations' to remove obsolete messages, that could lead to errors in translation mechanism and that are needless to translate.
  • Now work on 'Update translations' the second time on a clean set of the actual messages. Don't forget to control and unmark fuzzy messages that got a proposal from an old string.
  • When done, run as usual 'Export translations'.
  • Enjoy!

Note

When working on translations to be included in the upstream package, please work on a clean template tree without customizations.

FAQ

What are the uses of Nereid ?

Nereid can be used to build web applications, that could use Tryton's ORM as a backend. While, there are no inherent limitations which prevent you from using nereid to build any kind of web application, the design decision that we made while building nereid itself are tailored to build application that extend the functionality of the ERP system, like e-commerce system, EDI systems, Customer/Supplier Portals etc.

Why Tryton as a backend ?

Well, why not would be our question to you ? It's scalable, it's flexible and offers the best approach we have seen so far into a declarative coding pattern for model design in any ORM. The unique way Tryton handles inheritance also makes it an excellent choice. In addition to the above, Tryton by default has several modules which make designing business applications faster in comparison to other frameworks.

Let's say that you want to build a customer portal, (which is our example application), all that you need to do from your end is create a module which exposes the information that you want to, and leave other stuff like order management, account management etc to the existing Tryton modules.

Which version of Tryton does nereid use ?

Nereid is available for version 2.0, 2.4, 2.6, 2.8, 3.0 and 3.2.

All versions other than 3.2 and 3.0 are mainteinance only releases.

Now that brings us to how versioning is done

Nereid being a module for tryton, follows the same release process of Tryton with a few differences. The repository is maintained on Github and each version of Nereid is separately maintained on a git branch.

Specific minor releases can be identified from git tags or downloaded from the tags page on github. All minor releases are available on PYPI too.

What is the license of Nereid ?

Nereid follows the same license as that of Tryton which is GPLv3. Have a problem with that ? Contact us and we will be glad to help you out!

How do I install nereid ?

Just clone the module and run the python setup file. It installs all the dependencies too.

$ git clone git://github.com/openlabs/nereid.git
$ cd nereid
$ python setup.py install

Is nereid modular ?

Depends on what you think modular is. For us we think Nereid is modular because you could separate logically different functionality into a separate Tryton module and then the functionality would be available to you depending on what modules are installed in the database that you are accessing.

This also allows modules to be reused. For example, the nereid-catalog module which makes product information available could just be used for a display only catalog and is also used as the cart display module for nereid-webshop - the full eCommerce system.

A little history

The initial goal was to build an e-commerce system over OpenERP/Odoo called Callisto, and we did! It worked, but never scaled on OpenERP. The license sucked (surprise)! and then we saw that most issues we saw with OpenERP don't exist in Tryton. And, we were right.

If you want to know more about why we made these design decisions, feel free to drop us a mail

Authors and Contributors

Nereid was built at Openlabs. It's now opensource, feel free to fork and contribute! Hate us! Just fork You can get hold of @openlabsindia or @sharoonthomas if you have some techy questions to drill with.

Support or Contact

Having trouble with Nereid? Check out the documentation at TODO or contact [email protected] and we’ll help you sort it out.