DEV Community

Cover image for Simple ToDo GraphQL API in Ruby on Rails and MongoDB with Docker [PART 01]
Sulman Baig
Sulman Baig

Posted on

Simple ToDo GraphQL API in Ruby on Rails and MongoDB with Docker [PART 01]

Complete Code of App is here:

ToDo App

TODO APP

built by @sulmanweb

Technologies

  • Docker

API (rails-api)

  • Ruby on Rails 6
  • MongoDB 4
  • GraphQL

Vue Front End

  • VueJS 2
  • TailwindCSS
  • FontAwesome
  • Apollo GraphQL Client

To Run





I have been working in PostgresSQL and REST API for a long time. So as a challenge I decided to create an API in rails with GraphQL using MongoDB.

As now in most of my development, I use Docker so this project will also contain Docker.

I will be using MongoID and GraphQL-rails gems to create this app and will be using JWT token authentication for authenticating users.

This is a simple API in which a user will sign up or sign in, and then he or she can create lists and each list will have many to-dos that can only be seen by the logged-in users so each user will have to-dos of his or her own.

Initialise Rails Project in Docker:

First, create a folder named todo–app in your working directory then use git init to initialize git in that directory. Next, create docker-compose.yml

todo-app/docker-compose.yml

version: "3.7"
services:

  mongo-service:
    image: "mongo:4.2.8"
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: example
    ports:
      - "27017:27017"
    volumes:
      - "mongodb:/var/lib/mongodb/data"

  rails-api:
    build: ./rails-api
    environment:
      - PORT=3000
    volumes:
      - ./rails-api:/rails-api:delegated
      - rails_log:/rails-api/log
      # don't mount tmp directory
      - /rails-api/tmp
      - ./rails-api/storage:/rails/storage
    ports:
      - "3000:3000"
    depends_on:
      - mongo-service

volumes:
  mongodb:
  rails_log:
Enter fullscreen mode Exit fullscreen mode

This file will create mongo-service in docker and attach to rails. Next, it will assume there is a rails-api folder in todo-app where rails code will be present.

Now create a folder inside todo-app named rails-api and create a file named Dockerfile and add the following content:

todo-app/rails-api/Dockerfile

FROM ruby:2.6.6

WORKDIR /rails-api

COPY Gemfile Gemfile.lock ./
RUN mkdir -p log && touch log/development.log

RUN gem install bundler

RUN bundle install

RUN gem install foreman

# Start the main process.
CMD ["foreman", "start", "-f", "Procfile"]
Enter fullscreen mode Exit fullscreen mode

This file tells Docker to create an image with ruby 2.6.6 and install everything present in Gemfile and Gemfile.lock and then run foreman command.

Now create a file in rails-api named Gemfile with the following content:

todo-app/rails-api/Gemfile

source 'https://rubygems.org'
gem 'rails', '~> 6.0', '>= 6.0.3.1'
Enter fullscreen mode Exit fullscreen mode

This file will tell docker to install rails 6 on the ruby image.
Also, now create empty file named todo-app/rails-api/Gemfile.lock. Both these files will be edited when we initialize the rails project in docker.

Now create a Procfile which will be used by the foreman to run rails in docker.

todo-app/rails-api/Procfile

web: bundle exec rails s -b 0.0.0.0 -p ${PORT}
logger: tail -f log/development.log
Enter fullscreen mode Exit fullscreen mode

Finally, write the following command in terminal of the todo-app that will initialize rails project skipping unit testings as we will use RSpec for testing, skipping ActiveRecord that is used by rails when using SQL.

docker-compose run rails-api rails new . --api --skip-active-record --skip-bundle --skip-test --skip-system-test --force --no-deps
Enter fullscreen mode Exit fullscreen mode

Now you will see that the rails-api folder is filled with rails files and folders.

Updating Gems To be used in the project:

Add some extra gems to your Gemfile that will be used by our project.

Now in bash terminal first down all instances of current docker-compose and build the docker from the start by entering following commands:

docker-compose down -v
Enter fullscreen mode Exit fullscreen mode
docker-compose up --build -d
Enter fullscreen mode Exit fullscreen mode

Now new instance will be created with all the gems installed with the new ones.

