💎 Improvements:
1️⃣ New support query với giá trị Hash
2️⃣ Chúng ta không cần phải dùng truy vấn raw version nữa

💎 Bonus:
1️⃣ Cú pháp mới cũng support chúng ta sử dụng alias
2️⃣ Sử dụng tương tự cho ActiveRecord#reselect

# Before Rails 7.1

Post.joins(:comments)
    .select(
      "posts.id as post_id, posts.title as post_title,
      comments.id as comment_id, comments.body as comment_body"
    )
    
Post.joins(:comments).select(:id, :title, "comments.body")

# After Rails 7.1

Post.joins(:comments)
    .select(
      posts: { id: :post_id, title: :post_title },
      comments: { id: :comments_id, body: :comment_body }
    )
    
Post.joins(:comments).select(:id, :title, comments: [:body] )

The post [Rails Tips] Rails 7.1 – ActiveRecord::QueryMethods#select has added support for hash values appeared first on Tomoshare.

Slack là một phần mềm Worksplace sử dụng thông dụng rộng rãi. Tuy nhiên, ta có thể sử dụng slack để theo dõi và giám sát hệ thống, gửi tin nhắn tự động.

Sau đây, mình sẽ hướng dẫn mọi người cách để gửi thông báo, tin nhắn … đến slack trong rails app, nó làm cho Rails Application của bạn có thể trở nên năng động và hiệu quả hơn.

Setup Slack:

Đầu tiên, bạn phải có 1 Worksplace, 1 channel nào đó rồi nhé.

• Bạn cần tạo một App Slack từ https://api.slack.com/apps, chọn Create an app → From Scratch (điền tên và chọn workspace)

• Chọn tab Incoming Webhooks bạn sẽ có:
  • Webhook URL
  • Channel

Setup Rails:

Đầu tiên, bạn tự thêm gem vào trong Gemfile và Bundle nhé.

1. Sử dụng slack-notifier

• gem "slack-notifier" https://github.com/slack-notifier/slack-notifier
• Tạo 1 module SlackNotifier để tiện cho việc gọi khi cần.
  • ENV[‘SLACK_WEBHOOK_URL’], ENV[‘SLACK_CHANNEL_SLACK’] bạn lấy ở bên trên.
  • ENV[‘SLACK_USERNAME_SLACK’] bạn đặt tự do.

#config/initializers create slack_notifier.rb

module SlackNotifier
  CLIENT = Slack::Notifier.new(
    ENV['SLACK_WEBHOOK_URL'],
    channel: ENV['SLACK_CHANNEL_SLACK'],
    username: ENV['SLACK_USERNAME_SLACK']
  )
end

SlackNotifier::CLIENT.ping "Hello Everybody!"
SlackNotifier::CLIENT.ping "TEST SLACK NOTIFICATION"

• Kết quả

• Ngoài ra, bạn có thể custom nhiều hơn nữa, xem thêm tại https://github.com/slack-notifier/slack-notifier

2. Sử dụng exception-notification

• Gem này sẽ tự động gửi exception về slack của bạn khi Rails App xảy exception. Nó giúp việc giám sát hệ thống, giúp bạn nhanh chóng kiểm tra, sửa chữa kịp thời.
• gem exception_notification https://github.com/smartinez87/exception_notification
• Nếu ở production: config/environments/production.rb

#config/environments/development.rb

Rails.application.config.middleware.use ExceptionNotification::Rack, slack: {
  webhook_url: ENV['SLACK_WEBHOOK_URL'],
  channel: ENV['SLACK_CHANNEL_NAME']
	}

• Đặt ở nơi bạn muốn push notify nhé.

rescue_from StandardError do |e|
  ExceptionNotifier.notify_exception(e, 
		data: {
			# custom message ... 
			messages: e.messages
			date: Date.current
		}
	)
end

• Kết quả

• Ngoài ra, bạn có thể custom nhiều hơn nữa, xem thêm tại https://github.com/smartinez87/exception_notification

Hi vọng bài viết sẽ giúp ích được mọi người.

Cảm ơn mọi người.

The post Setup slack notifications in Rails appeared first on Tomoshare.

Trong bài đăng blog này, chúng ta sẽ khám phá quá trình xây dựng một GraphQL API trong Ruby on Rails, một framework mạnh mẽ và thân thiện với nhà phát triển.

