enum_ext 0.5.2 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0845598204589f2b1a706152342e5b53d61ceca9527127ce3c39e642841ca5d9'
-  data.tar.gz: 51bc267895234e6dcbc8bee398c1e94c2095119874fe2cb9f576c98350cfb425
+  metadata.gz: 8d99346b1ae5f9458733025608cad6e8a1ab427091ce44d10a544e880722633c
+  data.tar.gz: 6a1943ddedaa37022bdfe421dbc4c5d063c63149a96aaa0f05cdab35f423de6b
 SHA512:
-  metadata.gz: c7ea61212f6b049b886b876258f89ef03ed13dbb7c8e20d5086e2f861f9e822fdc53b85eba05f0b6409cc83586db87764697f737950b7c62132b1f07e16ebb10
-  data.tar.gz: 2ab467071a248e2a9701dd804a9ff7003e2788c4a41c6f545fe0c0ad3601e7e01cf38dc15dd755880b7bb2db99fb01229d6ed20a35a76a09ba6c485169e46ec2
+  metadata.gz: ce540db8aca9002c6a46a5ae5eb7a45f7a296d4fd183493a8796e3b9dd007ebb04bc0793b1162b82e177de5b59ff06e8e553248a2aa4c725b17d3570d682444f
+  data.tar.gz: 7db85461bd47c03b3169259f699a29e7a1855fd791d53fb4fe84995b812739fe4968b8184665dfd04230b71e2d78152dc8868f78f89452f37d6b20ed00c77ecc

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+# 0.8.0
+* Methods annotations added:
+  * Full descriptions: Class.enum.describe(short=true) / Class.enum.describe_short / Class.enum.describe_long / Class.enum.describe_basic
+  * Per-methods: Class.enum.describe_enum_i, describe_mass_assign_enum, describe_multi_enum_scopes e.t.c.
+* method Class.enum.supersets_raw added, it will return supersets decompositions to basic enum
+* Class.enum.all method now returns basic enum_values + supersets_raw decomposition to basic enums ( previously was a supersets i.e. high level definition )
+
+# 0.7.0 
+* rails 7 syntax support added
+* massive test process refactoring docker with both rails 7 and earlier support
+* simple translate_enum allowed via `ext: [:translate_enum]`
+
+# 0.6.0 (BREAKING CHANGES)
+* fixed issue with non array superset
+* standard helpers are now private, you should use enum_ext / enum , ext: []  approach to the definitions
+* class.superset_statuses moved to enum_obj -> class.statuses.superset_statuses
+* massive ReadMe refactoring
+
+# 0.5.3
+* refactored tests
+* multi_enum_scopes will be chainable with empty params (i.e. will not change the scope)
+* some development dependencies were added
+
 # 0.5.2
 * removed unused require from the upcoming version 
 

data/Dockerfile

@@ -0,0 +1,22 @@
+FROM ruby:3.0.3-bullseye
+
+WORKDIR /app
+#RUN  apt-get update && apt-get -y install lsb-release
+##
+#RUN wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add - && \
+#    sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list' && \
+#    apt-get update && apt-get -y install postgresql postgresql-client-12
+#
+#RUN sh -c 'echo "local   all             all                                     trust" > /etc/postgresql/14/main/pg_hba.conf' && \
+#    service postgresql start && \
+#    psql -U postgres -c 'CREATE DATABASE "niceql-test"'
+
+RUN  gem install bundler
+
+COPY lib/enum_ext/version.rb /app/lib/enum_ext/version.rb
+COPY enum_ext.gemspec /app/
+COPY Gemfile_rails_6 /app/Gemfile
+COPY Gemfile_rails_6.lock /app/Gemfile.lock
+COPY Rakefile /app/
+#
+RUN bundle install

data/Dockerfile_rails_7