Attaching mongo with rails and graphql initialization:

Initialize mongo in rails by the following command in terminal:

docker-compose run rails-api bin/rails g mongoid/config
Enter fullscreen mode Exit fullscreen mode

Change hosts and options for both development and test in the mongo config file in rails:

todo-app/rails-api/config/mongoid.yml

development:
  # Configure available database clients. (required)
  clients:
    # Defines the default client. (required)
    default:
      # Defines the name of the default database that Mongoid can connect to.
      # (required).
      database: rails_api_development
      # Provides the hosts the default client can connect to. Must be an array
      # of host:port pairs. (required)
      hosts:
        - mongo-service:27017
      options:
        server_selection_timeout: 1
Enter fullscreen mode Exit fullscreen mode

Now initialize graphql in rails by entering in the terminal

docker-compose run rails-api rails generate graphql:install
Enter fullscreen mode Exit fullscreen mode

Also add following line in routes of rails to have graphql ui enabled:

todo-app/rails-api/config/routes.rb

mount GraphqlPlayground::Rails::Engine, at: "/graphiql", graphql_path: "graphql#execute"
Enter fullscreen mode Exit fullscreen mode

Initialising RSpec:

Write in terminal:

docker-compose run rails-api rails generate rspec:install
Enter fullscreen mode Exit fullscreen mode

Change rails_helper.rb with the following code:

todo-app/rails-api/spec/rails_helper.rb

# frozen_string_literal: true

# This file is copied to spec/ when you run 'rails generate rspec:install'
require File.expand_path('../config/environment', __dir__)
ENV['RAILS_ENV'] ||= 'test'
require 'rspec/rails'
require 'spec_helper'
# require 'pundit/rspec'
# require "action_cable/testing/rspec"
include ActiveJob::TestHelper

FactoryBot::SyntaxRunner.class_eval do
  include ActionDispatch::TestProcess
end
# Prevent database truncation if the environment is production
abort('The Rails environment is running in production mode!') if Rails.env.production?
# Add additional requirements below this line. Rails is not loaded until this point!

# Requires supporting ruby files with custom matchers and macros, etc, in
# spec/support/ and its subdirectories. Files matching `spec/**/*_spec.rb` are
# run as spec files by default. This means that files in spec/support that end
# in _spec.rb will both be required and run as specs, causing the specs to be
# run twice. It is recommended that you do not name files matching this glob to
# end with _spec.rb. You can configure this pattern with the --pattern
# option on the command line or in ~/.rspec, .rspec or `.rspec-local`.
#
# The following line is provided for convenience purposes. It has the downside
# of increasing the boot-up time by auto-requiring all files in the support
# directory. Alternatively, in the individual `*_spec.rb` files, manually
# require only the support files necessary.
#
# Dir[Rails.root.join('spec/support/**/*.rb')].each { |f| require f }

# Checks for pending migrations and applies them before tests are run.
# If you are not using ActiveRecord, you can remove this line.
# ActiveRecord::Migration.maintain_test_schema!
ActiveJob::Base.queue_adapter = :test
FactoryBot.rewind_sequences
Faker::UniqueGenerator.clear

RSpec.configure do |config|
  # Remove this line if you're not using ActiveRecord or ActiveRecord fixtures
  config.fixture_path = "#{::Rails.root}/spec/fixtures"

  # If you're not using ActiveRecord, or you'd prefer not to run each of your
  # examples within a transaction, remove the following line or assign false
  # instead of true.
  config.use_transactional_fixtures = true

  # RSpec Rails can automatically mix in different behaviours to your tests
  # based on their file location, for example enabling you to call `get` and
  # `post` in specs under `spec/controllers`.
  #
  # You can disable this behaviour by removing the line below, and instead
  # explicitly tag your specs with their type, e.g.:
  #
  #     RSpec.describe UsersController, :type => :controller do
  #       # ...
  #     end
  #
  # The different available types are documented in the features, such as in
  # https://relishapp.com/rspec/rspec-rails/docs
  config.infer_spec_type_from_file_location!

  # for paperclip
  config.after(:suite) do
    FileUtils.rm_rf(Rails.root.join('tmp', 'storage'))
    # FileUtils.rm_rf("#{::Rails.root}/tmp/storage")
  end

  # Filter lines from Rails gems in backtraces.
  config.filter_rails_from_backtrace!
  # arbitrary gems may also be filtered via:
  # config.filter_gems_from_backtrace("gem name")