GraphQL là gì?

GraphQL là một ngôn ngữ truy vấn dành cho API và là một runtime để thực hiện những truy vấn đó đối với dữ liệu của bạn. Khác với các API REST truyền thống, nơi máy khách có kiểm soát hạn chế về dữ liệu mà nó nhận được, GraphQL cho phép máy khách yêu cầu chỉ những dữ liệu cần thiết. Điều này dẫn đến quá trình truy xuất dữ liệu hiệu quả và chính xác hơn.

Thiết Lập Dự Án Rails

Trước khi đào sâu vào GraphQL, hãy thiết lập một dự án Rails mới. Mở terminal và chạy các lệnh sau:

rails new graphql_api 
cd graphql_api

Thêm Dependencies

Để tích hợp GraphQL vào dự án Rails của bạn, bạn sẽ cần thêm một số gems vào Gemfile. Mở Gemfile và bao gồm các dòng sau:

# Gemfile 

gem 'graphql' 
gem 'graphiql-rails', group: :development

Chạy bundle install để cài đặt các gems này.

Tạo Schema GraphQL

Trong GraphQL, schema xác định các loại và các hoạt động có thể thực hiện trên dữ liệu của bạn. Hãy tạo một schema đơn giản cho ứng dụng blog. Chạy lệnh sau để tạo một schema GraphQL mới:

rails generate graphql:install

Lệnh này sẽ tạo một thư mục graphql trong thư mục dự án của bạn, chứa một tệp schema cơ bản (app/graphql/types/query_type.rb). Tùy chỉnh tệp này để xác định schema GraphQL của bạn.

# app/graphql/types/query_type.rb 

module Types 
  class QueryType < Types::BaseObject 
    field :posts, [Types::PostType], null: false 
    
    def posts 
      Post.all
    end 
  end 
end

Định Nghĩa Các Loại

Trong ví dụ này, chúng ta đã tạo một trường posts trả về một mảng các đối tượng Post. Bạn cũng cần xác định PostType.

• Đừng quên là hãy chạy lệnh rails generate model Post title:string content:text và rails db:migrate để tạo ra bảng Post trước

Tạo một tệp mới app/graphql/types/post_type.rb:

# app/graphql/types/post_type.rb 

module Types 
  class PostType < Types::BaseObject 
    field :id, ID, null: false 
    field :title, String, null: false 
    field :content, String, null: false 
  end 
end

Tệp này xác định cấu trúc của một loại Post với các trường id, title, và content.

Kiểm Thử với GraphiQL

GraphiQL là một công cụ đồ họa tương tác trực tuyến dành cho GraphQL giúp đơn giản hóa quá trình kiểm thử các truy vấn GraphQL của bạn. Để kích hoạt GraphiQL, mở tệp config/routes.rb và thêm các dòng sau:

# config/routes.rb 

if Rails.env.development? 
  mount GraphiQL::Rails::Engine, at: "/graphiql", graphql_path: "/graphql" end 
  
post "/graphql", to: "graphql#execute"

Bây giờ, khi bạn chạy máy chủ Rails của mình (rails server), bạn có thể truy cập http://localhost:3000/graphiql để tương tác với GraphQL API của bạn.

Thực Hiện Các Truy Vấn

Bây giờ, bạn có thể kiểm thử các truy vấn GraphQL của mình trong GraphiQL. Ví dụ:

query {
  posts {
    id
    title
    content
  }
}

Truy vấn này sẽ truy xuất tất cả các bài viết cùng với các trường id, title, và content.

Chúc mừng! Bạn đã xây dựng thành công một GraphQL API trong Ruby on Rails.
Happy coding!

The post Building a GraphQL API in Rails appeared first on Tomoshare.

Step 2: Click Go to Application in Home page -> Projects

Step 3: Click to Setup Project button in the right Repo you want to setup

Step 4: Select first Radio Button -> Set Up Project

After setup, click Dashboard and display as below

Step 5: Click Project Setting -> SSH Key and check if the ssh key has been linked or not.

Step 6: If you using Git Submodule, please create a Additional SSH Keys

1. Open terminal and run ssh-keygen -t ed25519 -C "Circle CI".
2. Click Add SSH Key and enter