@@ -0,0 +1,25 @@
+FROM ruby:3.0.3-bullseye
+
+WORKDIR /app
+#RUN  apt-get update && apt-get -y install lsb-release
+##
+#RUN wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add - && \
+#    sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list' && \
+#    apt-get update && apt-get -y install postgresql postgresql-client-12
+#
+#RUN sh -c 'echo "local   all             all                                     trust" > /etc/postgresql/14/main/pg_hba.conf' && \
+#    service postgresql start && \
+#    psql -U postgres -c 'CREATE DATABASE "niceql-test"'
+
+RUN  gem install bundler
+
+
+RUN  gem install bundler
+
+COPY lib/enum_ext/version.rb /app/lib/enum_ext/version.rb
+COPY enum_ext.gemspec /app/
+COPY Gemfile_rails_7 /app/Gemfile
+COPY Gemfile_rails_7.lock /app/Gemfile.lock
+COPY Rakefile /app/
+
+RUN bundle install

data/{Gemfile → Gemfile_rails_6}

@@ -3,3 +3,4 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in enum_ext.gemspec
 gemspec
 
+gem 'activerecord', "<7"

data/{Gemfile.lock → Gemfile_rails_6.lock}

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    enum_ext (0.4.5)
+    enum_ext (0.8.0)
       activerecord (>= 5.2.4.3)
 
 GEM
@@ -31,6 +31,7 @@ GEM
       minitest (>= 5.1)
       tzinfo (~> 2.0)
       zeitwerk (~> 2.3)
+    amazing_print (1.4.0)
     builder (3.2.4)
     byebug (11.1.3)
     concurrent-ruby (1.1.10)
@@ -44,6 +45,7 @@ GEM
     method_source (1.0.0)
     mini_portile2 (2.8.0)
     minitest (5.14.2)
+    niceql (0.6.1)
     nokogiri (1.13.10)
       mini_portile2 (~> 2.8.0)
       racc (~> 1.4)
@@ -59,6 +61,9 @@ GEM
     rails-i18n (7.0.6)
       i18n (>= 0.7, < 2)
       railties (>= 6.0.0, < 8)
+    rails_sql_prettifier (6.1.5)
+      activerecord (>= 6.1, < 7)
+      niceql (~> 0.6)
     railties (6.1.7)
       actionpack (= 6.1.7)
       activesupport (= 6.1.7)
@@ -77,14 +82,16 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
+  amazing_print
   bundler (>= 1.11)
   byebug
   enum_ext!
   minitest
   rails-i18n (>= 4)
+  rails_sql_prettifier
   rake (>= 10.0)
   sqlite3
   stubberry
 
 BUNDLED WITH
-   2.1.4
+   2.4.17

data/Gemfile_rails_7

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in enum_ext.gemspec
+gemspec
+
+gem 'activerecord', ">=7"

data/Gemfile_rails_7.lock