end
# Adding headers to request helper
def sign_in_test_headers(user)
  headers = {}
  headers['ACCEPT'] = 'application/json'
  headers['Authorization'] = 'Bearer ' + JsonWebToken.encode({user_id: user.id}).to_s
  headers
end
Enter fullscreen mode Exit fullscreen mode

Also change spec_helper.rb as well with below code:

todo-app/rails-api/spec_helper.rb

# frozen_string_literal: true

# This file was generated by the `rails generate rspec:install` command. Conventionally, all
# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
# The generated `.rspec` file contains `--require spec_helper` which will cause
# this file to always be loaded, without a need to explicitly require it in any
# files.
#
# Given that it is always loaded, you are encouraged to keep this file as
# light-weight as possible. Requiring heavyweight dependencies from this file
# will add to the boot time of your test suite on EVERY test run, even for an
# individual file that may not need all of that loaded. Instead, consider making
# a separate helper file that requires the additional dependencies and performs
# the additional setup, and require it from the spec files that actually need
# it.
#
# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
RSpec.configure do |config|
  # rspec-expectations config goes here. You can use an alternate
  # assertion/expectation library such as wrong or the stdlib/minitest
  # assertions if you prefer.
  config.expect_with :rspec do |expectations|
    # This option will default to `true` in RSpec 4. It makes the `description`
    # and `failure_message` of custom matchers include text for helper methods
    # defined using `chain`, e.g.:
    #     be_bigger_than(2).and_smaller_than(4).description
    #     # => "be bigger than 2 and smaller than 4"
    # ...rather than:
    #     # => "be bigger than 2"
    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
  end

  # rspec-mocks config goes here. You can use an alternate test double
  # library (such as bogus or mocha) by changing the `mock_with` option here.
  config.mock_with :rspec do |mocks|
    # Prevents you from mocking or stubbing a method that does not exist on
    # a real object. This is generally recommended, and will default to
    # `true` in RSpec 4.
    mocks.verify_partial_doubles = true
  end

  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
  # have no way to turn it off -- the option exists only for backwards
  # compatibility in RSpec 3). It causes shared context metadata to be
  # inherited by the metadata hash of host groups and examples, rather than
  # triggering implicit auto-inclusion in groups with matching metadata.
  config.shared_context_metadata_behavior = :apply_to_host_groups

  config.before(:suite) do
    # reindex models
    # User.reindex
    # Restaurant.reindex
    # Dish.reindex
    # Country.reindex
    # Service.reindex
    # Job.reindex
    # Conversation.reindex
    # Booking.reindex
    # Review.reindex

    # and disable callbacks
    # Searchkick.disable_callbacks
  end

  # config.around(:each, search: true) do |example|
  #   Searchkick.callbacks(true) do
  #
  #   end
  # end

  # The settings below are suggested to provide a good initial experience
  # with RSpec, but feel free to customize to your heart's content.
  #   # This allows you to limit a spec run to individual examples or groups
  #   # you care about by tagging them with `:focus` metadata. When nothing
  #   # is tagged with `:focus`, all examples get run. RSpec also provides
  #   # aliases for `it`, `describe`, and `context` that include `:focus`
  #   # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
  #   config.filter_run_when_matching :focus
  #
  #   # Allows RSpec to persist some state between runs in order to support
  #   # the `--only-failures` and `--next-failure` CLI options. We recommend
  #   # you configure your source control system to ignore this file.
  #   config.example_status_persistence_file_path = "spec/examples.txt"
  #
  #   # Limits the available syntax to the non-monkey patched syntax that is
  #   # recommended. For more details, see:
  #   #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
  #   #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
  #   #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
  #   config.disable_monkey_patching!
  #
  #   # Many RSpec users commonly either run the entire suite or an individual
  #   # file, and it's useful to allow more verbose output when running an
  #   # individual spec file.
  #   if config.files_to_run.one?
  #     # Use the documentation formatter for detailed output,
  #     # unless a formatter has already been configured
  #     # (e.g. via a command-line flag).
  #     config.default_formatter = "doc"
  #   end
  #
  #   # Print the 10 slowest examples and example groups at the
  #   # end of the spec run, to help surface which specs are running
  #   # particularly slow.
  #   config.profile_examples = 10
  #
  #   # Run specs in random order to surface order dependencies. If you find an
  #   # order dependency and want to debug it, you can fix the order by providing
  #   # the seed, which is printed after each run.
  #   #     --seed 1234
  #   config.order = :random
  #
  #   # Seed global randomization in this process using the `--seed` CLI option.
  #   # Setting this allows you to use `--seed` to deterministically reproduce
  #   # test failures related to randomization by passing the same `--seed` value
  #   # as the one that triggered the failure.
  #   Kernel.srand config.seed
