rodoo 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87923ea6d949a5082fdf435534be6e9785c655b2bc37533784c8389c3288661b
-  data.tar.gz: 33009601846b3655494da2ee9f03c1e1ec87896d964094b03491f9ce692e07d8
+  metadata.gz: 03ac273092ec11431199a18290e4d411f7a900e8236b2762817182b8906bd27a
+  data.tar.gz: 8160dffa4ffd00dea1654be504b9900dfff1f8980083037abda70a5bd3751eee
 SHA512:
-  metadata.gz: 50bf69658ddddcf3f3b8a82f1998ebeda996ec656cfb5647c6a6c9d9e1ef2ba60349b585e861ceb44b4af69ab8b7c01c6050b5f47e58f796c89ffe5ea2074e1a
-  data.tar.gz: 7c0e9f254bc0a0c71474e29b8568fef331f78855cfac1a1956400dfc200914a5dcced7b1f440b167abb73cf646244628238c8a260ed6cf61183b5a6400751dd0
+  metadata.gz: 830a2ccb8769ae5731f349d59c04f52d48dc2645bcce94e85dd74e9e512b8aaa3ff12b772dff5b89d9e7ecfd56015b68b2cf27b98caeb7105d22f3cd634094b3
+  data.tar.gz: 4d40594ee7327b47ae32cca4ec5c31805ea081ff380ddf6d1234d056ab32dff29b2c5210daf79f035887bd89827a8126fdd6d2ed28da25afc2b74cf86d2d5716

data/.claude/skills/release/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: release
+description: Release the Rodoo gem to RubyGems with automatic versioning and changelog
+disable-model-invocation: true
+---
+
+# Release Rodoo gem
+
+## Current state
+
+Last tag: !`git describe --tags --abbrev=0 2>/dev/null`
+Current branch: !`git rev-parse --abbrev-ref HEAD`
+Uncommitted changes: !`git status --short`
+
+## Instructions
+
+Follow these steps precisely to release the gem.
+
+### 1. Validate prerequisites
+
+- Ensure you're on the `develop` branch
+- Ensure working directory is clean (no uncommitted changes)
+- Run `rake` to verify tests and linter pass
+
+If any check fails, stop and inform the user.
+
+### 2. Analyze commits since last release
+
+Run: `git log $(git describe --tags --abbrev=0)..HEAD --oneline`
+
+Categorize each commit:
+- **Added**: New features (commits starting with "Add")
+- **Changed**: Changes to existing functionality
+- **Fixed**: Bug fixes (commits starting with "Fix")
+- **Removed**: Removed features
+
+Ignore commits that are:
+- Version bumps ("Bump version")
+- Merge commits
+- Gemfile.lock updates only
+
+### 3. Determine version bump
+
+Based on the commits, determine the version bump using semver:
+
+- **MAJOR** (X.0.0): Breaking changes (look for "BREAKING", "breaking change", major API changes)
+- **MINOR** (0.X.0): New features, new models, new API methods (most "Add" commits)
+- **PATCH** (0.0.X): Bug fixes, documentation, minor tweaks
+
+Read current version from `lib/rodoo/version.rb` and calculate the new version.
+
+### 4. Update CHANGELOG.md
+
+Read `CHANGELOG.md`. Update the `## [Unreleased]` section:
+
+1. Replace `## [Unreleased]` with `## [Unreleased]` followed by a blank line and `## [NEW_VERSION] - YYYY-MM-DD`
+2. Under the new version heading, add categorized entries:
+
+```markdown
+## [Unreleased]
+
+## [X.Y.Z] - 2026-01-22
+
+### Added
+- Description of new feature
+
+### Changed
+- Description of change
+
+### Fixed
+- Description of fix
+```
+
+Only include sections that have entries. Write concise, user-facing descriptions (not raw commit messages).
+
+### 5. Update version.rb
+
+Edit `lib/rodoo/version.rb` to set the new VERSION.
+
+### 6. Update Gemfile.lock
+
+Run: `bundle install`
+
+### 7. Commit the release
+
+```bash
+git add lib/rodoo/version.rb CHANGELOG.md Gemfile.lock
+git commit -m "Bump version to X.Y.Z"
+```
+
+### 8. Push develop branch
+
+```bash
+git push origin develop
+```
+
+### 9. Merge to main
+
+```bash
+git checkout main
+git pull origin main
+git merge develop
+```
+
+### 10. Push main branch
+
+```bash
+git push origin main
+```
+
+### 11. Release to RubyGems
+
+Run: `rake release`
+
+This will:
+- Build the gem
+- Create and push the git tag
+- Push to RubyGems
+
+**Note**: If RubyGems requires authentication (one-time code), the user will need to enter it in the terminal.
+
+### 12. Return to develop
+
+```bash
+git checkout develop
+```
+
+### 13. Summary
+
+Report to the user:
+- Previous version → New version
+- Changelog entries added
+- RubyGems URL: https://rubygems.org/gems/rodoo

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-01-22
+
+### Added
+
+- Add `lang:` parameter for language-specific API responses
+
 ## [0.2.0] - 2026-01-20
 
 - Add PDF attachment support for accounting entries