@@ -0,0 +1,102 @@
+PATH
+  remote: .
+  specs:
+    enum_ext (0.8.0)
+      activerecord (>= 5.2.4.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (7.0.6)
+      actionview (= 7.0.6)
+      activesupport (= 7.0.6)
+      rack (~> 2.0, >= 2.2.4)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actionview (7.0.6)
+      activesupport (= 7.0.6)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activemodel (7.0.6)
+      activesupport (= 7.0.6)
+    activerecord (7.0.6)
+      activemodel (= 7.0.6)
+      activesupport (= 7.0.6)
+    activesupport (7.0.6)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    amazing_print (1.5.0)
+    builder (3.2.4)
+    byebug (11.1.3)
+    concurrent-ruby (1.2.2)
+    crass (1.0.6)
+    erubi (1.12.0)
+    i18n (1.14.1)
+      concurrent-ruby (~> 1.0)
+    loofah (2.21.3)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    method_source (1.0.0)
+    minitest (5.18.1)
+    niceql (0.6.1)
+    nokogiri (1.15.3-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.15.3-x86_64-linux)
+      racc (~> 1.4)
+    racc (1.7.1)
+    rack (2.2.7)
+    rack-test (2.1.0)
+      rack (>= 1.3)
+    rails-dom-testing (2.1.1)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.0)
+      loofah (~> 2.21)
+      nokogiri (~> 1.14)
+    rails-i18n (7.0.7)
+      i18n (>= 0.7, < 2)
+      railties (>= 6.0.0, < 8)
+    rails_sql_prettifier (7.0.4)
+      activerecord (>= 7)
+      niceql (~> 0.6)
+    railties (7.0.6)
+      actionpack (= 7.0.6)
+      activesupport (= 7.0.6)
+      method_source
+      rake (>= 12.2)
+      thor (~> 1.0)
+      zeitwerk (~> 2.5)
+    rake (13.0.6)
+    sqlite3 (1.6.3-x86_64-darwin)
+    sqlite3 (1.6.3-x86_64-linux)
+    stubberry (0.3.0)
+    thor (1.2.2)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    zeitwerk (2.6.8)
+
+PLATFORMS
+  x86_64-darwin-20
+  x86_64-linux
+
+DEPENDENCIES
+  activerecord (>= 7)
+  amazing_print
+  bundler (>= 1.11)
+  byebug
+  enum_ext!
+  minitest
+  rails-i18n (>= 4)
+  rails_sql_prettifier
+  rake (>= 10.0)
+  sqlite3
+  stubberry
+
+BUNDLED WITH
+   2.4.17

data/README.md

@@ -7,7 +7,7 @@ EnumExt extends rails enum with localization/translation and it's helpers, mass-
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'enum_ext', '~> 0.3'
+gem 'enum_ext', '~> 0.7'
 ```
 
 And then execute:
@@ -49,7 +49,41 @@ Or install it yourself as:
      end
 ```
 
- Now let's review some examples of possible enum extensions
+## Inline definitions. Starting 0.5.0!! BREAKING CHANGES!
+
+Starting version 0.4.6, for concise and clearer code base, you can activate most of the extensions during enum definition, using `ext: [...]` notation.
+This is a preferable way now, and old helpers are private starting version 0.6!:
+
+```ruby
+    #Instead of three method calls:    
+    enum kind: {}
+    enum_i :kind # will raise an private method error starting ver 0.6
+    enum_mass_assign :kind # will raise an private method error starting ver 0.6
+
+    #You should go with ext  option instead:
+    enum kinds: {}, ext: [:enum_i, :enum_mass_assign]
+
+    # OR in case of standalone enum definition:
+    enum kinds: {} # somewhere where you can't or don't want reach 
+    enum_ext :kinds, [:enum_i, :enum_mass_assign, enum_supersets: {} ]
+```
+Rem: enum_ext could be called multiple times and merge later definitions, though I can't imagine why would you split it to multiple calls. 
+
+Rem: The only exceptions for the new syntax are full translation/humanization helpers definitions. 
+     Those will not add any clarity to code, and should be used via standalone helpers. 
+     But standard translate_enum without definitions still welcome:
+
+```ruby
+# GOOD: 
+  enum_ext :kinds, [:enum_i, :enum_mass_assign, :translate_enum, enum_supersets: {}]
+
+# BAD (even if correctly defines internationalization): 
+  enum_ext :kinds, [:enum_i, :enum_mass_assign, :translate_enum, enum_supersets: {}] do
+    I18n.t("scope.#{kind}")
+  end
+```
+
+## Humanization and localization
 
 ### Humanization (humanize_enum) 
   
@@ -81,7 +115,7 @@ Or install it yourself as:
 
   ```ruby
       humanize_enum :status do
-       I18n.t("scope.#{status}")
+        I18n.t("scope.#{status}")
       end
   ```
   
@@ -95,7 +129,6 @@ Or install it yourself as:
   ```ruby
     filter :status, as: :select, label: 'Status', collection: Request.t_statuses_options_i
   ```
- 
   
   **Rem:** select options may break when using lambda() or proc with instance method, but will survive with block
   