end
Enter fullscreen mode Exit fullscreen mode

Now rails is fully initialized, so we restart the whole project again on last time:

docker-compose down -v
docker-compose up --build -d
Enter fullscreen mode Exit fullscreen mode

Git Commit:

For committing to the git, we must remove git from the rails folder as the parent folder will be used in git which has docker-compose file. So, in terminal write:

rm -rf rails-api/.git
Enter fullscreen mode Exit fullscreen mode

Create User model

To generate a user model, write in terminal:

docker-compose run rails-api rails g model User email:string password_digest:string
Enter fullscreen mode Exit fullscreen mode

password_digest is the column in which user encrypted password will be saved.

Change user.rb model file with following code:

todo-app/rails-api/app/models/user.rb

require 'bcrypt'
class User
  include BCrypt
  include Mongoid::Document
  # Schema
  field :email, type: String
  field :password_digest, type: String

  # Validations
  validates :email, presence: true, uniqueness: true, format: { with: /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\z/i }
  validates :password, length: {minimum: 8, maximum: 72}, if: :password_required?

  def password
    @password ||= Password.new(password_digest)
  end

  def password=(new_password)
    @password = Password.create(new_password)
    self.password_digest = @password
  end

  private

  # is password required for user?
  def password_required?
    password_digest.nil? || !password.blank?
  end
end
Enter fullscreen mode Exit fullscreen mode

Here we will take the password field from the user and convert to encryption using bcrypt. Also, this file includes basic validations of email and password before saving.

Change the factory of user with the following code:

todo-app/rails-api/spec/factories/users.rb

FactoryBot.define do
  factory :user do
    email { Faker::Internet.unique.email }
    password { "abcd@1234" }
  end
end
Enter fullscreen mode Exit fullscreen mode

This will create new unique email every time we create a user during testing

We will write a simple test of validation by validating factory generated user in user model testing file:

todo-app/rails-api/spec/models/user_spec.rb

require 'rails_helper'

RSpec.describe User, type: :model do
  it "has a valid factory" do
    user = FactoryBot.build(:user)
    expect(user.valid?).to be_truthy
  end
end
Enter fullscreen mode Exit fullscreen mode

To run a test of the app, write in terminal:

docker-compose run rails-api bundle exec rspec
Enter fullscreen mode Exit fullscreen mode

Or if you want to use spring while running RSpec for faster testing add gem spring-commands-rspec in the development group and run the following command to init this for just one time.

docker-compose run rails-api bundle exec spring binstub rspec
Enter fullscreen mode Exit fullscreen mode

After that you can always run rspec suite by running following command:

docker-compose run rails-api bin/rspec
Enter fullscreen mode Exit fullscreen mode

Hope everything will run smoothly else compare your code with GitHub codebase mentioned above.

Create SignUp SignIn Mutations of GraphQL:

User Type

To generate user type in graphql of rails run the following command:

docker-compose run rails-api rails g graphql:object user
Enter fullscreen mode Exit fullscreen mode

This will create a file name user_type.rb fill it with following content:

todo-app/rails-api/app/graphql/types/user_type.rb

module Types
  class UserType < Types::BaseObject
    field :id, ID, null: false, description: "MongoDB User id string"
    field :email, String, null: false, description: "User's email"
  end