data/lib/rodoo/model.rb

@@ -21,7 +21,7 @@ module Rodoo
   #   contact.email = "draft@example.com"
   #   contact.save
   #
-  class Model
+  class Model # rubocop:disable Metrics/ClassLength
     # ============================================
     # Class-level configuration and query methods
     # ============================================
@@ -48,8 +48,13 @@ module Rodoo
     #   contact = Rodoo::Contact.find(42)
     #   contact.name  # => "Acme Corp"
     #
-    def self.find(id)
-      result = execute("read", ids: [id])
+    # @example With language
+    #   contact = Rodoo::Contact.find(42, lang: "fr_FR")
+    #
+    def self.find(id, lang: nil)
+      params = { ids: [id] }
+      params[:context] = { lang: lang } if lang
+      result = execute("read", params)
       raise NotFoundError, "#{model_name} with id=#{id} not found" if result.nil? || result.empty?
 
       new(result.first)
@@ -75,13 +80,19 @@ module Rodoo
     # @example Raw Odoo domain (array of arrays)
     #   Rodoo::Contact.where([["is_company", "=", true]], limit: 10)
     #
-    def self.where(conditions = nil, fields: nil, limit: nil, offset: nil, **attrs)
+    # @example With language
+    #   Rodoo::Contact.where(is_company: true, lang: "es_ES")
+    #
+    # rubocop:disable Metrics/ParameterLists
+    def self.where(conditions = nil, fields: nil, limit: nil, offset: nil, lang: nil, **attrs)
+      # rubocop:enable Metrics/ParameterLists
       domain = DomainBuilder.build(conditions, attrs)
 
       params = { domain: domain }
       params[:fields] = fields if fields
       params[:limit] = limit if limit
       params[:offset] = offset if offset
+      params[:context] = { lang: lang } if lang
 
       execute("search_read", params).map { |record| new(record) }
     end
@@ -95,8 +106,11 @@ module Rodoo
     # @example
     #   all_contacts = Rodoo::Contact.all(limit: 100)
     #
-    def self.all(fields: nil, limit: nil)
-      where([], fields: fields, limit: limit)
+    # @example With language
+    #   all_contacts = Rodoo::Contact.all(limit: 100, lang: "de_DE")
+    #
+    def self.all(fields: nil, limit: nil, lang: nil)
+      where([], fields: fields, limit: limit, lang: lang)
     end
 
     # Find a single record by attribute conditions
@@ -116,8 +130,11 @@ module Rodoo
     # @example Find by raw domain
     #   contact = Rodoo::Contact.find_by([["name", "ilike", "%acme%"]])
     #
-    def self.find_by(conditions = nil, **attrs)
-      where(conditions, limit: 1, **attrs).first
+    # @example With language
+    #   contact = Rodoo::Contact.find_by(name: "Acme", lang: "fr_FR")
+    #
+    def self.find_by(conditions = nil, lang: nil, **attrs)
+      where(conditions, limit: 1, lang: lang, **attrs).first
     end
 
     # Find a single record by attribute conditions, raising if not found