@@ -113,6 +146,7 @@ Or install it yourself as:
 ### Translate (translate_enum) 
 
 Enum is translated using scope 'active_record.attributes.class_name_underscore.enum_plural', or the given one:
+
 ```ruby
    translate_enum :status, 'active_record.request.enum'
 ```
@@ -124,7 +158,10 @@ Or it can be done with block either with translate or humanize:
    end
 ```
 
+## Enum extended functionality
+
 ### Enum to_i shortcut ( enum_i )
+
 Defines method enum_name_i shortcut for Model.enum_names[elem.enum_name] or enum_name_before_type_cast
 
 **Ex** 
@@ -135,22 +172,30 @@ Defines method enum_name_i shortcut for Model.enum_names[elem.enum_name] or enum
   request.paid_i # 10
 ```
 
-### Enum Sets (ext_enum_sets)
+### Enum SuperSets (enum_supersets)
  
- **Use-case** whenever you need superset of enums to behave like a enum.
+ **Use-case** whenever you need superset of enums to behave like a super enum.
  
- You can do this with method **ext_enum_sets** it creates: 
+ You can do this with method **enum_supersets** it creates: 
    - scopes for subsets, 
    - instance methods with `?` 
-   - and some class methods helpers
    
    For instance:
 
 ```ruby
-    ext_enum_sets :status, {
-        delivery_set: [:ready_for_shipment, :on_delivery, :delivered], # for shipping department for example
-        in_warehouse: [:ready_for_shipment]  
-    }
+     enum status: [:in_cart, :waiting_for_payment, :paid, :packing, :ready_for_shipment, :on_delivery, :delivered],
+          ext: [enum_supersets: {
+                  delivery_set: [:ready_for_shipment, :on_delivery], # for shipping department for example
+                  in_warehouse: [:packing, :ready_for_shipment],    # this scope is just for superposition example below
+                  sold: [:paid, :delivery_set, :in_warehouse, :delivered] # also you can define any superposition of already defined supersets or enum values
+                }]
+
+     # supersets will be stored inside enum wrapper object, and can be de-referenced to basic enum values 
+     # using wrapper defined methods: "superset_enum_plural", i.e. statuses.sold_statuses -> [:paid, :packing, :ready_for_shipment, :on_delivery, :delivered]
+     # so new supersets could be defined using Array operations against newly defined methods
+     enum_ext :status, enum_supersets: {
+                    outside_warehouse: ( statuses.delivery_set_statuses - statuses.in_warehouse_statuses ) #... any other array operations like &, + and so can be used
+                  }
 ```
 
 it will generate:
@@ -162,13 +207,17 @@ instance:
 class:
     - named scopes: delivery_set, in_warehouse
     - parametrized scopes: with_statuses, without_statuses ( available as a standalone extension now, and will not be included by default in a versionafter 0.5.0)
-    class helpers:
-        - delivery_set_statuses (=[:ready_for_shipment, :on_delivery, :delivered] ), in_warehouse_statuses
-        - delivery_set_statuses_i (= [3,4,5]), in_warehouse_statuses_i (=[3])
 
-     class translation helpers ( started with t_... ):
-        - t_delivery_set_statuses_options (= [['translation or humanization', :ready_for_shipment] ...] ) for select inputs purposes
-        - t_delivery_set_statuses_options_i (= [['translation or humanization', 3] ...]) same as above but with integer as value ( for example to use in Active admin filters )
+enum methods:    
+    - Class.statuses.supersets -- will output superset definition hash
+    - Class.statuses.supersets_raw -- will output superset decompositions to basic enum types hash 
+    
+    - Class.statuses.delivery_superset (=[:ready_for_shipment, :on_delivery, :delivered] ), in_warehouse_statuses
+    - delivery_set_statuses_i (= [3,4,5]), in_warehouse_statuses_i (=[3])
+
+    translation helpers ( started with t_... ):
+    - Class.statuses.t_delivery_set_options (= [['translation or humanization', :ready_for_shipment] ...] ) for select inputs purposes
+    - Class.statuses.t_delivery_set_options_i (= [['translation or humanization', 3] ...]) same as above but with integer as value ( for example to use in Active admin filters )
 ```
 
  ```ruby