end
Enter fullscreen mode Exit fullscreen mode

We want to output the only id which is a string in case of MongoDB and email of the user, not the encrypted password.

Also, we need to create input type of the user which will ask for user email and password during sign up or sign in mutation. So, create a folder named inputs in the types folder and a file named sign_in_input.rb with following content:

todo-app/rails-api/app/graphql/types/inputs/sign_in_input.rb

module Types
  module Inputs
    class SignInInput < BaseInputObject
      argument :email, String, required: true, description: "User's Email"
      argument :password, String, required: true, description: "Password minimum 8 and maximum 72 characters long"
    end
  end
end
Enter fullscreen mode Exit fullscreen mode

The same input will be used to sign up and sign in.

JWT library:

We need to create jwt library for creating an authentication token for authenticating user while using API by creating a jwt library which is placed in lib folder with name json_web_token.rb

todo-app/rails-api/lib/json_web_token.rb

class JsonWebToken
  SECRET_KEY = "SECRET_KEY" # put your secret key here

  def self.encode(payload, exp = 1.year.from_now) # change expiry of token by entering exp time here
    payload[:exp] = exp.to_i
    JWT.encode(payload, SECRET_KEY)
  end

  def self.decode(token)
    decoded = JWT.decode(token, SECRET_KEY)[0]
    HashWithIndifferentAccess.new decoded
  end
end
Enter fullscreen mode Exit fullscreen mode

Sign Up Sign In Mutation:

Now change the base mutation as we will have that authenticate user methods there.

todo-app/rails-api/app/graphql/mutations/base_mutation.rb

module Mutations
  class BaseMutation < GraphQL::Schema::Mutation
    null false
  end
end
Enter fullscreen mode Exit fullscreen mode

Now create folder named auth in mutations folder and create a file named sign_up.rb and add the following content:

todo-app/rails-api/app/graphql/mutations/auth/sign_up.rb

module Mutations
  module Auth
    class SignUp < BaseMutation
      require 'json_web_token'

      description "Sign Up the user into the system"

      argument :input, Types::Inputs::SignInInput, required: true

      field :token, String, null: false, description: "User's Authorizations Token to be used in Authenticated mutations and queries"
      field :user, Types::UserType, null: false, description: "User output"

      def resolve(input: nil)
        user = User.new(email: input.email, password: input.password)
        if user.save
          token = JsonWebToken.encode({user_id: user.id})
          if token
            return {token: token, user: user}
          else
            raise GraphQL::ExecutionError.new("Server was unable to created token. Please try again later.")
          end
        else
          raise GraphQL::ExecutionError.new(user.errors.full_messages.join(', '))
        end
      end
    end
  end
end
Enter fullscreen mode Exit fullscreen mode

So, this will be a mutation that will have an input object with email and password as an argument and return token that will contain user_id and the user type with id and email. If an error comes, it will give graphql execution error.

Lastly, enable this mutation by adding following in mutation type of graphql:

todo-app/rails-api/app/graphql/types/mutation_type.rb

module Types
  class MutationType < Types::BaseObject
    # Auth
    field :sign_up, mutation: Mutations::Auth::SignUp
  end
end
Enter fullscreen mode Exit fullscreen mode

Similarly, we will create sign in mutation:

todo-app/rails-api/app/graphql/mutations/auth/sign_in.rb

module Mutations
  module Auth
    class SignIn < BaseMutation
      require 'json_web_token'

      description "Signs In the user into the system"

      argument :input, Types::Inputs::SignInInput, required: true

      field :token, String, null: false, description: "User's Authorizations Token to be used in Authenticated mutations and queries"
      field :user, Types::UserType, null: false, description: "User output"

      def resolve(input: nil)
        user = User.find_by(email: input.email)
        if user && user.password == input.password
          token = JsonWebToken.encode({user_id: user.id})
          if token
            return {token: token, user: user}
          else
            raise GraphQL::ExecutionError.new("Server was unable to created token. Please try again later.")
          end
        else
          raise GraphQL::ExecutionError.new("Invalid Credentials Provided.")
        end
      end
    end
  end
end
Enter fullscreen mode Exit fullscreen mode