• Hostname: github.com
• Private Key: cat minh_id_ed25519, copy and paste

3. Back to Github, select Repository Shared submodule -> Settings -> Deploy Keys -> Add deploy key
4. Enter Title and Key -> Add Key

Step 7: Back to project setup config CircleCI and Danger

1. Add to Gemfile

gem 'brakeman', require: false
gem 'danger', '9.2.0'
# A Danger plugin to lint Ruby files through danger-brakeman_scanner.</em>
gem 'danger-brakeman_scanner', '0.1.1'
# A Danger plugin to lint Ruby files through rails_best_practices.</em>
gem 'danger-rails_best_practices', '0.1.3'
# A Danger plugin to lint Ruby files through Reek.</em>
gem 'danger-reek', '0.3.0'
# A Danger plugin for running Ruby files through Rubocop.</em>
gem 'danger-rubocop', '0.10.0'
# A Danger plugin to report code coverage generated by SimpleCov in JSON format.</em>
gem 'danger-simplecov_json', '0.3.0'

2. Create file in .circleci/config.yml and paste code

# Best practises:
#   [https://www.netguru.com/blog/top-10-best-practises-to-benefit-more-form-circleci]
#   [https://circleci.com/blog/six-optimization-tips-for-your-config/]
references:
  working_directory: &working_directory ~/quinblog
  images:
    base_image: &base_image
      image: cimg/ruby:3.2.1
      environment:
        TZ: /usr/share/zoneinfo/Asia/Tokyo
        BUNDLE_JOBS: 4
        BUNDLE_RETRY: 3
        BUNDLE_PATH: vendor/bundle
        GEM_PATH: vendor/bundle
        RAILS_ENV: test
    db_image: &db_image
      image: cimg/postgres:14.4
      environment:
        POSTGRES_USER: postgres
        POSTGRES_DB: quinblog_test
        POSTGRES_PASSWORD: postgres
    redis_image: &redis_image
      image: cimg/redis:5.0
    mongodb_image: &mongodb_image
      image: circleci/mongo:3.6
  commands:
    move_database_yml: &move_database_yml
      name: Move database_yml
      command: mv config/database.ci.yml config/database.yml
    move_mongoid_yml: &move_mongoid_yml
      name: Move mongoid_yml
      command: mv config/mongoid.ci.yml config/mongoid.yml
    sync_git_submodule: &sync_git_submodule
      name: Sync git submodule
      command: |
        git submodule sync --recursive --quiet
        git submodule update --init --checkout --recursive --quiet

# Use the latest 2.1 version of CircleCI pipeline process engine.
# See: https://circleci.com/docs/2.0/configuration-reference
version: 2.1

# Orbs are reusable packages of CircleCI configuration that you may share across projects, enabling you to create encapsulated, parameterized commands, jobs, and executors that can be used across multiple projects.
# See: https://circleci.com/docs/2.0/orb-intro/
orbs:
  ruby: circleci/ruby@1.8.0

# Define a job to be invoked later in a workflow.
# See: https://circleci.com/docs/2.0/configuration-reference/#jobs
jobs:
  build:
    working_directory: *working_directory
    resource_class: small
    parallelism: 1
    docker:
      - *base_image
    steps:
      - add_ssh_keys:
          fingerprints:
            - '7c:72:77:4f:79:12:cb:af:c9:84:7b:d1:ab:24:69:41'
      - checkout

      - run: *move_database_yml
      - run: *move_mongoid_yml
      - run: *sync_git_submodule
      - run:
          name: Disabled auto completion
          command: echo 'IRB.conf[:USE_AUTOCOMPLETE] = false' >> ~/.irbrc

      # Restoring and saving cache
      - ruby/install-deps

      - persist_to_workspace:
          root: *working_directory
          paths:
            - ./*

  test:
    working_directory: *working_directory
    resource_class: small
    parallelism: 2
    docker:
      - *base_image
      - *db_image
      - *mongodb_image
      - *redis_image
    steps:
      - attach_workspace:
          at: *working_directory

      - run:
          name: Wait for Postgres DB
          command: dockerize -wait tcp://localhost:5432 -timeout 1m

      - run:
          name: Wait for Mongo DB
          command: dockerize -wait tcp://localhost:27017 -timeout 1m

      - run:
          name: Wait for Redis DB
          command: dockerize -wait tcp://localhost:6379 -timeout 1m

      - run:
          name: Migration DB
          command: |
            bundle exec rails db:schema:load:primary --trace
            bundle exec rails db:create:universal
            bundle exec rails db:schema:load:universal --trace

      - run:
          name: Run rspec
          command: |
            TESTFILES=$(circleci tests glob "spec/**/*_spec.rb" | circleci tests split --split-by=timings --timings-type=classname)
            echo ${TESTFILES}
            bundle exec rspec --profile 10 \
                              --format progress \
                              --format RspecJunitFormatter --out /tmp/test-results/rspec/rspec.xml \
                              ${TESTFILES}

      # Collect test data
      # See: https://circleci.com/docs/collect-test-data
      # See: https://circleci.com/blog/how-to-output-junit-tests-through-circleci-2-0-for-expanded-insights/
      - store_test_results:
          path: /tmp/test-results/rspec/

      - run:
          name: Run danger
          command: bundle exec danger --danger_id=test

  lint:
    working_directory: *working_directory
    resource_class: small
    parallelism: 1
    docker:
      - *base_image
    steps:
      - attach_workspace:
          at: *working_directory

      - run:
          name: Run danger
          command: bundle exec danger --danger_id=lint

