AuctionFunCore

This lib contains all the business logic necessary to run the auctions. A principle and standard must be strictly followed: The SRP principleThe principle of single responsibility and some standard clean architecture concepts.

Installation

Add this line to your application's Gemfile:

gem 'auction_fun_core'

And then execute:

user@host:~$ bundle install

Or install it yourself as:

user@host:~$ gem install auction_fun_core

Getting Started

Initially, download the project remotely and copy the templates from the project's environment variables:

user@host:~$ git clone git@github.com:ricardopacheco/auction-fun-core.git core
user@host:~$ cd core
user@host:~$ cp .env.development.template .env.development
user@host:~$ cp .env.test.template .env.test

As the idea of this project is to be a lib, it was decided to use a specific environment variable called APP_ENV, so as not to conflict with others if the lib is used by a framework.

Development

Configure the .env.development file with the values according to your machine or network.

Run the commands below to create the database and its structure, remembering to replace the userdb by the user of your postgresql service. By default, if APP_ENV is not provided is considered the value development by default.

OS dependencies

• ASDF

Ruby

Database (PostgreSQL)

    user@host:~$ sudo apt install build-essential libssl-dev libreadline-dev zlib1g-dev libcurl4-openssl-dev uuid-dev
    user@host:~$ asdf plugin add postgres
    user@host:~$ asdf install postgres 16.1
    user@host:~$ rm -rf $HOME/.asdf/installs/postgres/16.1/data
    user@host:~$ initdb -D $HOME/.asdf/installs/postgres/16.1/data -U postgres

    user@host:~$ sudo apt install autoconf patch build-essential rustc libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libgmp-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev uuid-dev
    user@host:~$ asdf plugin add ruby
    user@host:~$ asdf install ruby 3.3.0
    user@host:~$ gem install pg -v 1.5.5 --verbose -- --with-pg-config=$HOME/.asdf/installs/postgres/16.1/bin/pg_config # Fix pg_config
    user@host:~$ bin/setup

Overmind (Procfile manager)

    user@host:~$ asdf install golang latest
    user@host:~$ go install github.com/DarthSim/overmind/v2
    user@host:~$ asdf reshim

Create database for development environment

[postgres] in rake commands is a name of user for postgres. Change if needed

In current tab:

user@host:~$ overmind s -l database

Open a new tab and create development database:

user@host:~$ bundle exec rake 'auction_fun_core:db:create_database[postgres]'
user@host:~$ bundle exec rake 'auction_fun_core:db:migrate'

Now come back to overmind tab, kill the current database process using Ctrl+c. After that:

user@host:~$ overmind start

This will start all required services needed to run core application.

In new tab, you could run seed data for development with

user@host:~$  bundle exec rake 'auction_fun_core:db:seed'

Interactive prompt

To experiment with that code, run bin/console for an interactive prompt.

Test

Configure the .env.test file with the values according to your machine or network.

Run the test suite with the coverage report using the command:

user@host:~$ APP_ENV=test bundle exec rake auction_fun_core:db:create_database[userdb]
user@host:~$ APP_ENV=test bundle exec rake auction_fun_core:db:migrate
user@host:~$ CI=true APP_ENV=test bundle exec rspec .

Documentation

This project uses yadr as a documentation tool. To generate documentation and view it, run

    user@host:~$ bundle exec yard server --reload

Documentation will be available at http://localhost:8808

External resources

• Email templates

License

The gem is available as open source under the terms of the MIT License.