This finds the user with email and verifies the password before giving token and have the same arguments and fields as of sign up.

Enabling the sign-in in mutation type:

todo-app/rails-api/app/graphql/types/mutation_type.rb

module Types
  class MutationType < Types::BaseObject
    # Auth
    field :sign_up, mutation: Mutations::Auth::SignUp
    field :sign_in, mutation: Mutations::Auth::SignIn
  end
end
Enter fullscreen mode Exit fullscreen mode

Testing mutations with RSpec:

Now create a folder named graphql in spec and in that mutations and in that auth folder and create test spec by add following code to sign_up_spec.rb file:

todo-app/rails-api/spec/graphql/mutations/auth/sign_up_spec.rb

require 'rails_helper'

module Mutations
  module Auth
    RSpec.describe SignUp, type: :request do
      describe '.resolve' do
        it 'create a user and signs in the user' do
          params = FactoryBot.attributes_for(:user)
          query = <<~GQL
          mutation {
            signUp(input: {email: "#{params[:email]}", password: "#{params[:password]}"}) {
              token
              user {
                id
                email
              }
            }
          }
          GQL
          post '/graphql', params: {query: query}
          expect(response).to have_http_status(200)
          json = JSON.parse(response.body)
          expect(json["data"]["signUp"]["token"]).not_to be_nil
        end
      end
    end
  end
end
Enter fullscreen mode Exit fullscreen mode

You can see here I am sending the GQL query that if resolved then must have a token in output.

Similarly, RSpec test for sign in will be:
todo-app/rails-api/spec/graphql/mutations/auth/sign_in_spec.rb

require 'rails_helper'

module Mutations
  module Auth
    RSpec.describe SignIn, type: :request do
      describe '.resolve' do
        it 'creates a user session' do
          user = FactoryBot.create(:user)
          query = <<~GQL
          mutation {
            signIn(input: {email: "#{user.email}", password: "abcd@1234"}) {
              token
              user {
                id
                email
              }
            }
          }
          GQL
          post '/graphql', params: {query: query}
          expect(response).to have_http_status(200)
          json = JSON.parse(response.body)
          expect(json["data"]["signIn"]["token"]).not_to be_nil
        end
      end
    end
  end
end
Enter fullscreen mode Exit fullscreen mode

See and test in graphical graphql UI

Restart the server:

docker-compose down -v
docker-compose up --build -d
Enter fullscreen mode Exit fullscreen mode

Run http://localhost:3000/graphiql to run the playground in the browser.

You can see the results in the image below.

GraphQL Playground


So by this little effort. We could create graphql API in rails with MongoDB and beautiful UI for front end developers.

In the next part, I will create mutations and queries for user lists and to-dos.

Happy Coding!

Top comments (7)

Collapse
 
leastbad profile image
leastbad

I have to admit that it seems crazy why anyone would voluntarily use GraphQL when it requires this much boilerplate. I started reading, began skimming and then jumped to the end and read that somehow, after all that, you still haven't created mutations and queries. Do you not see how you are taking the developer ergonomics Rails gives you and just tossing it?

Collapse
 
sulmanweb profile image
Sulman Baig

Yes, I admit it's a bit odd. But If you see till last I managed to create two mutations 😂. The boilerplate in this article is mostly taking initialization of rails in docker which is not so simple and then RSpec suite takes a bit of work. So simple GraphQL and MongoDB initialization are easy enough. The world is moving to the docker platform so I thought I should do with docker. As far as ergonomics are concerned making boilerplate of rails is much much easy for me now after practice. Lastly not every day you create a new app from scratch 😊

Collapse
 
leastbad profile image
leastbad • Edited

Hey Sulman,

I re-read what I sent earlier and it sounds super aggressive - I was unintentionally antagonistic. I was just so floored to see how much bike-shedding was necessary to get to what I experience almost immediately after running rails new. Do you know what I mean?

Without getting into the relative merits, why do you find yourself gravitating towards GraphQL and MongoDB when RESTful resources and Postgres are so amazing to work with? Especially in Rails, it seems like many of the theoretical upsides of MongoDB (no schema) are completely negated, both by ActiveModel enforcing a data structure and Postgres having a JSONB column type that is just as fast and powerful as working with MongoDB? It seems like you're trading a batteries included developer experience for tools that are trendy but far less supported and proven. It wasn't that long ago that MongoDB couldn't guarantee that all data would actually be stored!

