ru.Bee 3.0.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a38b359191859d1d0d22a355a81a3b86c760c5ab3ba33f1ac13059f14c6b69b
-  data.tar.gz: f0c8763134b4ad81e0db61b9926bb0f8e292ad4c0e328cbd1ae2960cf9155f3d
+  metadata.gz: b28e888cbb426de4174be8a59d2692b00fc3377992c9f5ec60c88f7192f92242
+  data.tar.gz: 35bef19fdb83b5fad826831fa6b70b79b93636673c09730e3eed5c2ec1cc982a
 SHA512:
-  metadata.gz: e69bfd2ff4cae80bf4a2821feeb396f23da0dbdf3fd74f9405dd4e89feb0d2ba938d138372d140a921322916d70097766efd65a6cdf654ca6a469dcde29b1263
-  data.tar.gz: 2f2cbf3d544b9c89322e2f79d7a10bd53d3aadb5d592dbc890f482a87efd021b1276c77ab7e2828a342443637cd21bfa9ea25db79778a46993284a4e8df8144e
+  metadata.gz: 68d08ae55a2058593c4d465bce2eb3d112bbfdc1f9772e8116e50ba0b0da062dc37cca9dd173fb35f479b7d9a18a39213492abdd83d050702d32463cef1a2e42
+  data.tar.gz: 11e6221754f7f854833a4eeebea16e0970a5ff5cddd1cda02b8208e10f4f3f686c7ffd549eaeaa22a357a714b5e465a514f7e2afffb58f7943f9727bb9563e67

data/lib/rubee/autoload.rb

@@ -3,6 +3,8 @@ module Rubee
     BLACKLIST = ['rubee.rb', 'test_helper.rb', 'puma.rb']
     class << self
       def call(black_list = [], **options)
+        load_envs!
+
         load_whitelisted(options[:white_list_dirs]) && return if options[:white_list_dirs]
         # Autoload all rbs
         root_directory = File.join(Rubee::ROOT_PATH, '/lib')
@@ -60,7 +62,7 @@ module Rubee
         end
       end
 
-      def load_envs!(prefix = ENV['RACK_ENV'], root_directory)
+      def load_envs!(prefix = ENV['RACK_ENV'], root_directory = File.join(Rubee::APP_ROOT, Rubee::LIB))
         env_file_name = "#{root_directory}/.#{prefix}.env"
         File.foreach(env_file_name) do |line|
           line = line.strip
@@ -86,7 +88,6 @@ module Rubee
         end
         load_support(root_directory, black_list)
 
-        load_envs!(ENV['RACK_ENV'], root_directory)
         # app config and routes
         unless black_list.include?('base_configuration.rb')
           require_relative File.join(Rubee::APP_ROOT, Rubee::LIB, 'config/base_configuration')

data/lib/rubee.rb

@@ -20,7 +20,7 @@ module Rubee
     RUBEE_SUPPORT = { "Rubee::Support::Hash" => Hash, "Rubee::Support::String" => String }
   end
 
-  VERSION = '3.0.0'
+  VERSION = '3.0.1'
 
   require_relative 'rubee/router'
   require_relative 'rubee/logger'

data/readme.md

@@ -25,7 +25,7 @@ Starting from ru.Bee 2.0.0, ru.Bee supports WebSocket, which allows you to build
 
 ## Production ready
 
-Take a look at the ru.Bee demo site with full documentation: https://rubee.dedyn.io/
+Take a look at the ru.Bee demo site with full documentation: https://rubee.dedyn.io/ (site is currently under maintenance)
 Want to explore how it was built? https://github.com/nucleom42/rubee-site
 
 ## Stress tested