@@ -129,8 +146,11 @@ module Rodoo
     # @example Find by email (raises if not found)
     #   contact = Rodoo::Contact.find_by!(email: "john@example.com")
     #
-    def self.find_by!(conditions = nil, **attrs)
-      record = find_by(conditions, **attrs)
+    # @example With language
+    #   contact = Rodoo::Contact.find_by!(email: "john@example.com", lang: "it_IT")
+    #
+    def self.find_by!(conditions = nil, lang: nil, **attrs)
+      record = find_by(conditions, lang: lang, **attrs)
       return record if record
 
       raise NotFoundError, "#{model_name} matching #{conditions.inspect} #{attrs.inspect} not found"
@@ -145,9 +165,15 @@ module Rodoo
     #   contact = Rodoo::Contact.create(name: "New Contact", email: "new@example.com")
     #   contact.id  # => 123
     #
-    def self.create(attrs)
-      ids = execute("create", vals_list: [attrs])
-      find(ids.first)
+    # @example With language
+    #   contact = Rodoo::Contact.create({ name: "Nouveau Contact" }, lang: "fr_FR")
+    #
+    def self.create(attrs = nil, lang: nil, **kwargs)
+      actual_attrs = attrs || kwargs
+      params = { vals_list: [actual_attrs] }
+      params[:context] = { lang: lang } if lang
+      ids = execute("create", params)
+      find(ids.first, lang: lang)
     end
 
     # Execute an Odoo method via the JSON-2 API

data/lib/rodoo/models/accounting_entry.rb

@@ -36,25 +36,27 @@ module Rodoo
     # Search for records, automatically scoped to the move_type
     #
     # @param conditions [Array, Hash, String, nil] Query conditions
-    # @param options [Hash] Additional options (fields, limit, offset)
+    # @param options [Hash] Additional options (fields, limit, offset, lang)
     # @return [Array<AccountingEntry>] Array of matching records
     def self.where(conditions = nil, **options)
-      domain = DomainBuilder.build(conditions, options.except(:fields, :limit, :offset))
+      domain = DomainBuilder.build(conditions, options.except(:fields, :limit, :offset, :lang))
       domain = [["move_type", "=", default_move_type]] + domain if default_move_type
-      super(domain, **options.slice(:fields, :limit, :offset))
+      super(domain, **options.slice(:fields, :limit, :offset, :lang))
     end
 
     # Create a new record, automatically setting the move_type
     #
     # @param attrs [Hash] Attributes for the new record
+    # @param lang [String, nil] Language code for translatable fields
     # @return [AccountingEntry] The created record
-    def self.create(attrs)
+    def self.create(attrs = nil, lang: nil, **kwargs)
+      actual_attrs = attrs || kwargs
       scoped_attrs = if default_move_type
-                       { move_type: default_move_type }.merge(attrs)
+                       { move_type: default_move_type }.merge(actual_attrs)
                      else
-                       attrs
+                       actual_attrs
                      end
-      super(scoped_attrs)
+      super(scoped_attrs, lang: lang)
     end
 
     # Attach a PDF file to this record

data/lib/rodoo/models/project.rb

@@ -10,7 +10,8 @@ module Rodoo
   #   project = Rodoo::Project.where([["is_company", "=", true]])
   #
   # @example Create a project
-  #   project = Rodoo::Project.create(name: "my_project", account_id: analytic_account_id, allow_billable: true)
+  #   project = Rodoo::Project.create(name: "my_project", account_id: analytic_account_id,
+  #     allow_billable: true)
   #
   class Project < Model
     model_name "project.project"

data/lib/rodoo/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rodoo
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rodrigo Serrano
@@ -31,6 +31,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/skills/release/SKILL.md"
 - ".env.example"
 - ".rubocop.yml"
 - CHANGELOG.md