# Invoke jobs via workflows
# See: https://circleci.com/docs/2.0/configuration-reference/#workflows
workflows:
  build_and_test:
    jobs:
      - build
      - test:
          context:
            - ctx_renew_api_company
          requires:
            - build
      - lint:
          context:
            - ctx_renew_api_company
          requires:
            - build

Step 8: Config Danger. Create Dangerfile and paste code below:

# frozen_string_literal: true

case ENV.fetch('CIRCLE_JOB', nil)

when 'lint'

  ### for Rubocop ###

  rubocop.lint(force_exclusion: true, inline_comment: true)

  ### for rails_best_practices ###

  # rails_best_practices.lint

  ### for Reek ###

  # reek.lint

  ### for brakeman ###

  brakeman.run('.')

  # Ensure there is a summary for a pr

  failure('Please provide a summary in the Pull Request description') if     github.pr_body.include?('___WRITE_HERE___')

  # Ensure that all prs have an assignee

  failure('This PR does not have any assignees yet.') unless github.pr_json['assignee']

  # Warn really big diffs

  warn('We cannot handle the scale of this PR') if git.lines_of_code > 300

  # Note when a pr cannot be manually merged, which goes away when you can

  warn('This PR cannot be merged yet.', sticky: false) unless github.pr_json['mergeable']

 when 'test'

  ### for SimpleCov ###

  coverage_file = 'coverage/coverage.json'

  simplecov.report(coverage_file, sticky: false)

  simplecov.individual_report(coverage_file, Dir.pwd)

end

Step 9: Back to CircleCI -> Click Organization Settings -> Contexts -> Create Context

Step 10: Enter name Context and click Create Context

Step 11: Click Context Name created and add environment for project such as RAILS_MASTER_KEY, RAILS_ENV, RACK_ENV, DANGER_GITHUB_API_TOKEN

Click Add Environment and enter value as below:

Note:

• RAILS_MASTER_KEY: Open file config/crendentials/test.key on project and copy it.
• RAILS_ENV: test
• RACK_ENV: test

After add 3 environments, it will displayed as below:

Step 12: Create DANGER_GITHUB_API_TOKEN

1. Access https://github.com/settings/tokens and click Generate new token

2. Write Note and Select Expiration, Scope. I choose Expiration 90 days and click repo

3. Click Generate Token and Copy this.

4. Back to Context and Add DANGER_GITHUB_API_TOKEN

Step 12: Push code and runnnnn

The post [ROR] Hướng dẫn setup CircleCI & Code Quality appeared first on Tomoshare.

1. Giới Thiệu Về CarrierWave

CarrierWave là một gem Ruby on Rails mạnh mẽ được thiết kế để giúp bạn quản lý và xử lý tệp tin tải lên, đặc biệt là ảnh. Với tính năng linh hoạt và dễ sử dụng, CarrierWave giúp bạn dễ dàng thay đổi kích thước ảnh, lưu trữ trên các dịch vụ như Amazon S3, và thậm chí cả tạo các phiên bản ảnh thumbnail.

