Hexya is an open source ERP and a business application development framework written in Go.
This repository houses the business application development framework. The ERP is built by integrating modules of the Hexya Addons Project
The Hexya framework is designed to develop business applications quickly and safely. It includes all needed components in a very opinionated way.
The examples below are here to give you a first idea of Hexya.
Head to the /doc directory and especially our Tutorial if you want to start developing your business application with Hexya.
Hexya includes a full-featured type safe ORM, including a type safe query builder.
Declare a model and add some fields
func init() {
h.User().DeclareModel()
h.User().AddFields(map[string]models.FieldDefinition{
"Name": models.CharField{String: "Name", Help: "The user's username", Unique: true,
NoCopy: true, OnChange: h.User().Methods().OnChangeName()},
"Email": models.CharField{Help: "The user's email address", Size: 100, Index: true},
"Password": models.CharField{},
"IsStaff": models.BooleanField{String: "Is a Staff Member",
Help: "Set to true if this user is a member of staff"},
})
}Use the ORM to create a record in the database with type-safe data
newUser := h.User().Create(env, h.User().NewData().
SetName("John").
SetEmail("john@example.com").
SetIsStaff(true))Search the database using the type-safe query builder and update records directly
myUsers := h.User().Search(env,
q.User().Name().Contains("John").
And().Email().NotEquals("contact@example.com"))
for myUser := range myUsers.Records() {
if myUser.IsStaff() {
myUser.SetEmail("contact@example.com")
}
}Add methods to the models
h.User().Methods().GetEmail().DeclareMethod(
`GetEmail returns the Email of the user with the given name`,
func(rs m.UserSet, name string) string {
user := h.User().Search(env, q.User().Name().Equals("John")).Limit(1)
user.Sanitize() // Call other methods of the model
return user.Email() // If user is empty, then Email() will return the empty string
})Define views of different types using a simple XML view definition and let the framework do the rendering:
<view id="base_view_users_form_simple_modif" model="User" priority="18">
<form string="Users">
<field name="image" readonly="0" widget='image'
options='{"preview_image": "image_small"}'/>
<h1>
<field name="name" readonly="1"/>
</h1>
<button name="preference_change_password" type="object" string="Change password"/>
<group name="preferences" col="4">
<field name="lang" readonly="0"/>
<field name="tz" widget="timezone_mismatch" options="{'tz_offset_field': 'tz_offset'}"
readonly="0"/>
<field name="tz_offset" invisible="1"/>
<field name="company_id" options="{'no_create': True}" readonly="0"
groups="base_group_multi_company"/>
</group>
<group string="Email Preferences">
<field name="email" widget="email" readonly="0"/>
<field name="signature" readonly="0"/>
</group>
<footer>
<button name="preference_save" type="object" string="Save" class="btn-primary"/>
<button name="preference_cancel" string="Cancel" special="cancel" class="btn-default"/>
</footer>
</form>
</view>Most of the time, you do not need to declare controllers in Hexya. Instead, declare an "Action" with the views you want and a menu to access it. The framework will take care of the UI including rendering views, navigation, CRUD, etc.
<action id="base_action_res_users"
type="ir.actions.act_window"
name="Users"
model="User"
view_id="base_view_users_tree"
search_view_id="base_view_users_search"
view_mode="tree,form,calendar"/>
<menuitem id="base_menu_action_users"
name="Users"
sequence="1"
action="base_action_res_users"
parent="base_menu_users"/>Each part of the Hexya Framework is modular and follow the Iterative Definition concept.
This means that an object (for example a model class) can be defined in a module and then extended in place by dependent modules. So any subsequent modification will be made on the original model and will be available for the whole application.
This makes it possible to customize the application by creating a new module with the new features without forking and still benefiting from upstream updates.
Example on models:
package A
func init() {
h.User().DeclareModel()
h.User().AddFields(map[string]models.FieldDefinition{
"Name": models.CharField{String: "Name", Help: "The user's username", Unique: true,
NoCopy: true, OnChange: h.User().Methods().OnChangeName()},
"Email": models.CharField{Help: "The user's email address", Size: 100, Index: true},
"Password": models.CharField{},
"IsStaff": models.BooleanField{String: "Is a Staff Member",
Help: "Set to true if this user is a member of staff"},
})
}package B
func init() {
h.User().AddFields(map[string]models.FieldDefinition{
"Size": models.FloatField{},
})
}// Anywhere else
newUser := h.User().Create(env, h.User().NewData().
SetName("John").
SetEmail("john@example.com").
SetSize(185.7))
fmt.Println(newUser.Name())
// output : John
fmt.Println(newUser.Size())
// output : 185.7Model methods can be extended too:
package A
func init() {
h.User().Methods().GetEmail().DeclareMethod(
`GetEmail returns the Email of the user with the given name`,
func(rs m.UserSet, name string) string {
user := h.User().Search(rs.Env(), q.User().Name().Equals("John")).Limit(1)
user.Sanitize()
return user.Email()
})
}package B
func init() {
h.User().Methods.GetEmail().Extend("",
func(rs m.UserSet, name string) string {
res := rs.Super().GetEmail(name)
return fmt.Sprintf("<%s>", res)
})
}// Anywhere else
email := h.User().NewSet(env).GetEmail("John")
fmt.Println(email)
// output: <john@example.com>And it works also with views:
<!-- Package A -->
<view id="base_view_users_tree" model="User">
<tree string="Users">
<field name="Name"/>
<field name="Login"/>
<field name="Lang"/>
<field name="LoginDate"/>
</tree>
</view><!-- Package B -->
<view inherit_id="base_view_users_tree">
<field name="Login" position="after">
<field name="IsStaff"/>
</field>
</view>And the rendered view will be :
<tree string="Users">
<field name="Name"/>
<field name="Login"/>
<field name="IsStaff"/>
<field name="Lang"/>
<field name="LoginDate"/>
</tree>