rodoo 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 03ac273092ec11431199a18290e4d411f7a900e8236b2762817182b8906bd27a
-  data.tar.gz: 8160dffa4ffd00dea1654be504b9900dfff1f8980083037abda70a5bd3751eee
+  metadata.gz: 6296d9a68fe77f42b8a9077cceffbb4f444a72cd2e483e39f5c8e5c2b8e544d7
+  data.tar.gz: ae9f0cd4ec90a8b199750929c46ca59e93582b03b77be7cf97b72475f45b99a5
 SHA512:
-  metadata.gz: 830a2ccb8769ae5731f349d59c04f52d48dc2645bcce94e85dd74e9e512b8aaa3ff12b772dff5b89d9e7ecfd56015b68b2cf27b98caeb7105d22f3cd634094b3
-  data.tar.gz: 4d40594ee7327b47ae32cca4ec5c31805ea081ff380ddf6d1234d056ab32dff29b2c5210daf79f035887bd89827a8126fdd6d2ed28da25afc2b74cf86d2d5716
+  metadata.gz: 3b66d9c307b38d5eb0f9a3de01917dca2d2469a4019193b56806b3e7a41e8957a136a2f354c9a95eaae3f3e9da093cbcffb053f9bedc5bcff644897d1b7715d5
+  data.tar.gz: 324854d54a34edf6c2a91ad6f4523db61017ca83dd7a77c6c1f69ba72d452273d93d46ecb0627ccf53bcd3a92866ad8b1c03c7ad20fef6789b38634823581e4a

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.4.0] - 2026-01-26
+
+### Added
+
+- Add `message_post` instance method for posting messages to Odoo records
+
 ## [0.3.0] - 2026-01-22
 
 ### Added

data/README.md

@@ -107,6 +107,30 @@ all_contacts = Rodoo::Contact.all(limit: 100)
 
 Supported operators in string conditions: `=`, `!=`, `<>`, `<`, `>`, `<=`, `>=`, `like`, `ilike`, `=like`, `=ilike`
 
+### Language-specific responses
+
+Use the `lang:` parameter to retrieve translatable fields (like `name`, `description`) in a specific language:
+
+```ruby
+# Find with language
+contact = Rodoo::Contact.find(42, lang: "fr_FR")
+contact.name  # => "Société Acme" (French translation)
+
+# Query with language
+products = Rodoo::Product.where(type: "consu", lang: "es_ES")
+
+# All records with language
+contacts = Rodoo::Contact.all(limit: 100, lang: "de_DE")
+
+# Find by with language
+contact = Rodoo::Contact.find_by(email: "john@example.com", lang: "it_IT")
+
+# Create with language (for translatable field values)
+contact = Rodoo::Contact.create({ name: "Nouveau Contact" }, lang: "fr_FR")
+```
+
+The language code should match one of the languages installed in your Odoo instance (e.g., `en_US`, `fr_FR`, `es_ES`, `de_DE`).
+
 ### Creating records
 
 ```ruby
@@ -149,6 +173,35 @@ contact.destroy
 contact.destroyed?  # => true
 ```
 
+### Posting messages (chatter)
+
+Post internal notes or messages to a record's chatter using Odoo's mail thread functionality:
+
+```ruby
+invoice = Rodoo::CustomerInvoice.find(42)
+
+# Post an internal note
+invoice.message_post(
+  body: "<p>This is an internal note</p>",
+  message_type: "comment",
+  subtype_xmlid: "mail.mt_note"
+)
+
+# Post with additional parameters (e.g., notify specific partners)
+invoice.message_post(
+  body: "<p>Please review this invoice</p>",
+  message_type: "comment",
+  subtype_xmlid: "mail.mt_comment",
+  partner_ids: [10, 20]
+)
+```
+
+**Parameters:**
+- `body:` (required) - HTML content of the message
+- `message_type:` - Type of message: `"comment"` (default), `"notification"`, `"email"`, `"user_notification"`
+- `subtype_xmlid:` - XML ID for subtype (e.g., `"mail.mt_note"` for internal notes, `"mail.mt_comment"` for comments)
+- Additional kwargs are passed directly to Odoo's `message_post` method
+
 ### Attachments
 
 Attach PDF files to accounting entries (invoices, credit notes, journal entries):

data/lib/rodoo/model.rb

@@ -275,6 +275,37 @@ module Rodoo
       @destroyed == true
     end
 
+    # Posts a message to the record's chatter (mail thread).
+    # This is used for internal notes, comments, and notifications in Odoo.
+    #
+    # @param body [String] HTML content of the message
+    # @param message_type [String] Type: "comment", "notification", "email", "user_notification"
+    # @param subtype_xmlid [String, nil] XML ID for subtype (e.g., "mail.mt_note" for internal notes)
+    # @param kwargs [Hash] Additional parameters to pass to message_post
+    # @return [Integer] The ID of the created mail.message record
+    # @raise [Rodoo::Error] If the record hasn't been persisted
+    #
+    # @example Post an internal note
+    #   invoice.message_post(
+    #     body: "<p>This is an internal note</p>",
+    #     message_type: "comment",
+    #     subtype_xmlid: "mail.mt_note"
+    #   )
+    #
+    def message_post(body:, message_type: "comment", subtype_xmlid: nil, **kwargs)
+      raise Error, "Cannot post message to a record that hasn't been persisted" unless persisted?
+
+      params = {
+        ids: [id],
+        body: body,
+        message_type: message_type,
+        subtype_xmlid: subtype_xmlid,
+        **kwargs
+      }.compact
+
+      self.class.execute("message_post", params)
+    end
+
     def inspect
       "#<#{self.class.name} id=#{id.inspect} #{inspectable_attributes}>"
     end

data/lib/rodoo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rodoo
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rodoo
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Rodrigo Serrano