@@ -83,12 +83,15 @@ The comparison is based on generic and subjective information available on the i
 - [Object hooks](#object-hooks)
 - [Validations](#validations)
 - [JWT based authentication](#jwt-based-authentication)
+- [Authorizable](#authorizable)
 - [OAuth authentication](#oauth-authentication)
 - [ru.Bee commands](#rubee-commands)
 - [Generate commands](#generate-commands)
 - [Migration commands](#migration-commands)
 - [ru.Bee console](#rubee-console)
 - [Rubee::Support](#rubee-support)
+- [Time Extensions](#time-extensions)
+- [Environment Configuration](#environment-configuration)
 - [Testing](#testing)
 - [Background jobs](#background-jobs)
 - [Sidekiq engine](#sidekiq-engine)
@@ -97,7 +100,7 @@ The comparison is based on generic and subjective information available on the i
 - [Logger](#logger)
 - [WebSocket](#websocket)
 - [Bee assistant](#bee-assistant)
-- [Middleware integration](#middleware-integration)
+- [Middleware integration](#middleware-integration))
 
 
 You can read the full docs on the demo site: [rubee.dedyn.io](https://rubee.dedyn.io/)
@@ -126,6 +129,12 @@ ORM-agnostic – Models are native ORM objects, but you can use them as blueprin
 <br>
 Authenticatable – Easily add JWT authentication to any controller action.
 <br>
+Authorizable – Declarative role-based authorization for controller actions. (New in 3.0.0)
+<br>
+Time Extensions – Comprehensive helper methods for date and time manipulation. (New in 3.0.0)
+<br>
+Environment Configuration – Load environment variables from .env files per environment. (New in 3.0.0)
+<br>
 Hooks – Add logic before, after, or around any controller action.
 <br>
 Testable – Run all or selected tests using fast, beloved Minitest.
@@ -1088,6 +1097,58 @@ Rubee::Configuration.development?
 
 [Back to content](#content)
 
+## Time Extensions
+
+The Time class includes a comprehensive set of helper methods for common date and time manipulations. (New in 3.0.0)
+
+### Instance Methods
+
+| Method | Description | Example |
+| :--- | :--- | :--- |
+| `days_seconds` | Returns the total number of seconds elapsed since midnight. | `Time.now.days_seconds` |
+| `beginning_of_day` | Returns a new `Time` object set to the start of the day (00:00:00). | `Time.now.beginning_of_day` |
+| `end_of_day` | Returns a new `Time` object set to the end of the day (23:59:59). | `Time.now.end_of_day` |
+| `at(hour, min, sec)` | Returns a new `Time` object for the same date but with the specified time. | `Time.now.at(10, 30, 0)` |
+| `all_day` | Returns a `Range` from the beginning to the end of the day. | `Time.now.all_day` |
+| `add_days(n)` | Returns a new `Time` object `n` days in the future. | `Time.now.add_days(5)` |
+| `subtract_days(n)` | Returns a new `Time` object `n` days in the past. | `Time.now.subtract_days(5)` |
+| `closest_future_working_day` | Returns the next working day (Monday–Friday). | `Time.now.closest_future_working_day` |
+| `with_current_time` | Returns a new `Time` object with the same date but the current time of day. | `Time.now.with_current_time` |
+
+### Class Methods
+
+| Method | Description |
+| :--- | :--- |
+| `Time.today` | Returns the current `Time` object for today. |
+| `Time.tomorrow` | Returns a `Time` object for tomorrow. |
+| `Time.yesterday` | Returns a `Time` object for yesterday. |
+| `Time.beginning_of_today` | Returns a `Time` object for the start of today (00:00:00). |
+| `Time.end_of_today` | Returns a `Time` object for the end of today (23:59:59). |
+| `Time.start_of_today` | Alias for `Time.beginning_of_today`. |
+
+[Back to content](#content)
+
+## Environment Configuration
+
+Starting from version 3.0.0, ru.Bee supports loading environment-specific variables from `.env` files, providing a more secure and organized way to manage configuration.
+
+The system automatically loads files based on the `RACK_ENV` environment variable:
+- `.development.env` - loaded when `RACK_ENV=development`
+- `.test.env` - loaded when `RACK_ENV=test`
+- `.production.env` - loaded when `RACK_ENV=production`
+
+### Example `.env` file
+
+```bash
+# .development.env
+DATABASE_URL=postgres://localhost:5432/myapp_development
+SECRET_KEY_BASE=your_secret_key_here
+API_KEY=abc123
+```
+Place your .env files in the root of your project. The variables will be automatically loaded when the application starts and will be available via ENV
+
+[Back to content](#content)
+
 ## JWT based authentication
 
 Include the `AuthTokenable` module in your controller and authenticate any action you need.
@@ -1146,6 +1207,41 @@ end
 
 [Back to content](#content)
 
+## Authorizable
+
+Starting from version 3.0.0, ru.Bee includes a declarative authorization system for controller actions. The `Authorizable` module is now part of `Rubee::BaseController` and allows you to restrict access based on user roles.
+
+### Basic Usage
+
+```ruby
+class AdminController < Rubee::BaseController
+  authorize(admin: [:dashboard, :manage_users], model: :user, role_field: :role)
+
+  def dashboard
+    response_with object: { message: "Admin dashboard" }, type: :json
+  end
+
+  def manage_users
+    response_with object: User.all, type: :json
+  end
+end
+```
+Parameters
+
+role - The role required to access the actions (e.g., :admin, :user)
+model - The model class to check roles against (default: :user)
+role_field - The field in the model that stores the role (default: :role)
+response_hash - Custom response hash for unauthorized access (optional)
+
+```ruby
+class AdminController < Rubee::BaseController
+  authorize(admin: [:dashboard], 
+          model: :user, 
+          response_hash: { object: { error: "Access denied" }, status: 403 })
+```
+
+[Back to content](#content)
+
 ## OAuth authentication
 
 To plug in OAuth 2.0 authentication, add the `oauth2` gem to your Gemfile:

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ru.Bee
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.1
 platform: ruby
 authors:
 - Oleg Saltykov