2. Cài Đặt CarrierWave

Để bắt đầu, thêm gem CarrierWave vào Gemfile của bạn:

gem 'carrierwave'

Sau đó, cài đặt và sinh ra file cấu hình:

bundle install
rails generate uploader Avatar

3. Sử Dụng CarrierWave Trong Model

class User < ApplicationRecord
  mount_uploader :avatar, AvatarUploader
end

Ở đây, avatar là tên của trường chứa đường dẫn đến tệp tin đã được tải lên, và AvatarUploader là tên của uploader đã được sinh ra trước đó.

4. Xử Lý Ảnh Trong Controller

class UsersController < ApplicationController
  def update
    @user = User.find(params[:id])
    @user.update(user_params)
  end

  private

  def user_params
    params.require(:user).permit(:avatar)
  end
end

5. Hiển Thị Ảnh Trong View

<%= image_tag @user.avatar.url if @user.avatar.present? %>

6. Tính Năng Mở Rộng

CarrierWave cho phép bạn thực hiện nhiều tính năng hấp dẫn như:

• Thay Đổi Kích Thước Ảnh:

# Trong AvatarUploader
version :thumb do
  process resize_to_fill: [150, 150]
end

• Lưu Trữ Trên S3:

# Trong config/initializers/carrierwave.rb
config.fog_credentials = {
  provider: 'AWS',
  aws_access_key_id: 'your_access_key',
  aws_secret_access_key: 'your_secret_key',
  region: 'your_region'
}

config.fog_directory = 'your_bucket_name'

7. Kết Luận

Gem CarrierWave không chỉ giúp bạn dễ dàng quản lý tệp tin tải lên mà còn mở ra nhiều khả năng mở rộng. Sử dụng nó để tối ưu hóa trải nghiệm người dùng trong ứng dụng Rails của bạn và tận dụng tất cả những tính năng mà nó mang lại. Happy coding!

The post Generating Image Thumbnails in Your Rails Application with CarrierWave appeared first on Tomoshare.

Khi nào và tại sao nên sử dụng view component?

Như đã nêu trước đó, các thành phần view là có thể tái sử dụng và có thể kiểm thử. Do đó, chúng có thể được áp dụng khi một view cần được tái sử dụng hoặc có lợi từ việc được kiểm thử trực tiếp. Một số lợi ích của các thành phần view, như đã nêu trong tài liệu của chúng, bao gồm các điểm sau:

• Chúng nhanh gấp đôi (khoảng 10 lần) so với partials.
• là các đối tượng Ruby, do đó, phương thức khởi tạo của chúng rõ ràng xác định những gì cần thiết để hiển thị một view. Điều này có nghĩa là chúng dễ hiểu hơn và có thể tái sử dụng trong nhiều view khác nhau. Hơn nữa, các tiêu chuẩn chất lượng mã Ruby có thể được áp dụng, giúp giảm rủi ro của lỗi.
• có thể được kiểm thử đơn vị, trong khi các view truyền thống của Rails yêu cầu kiểm thử tích hợp, cũng bao gồm việc thực hiện routing và controller ngoài việc hiển thị view.

Triển khai viewcomponent

Các ViewComponent là các lớp con của ViewComponent::Base và được đặt trong thư mục app/components. Tên của chúng kết thúc bằng – Component và nên được đặt theo cái mà chúng hiển thị chứ không phải cái mà chúng nhận. Chúng ta có thể tạo một view component bằng cách thủ công hoặc thông qua trình tạo component, nhưng trước tiên chúng ta cần thêm gem vào file gemfile và chạy lệnh bundle install.

gem "view_component"

Để sử dụng trình tạo, chạy lệnh sau đây:

rails generate component <Component name> <arguments needed for initialization>

Ví dụ, nếu chúng ta muốn tạo một component để hiển thị danh sách các khóa học trong lớp có sẵn trên một nền tảng học tập, chúng ta có thể sử dụng lệnh sau đây:

rails g component Course course

Chúng ta đang truyền đối số course vào lệnh này vì chúng ta sẽ khởi tạo đối tượng Ruby này với khóa học mà chúng ta mong muốn nó hiển thị, và chúng ta đã đặt tên là Course vì nó hiển thị một khóa học.