@@ -181,10 +230,10 @@ class:
     Request.delivery_set_statuses            # >> ["ready_for_shipment", "on_delivery", "delivered"]
 ```
 Rem:
-ext_enum_sets can be called multiple times defining a superposition of already defined sets ( considering previous example ):
+supersets creation could be called multiple times defining a superposition of already defined sets ( considering previous example ):
 
 ```ruby
- ext_enum_sets :status, {
+ enum_ext :status, enum_supersets: {
    outside_wharehouse: ( delivery_set_statuses - in_warehouse_statuses )#... any other array operations like &, + and so can be used
  }
 ```
@@ -192,7 +241,7 @@ ext_enum_sets can be called multiple times defining a superposition of already d
 Rem: you can refer previously defined set as usual kind in the same method call:
     
 ```ruby
-    ext_enum_sets :status, {
+    enum_ext :status, enum_supersets: {
         delivery_set: [:ready_for_shipment, :on_delivery, :delivered],
         not_in_cart: [:paid, :delivery_set] #
     }
@@ -243,11 +292,43 @@ Rem: you can refer previously defined set as usual kind in the same method call:
     order.requests.delivered.count              # >> N + M
 ```
 
+## Annotations helpers
+Sometimes under irb console you need a quick tip on whats extension available on a enum, so some describe_* helpers added to enum wrapper
+
+General description methods (describe/describe_short/describe_long)
+```
+  Class.enum.describe
+```  
+![img.png](img.png)
+
+```
+  Class.enum.describe_short
+```
+![img_1.png](img_1.png)
+
+```
+  Class.enum.describe_long
+```
+![img_2.png](img_2.png)
+
+And per extension methods (describe_enum_i, e.t.c)
+
+```ruby
+ EnumAnnotated.test_types.describe_mass_assign_enum
+```
+![img_3.png](img_3.png)
+
 ## Tests
-   rake test
- 
+Starting version 0.6 added support for rails 7+ enum definitions, that's making testing a little bit not that easy as running `rake test`.
+Now testings are done via `docker-compose up`. Look closer to Dockerfiles and `docker-compose.yml` 
+to get the idea how they working simultaneously without interference with each other. 
+
+
 ## Development
 
+## TODO
+[] better support for suffix/prefix as enum does
+[] describe method to observe current extension 
 
 ## Contributing
 
@@ -258,6 +339,6 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/alekse
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
-### Thanks
 
-Thanks for the star vzamanillo, it inspires me to do mass refactor and gracefully cover code in this gem by tests.
+### Thanks
+Thanks for the first star to vzamanillo, it inspires me to do mass refactor and gracefully cover code in this gem by tests.

data/docker-compose.yml

@@ -0,0 +1,24 @@
+version: "3.7"
+
+services:
+  test:
+    build: .
+    image: enum_ext
+    command: rake test
+    volumes:
+      - './lib:/app/lib'
+      - './test:/app/test'
+      - './Gemfile_rails_6:/app/Gemfile'
+      - './Gemfile_rails_6.lock:/app/Gemfile.lock'
+
+  test_7_0:
+    build:
+      context: .
+      dockerfile: Dockerfile_rails_7
+    image: enum_ext_rails_7
+    command: rake test
+    volumes:
+      - './lib:/app/lib'
+      - './test:/app/test'
+      - './Gemfile_rails_7:/app/Gemfile'
+      - './Gemfile_rails_7.lock:/app/Gemfile.lock'

data/enum_ext.gemspec

@@ -28,4 +28,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'sqlite3'
   spec.add_development_dependency 'byebug'
   spec.add_development_dependency 'stubberry'
+  spec.add_development_dependency 'rails_sql_prettifier'
+  spec.add_development_dependency 'amazing_print'
 end