I actually installed the graphql-client gem for the first time just the other day, so that I could interact with some of the new endpoints available in Githubs API. I was kind of shocked at how hard it was just to compose what seems like a relatively simple query. It's just so laborious compared to calling REST endpoints. Especially when people are just starting out, nothing about the experience seems simpler to me.

So what am I missing? Is it driven by hype, "everyone is doing it so it must be good"? Is there a major upside I am too slow to see?

Thread Thread
 
sulmanweb profile image
Sulman Baig

Let me explain the purpose of this article in detail:

  • The first and far most important purpose is rails can do it as well
  • You can see many articles of creating rest API of todo with PostgreSQL but not like this.
  • rails is not only about short programming that you write one line and 10 files are created
  • rails best ergonomics is its design of OOP and restrictive architecture
  • I work in nodejs and cause of its openness one developer writes his way other developer writes his own way and when the third developer comes he gets confused what is written in code
  • Due to rails restrictiveness even when graphql laborious still when another user comes to code he will understand the flow.
  • I always prefer rails not because of shorthand but because of smooth coding.
  • Also, rails is hectic to install on windows which still is 70% of the world using that's why instead of simple rails new I devised docker methodology so that all world can work on rails.
  • This article is not for beginners but for intermediate developers that want to switch to node as its cool nowadays to give them a sense that rails is not dead and there is a lot more in rails than the fast development.
  • As far as mongo is concerned I agree with you but still, mongo is faster is not non-deep relationships, and also I used it as its being used as the norm in nodejs.
  • Documentation of rest API is a great issue if we use grape that even changes the development style of ruby or otherwise has to create yaml docs for front end which is a hectic job. But with graphql gem we keep in our normal ruby code and we get beautiful docs for frontend.
  • Also, the frontend can get whatever he/she needs from backend by making query instead of getting all non-relevant data and multiple calls to the server which is the main reason behind graphql creation.
  • Lastly, when working in an industry client sees that graphql and mongo is in these days so they order developers to use those then this article can be helpful.

Apart from those points, your point is valid that its hard to work like this in rails but believe me I have seen these situations where I needed such methodology. So, you can say its the article you may need not for your personal project but for some professional projects.

Hope this answers your confusions

Happy Coding!

Thread Thread
 
leastbad profile image
leastbad

Thanks for the detailed explanation! You sort of answered my question, I guess - your interest in Mongo and GraphQL seems primarily driven by what others are doing and what companies appear to be hiring for. This isn't a bad answer; maybe I was just hoping that you actually loved Mongo and GraphQL for some reason on a personal basis and you could tell me about it.

As you might guess, I'm not a big fan of doing what everyone else is doing just because, but I don't want to be a snob to the folks who think of development only as a job - they could be asked to use these tools because some CTO heard they were the next big thing.

I get (completely) why Mongo appeals to Node devs. Like I said, it's just a lot murkier for Rails devs.

I'm actually on Windows, but I'm using WSL2 so I can have an Ubuntu VM running all of my development concerns. It's amazing! Best of both worlds. Since I can only write code for one project at a time, I don't have a big need for Docker. Again, I'm not working on a team so I understand that I have a different case than you.

Just curious: have you checked out StimulusReflex yet? docs.stimulusreflex.com - it might be the coolest thing you see this week.

Thread Thread
 
sulmanweb profile image
Sulman Baig

Yes, I have been meaning to learn stimulus and stimulus reflex. Soon I will. Right now I know VueJS quite well and you will see VueJS implementation of this API soon.

Also, I love mongo and graphql but not more than the right tool for the right job. And I disagree with the notion that the right tool for the right job means switch to node from ruby as its right tool. Otherwise, I will still prefer graphql over rest but not mongo over postgres.

And maybe soon you will see me writing stimulus reflex tutorial as well 😊.

Happy Coding!

Thread Thread
 
leastbad profile image
leastbad

I honestly believe that Ruby and Rails both bring the world a little closer to happiness.