Như chúng ta có thể thấy ở trên, component và file html tương ứng được tạo trong thư mục app/components, cùng với một file test

ViewComponent bao gồm các bộ tạo mẫu cho các công cụ mẫu erb, haml và slim, nhưng sẽ mặc định theo công cụ mẫu được chỉ định trong config.generators.template_engine. Tuy nhiên, bạn có thể chỉ định công cụ mẫu mong muốn bằng cách sử dụng các câu lệnh sau:

rails generate component Course course --template-engine <your template engine>

Tiếp theo, chúng ta sẽ tạo model Course và một số khóa học để hiển thị.

rails g model Course title:string price:decimal location:string
rails db:migrate

Tạo hai khóa học mẫu:

Course.create(title: 'The Art of Learning', price: 125.00, location: 'Denmark')
Course.create(title: 'Organizing your Time', price: 55.00, location: 'London')

Tệp course_component.rb được tạo ra với phương thức initialize  được hiển thị dưới đây.

Tiếp theo là tạo controller và routes

rails g controller Courses index

chỉnh sửa root của trang

root 'courses#index'

Tạo giao diện, viêc tạo giao diện được thiện hiện ở file course_component.html.erb. mà chúng ta đã gen ở trước đó.


<div>
  <h2><%= @course.title %></h2>
  <h4><%=  number_to_currency(@course.price, :unit => "€") %></h4>
  <h4><%= @course.location %></h4>
</div>

ở view, chúng ta hiển thị tiêu đề khóa học, giá và địa điểm sử dụng biến @course, đã được định nghĩa trong phương thức initialize của CourseComponent. Điều này tương tự khi tạo một biến trong một method ở controller và sau đó nó sẽ có sẵn trong một giao diện.

để biết cách controller hoạt động thì chuyển đến trang index.html.erb với method index tương ứng ở controller. ở đây chúng ta sẽ render component

Như đã thấy ở trên, chúng ta render new instance của CourseComponent bằng cách khởi tạo courseComponent với khóa học mà chúng ta muốn nó hiển thị trong giao diện index course. Khóa học này trở thành biến @course được cung cấp cho tệp course_component.html.erb.

Chúng ta có thể render trực tiếp ở controller như sau

Nội dung bổ sung cũng có thể được truyền vào component theo một trong những cách sau đây:

<%= render(CourseComponent.new(course: Course.find(1))) do %>
  container
<% end %>
<%= render(CourseComponent.new(course: Course.find(1)).with_content("container")) %>

Trong file component, chúng ta có thể include nội dung ở bất kỳ đâu mà chúng ta muốn. Trong trường hợp này, chúng ta sẽ thêm content như một class bằng cách chỉnh sửa thẻ div như sau:

Render a Collection

Nếu chúng ta muốn hiển thị toàn bộ danh sách các khóa học, ViewComponent cung cấp một cách rất đơn giản để làm điều này bằng cách sử dụng method with_collection. Thay vì khởi tạo component bằng cách sử dụng .new, nó được khởi tạo bằng cách sử dụng .with_collection, và collection được truyền vào như một biến

CourseComponent.with_collection(Course.all)

 thẻ with_collection_parameter có sẵn trong trường hợp chúng ta muốn đặt tên khác cho bộ sưu tập.

Trong trường hợp trên, tham số của khóa học đã được đặt tên là “item”. Do đó, trong tệp xem tương ứng, “@course” sẽ được thay thế bằng “@item” để được kết quả tương tự.

Các tham số bổ sung cũng có thể được thêm vào collection. Các tham số này sẽ được hiển thị cho mỗi mục trong collection. Hãy thêm văn bản “Buy Me” vào mỗi mục thông qua phương thức này.

thêm @noitce vào file course_component.html.erb

<p><a href='#'> <%= @notice %> </a></p>

Cuối cùng, trong tùy chọn collections, chúng ta có một biến đếm (counter variable) có thể được kích hoạt để đánh số các mục. Để kích hoạt biến đếm này, chúng ta cần thêm “_counter” vào tham số của bộ sưu tập và làm cho nó có sẵn trong các tệp xem thông qua phương thức initialize.

Xem bài viết đầy đủ tại đây: https://www.honeybadger.io/blog/ruby-view-components/

Thank you!!!

The post An Introduction to the ViewComponent Gem appeared first on Tomoshare.