cool_id 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5284982eed15e82c55f1e8a1c853c83feb97d76d7e04fb247b74e6edcbfdcf0e
-  data.tar.gz: 21f44586d37a4a27474dcc984179cc6b8e927ae43da371e5d80874c82a314d43
+  metadata.gz: 0d44c3207248595af232a200cf0e809224d74033d97d3cac52c6d06d5416b682
+  data.tar.gz: d221baeb8e79ea8ea8ca2b9503685e4bfa7cb8d57b53a3ba0e4d301138a08300
 SHA512:
-  metadata.gz: 9f8a012d217a3435e87f9df231fce5e850e92cc7ded853fff79cca4f721058f0175912aab2a25c8671defb208453e137884c59a9ec8041a8d1d2aad2f032cb74
-  data.tar.gz: ad7af3d92a6f4b5a067fe535020d9cdd44d53ddd6584ba89555a74bcc83a4cc6a959f7e4cfb857c1961d85dbfe55bd5d0395afe1aed65680d2ae3dab34ab5688
+  metadata.gz: 9ed700560671d811b0678c4fbe8f9e086c3ca0c9e8d04a54b7d40d586b20864e2add65adb9e5e53feb7915e472974dbfa6b31313dd6a64f4008aaf3f31503f70
+  data.tar.gz: df1cdc3098d9b4761a220fedeca362eeaeb5677d92ca7da594dc946223d814c81bb59db757ff08292fe72e3ce499dd95e1cc002ccf27c436aa097617bd14f2a9

data/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) Peter Schilling
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -1,6 +1,6 @@
 # cool_id
 
-a gem for rails that generates string ids for active record models with a per-model prefix followed by a nanoid.
+a gem for rails that generates string primary key ids for active record models with a per-model prefix followed by a nanoid. this lets you create stripe style ids in your own rails app, and they'll be the same ids you see in your database.
 
 ```ruby
 class User < ActiveRecord::Base
@@ -10,26 +10,18 @@ end
 
 User.create!(name: "...").id
 # => "usr_vktd1b5v84lr"
-
-class Customer < ActiveRecord::Base
-  include CoolId::Model
-  cool_id prefix: "cus", alphabet: "ABCDEFGHIJKLMNOPQRSTUVWXYZ", length: 8
-end
-
-Customer.create!(name: "...").id
-# => "cus_UHNYBINU"
 ```
 
-it can also lookup records by ids, similar to global id:
+it can also lookup records similar to global id:
 
 ```ruby
-user = User.create!(name: "John Doe")
-# => #<User id: "usr_vktd1b5v84lr", name: "John Doe">
-
 CoolId.locate("usr_vktd1b5v84lr")
 # => #<User id: "usr_vktd1b5v84lr", name: "John Doe">
+```
 
-# You can also parse the id without fetching the record
+and parse ids
+
+```ruby
 parsed = CoolId.parse("usr_vktd1b5v84lr")
 # => #<struct CoolId::Id key="vktd1b5v84lr", prefix="usr", id="usr_vktd1b5v84lr", model_class=User>
 
@@ -37,8 +29,41 @@ parsed.model_class
 # => User
 ```
 
+and generate ids without creating a record
+
+```ruby
+# generate an id, e.g. for batch inserts or upserts
+User.generate_cool_id
+# => "usr_vktd1b5v84lr"
+
+```
+
+it takes parameters to change the alphabet or length
+
+```ruby
+class Customer < ActiveRecord::Base
+  include CoolId::Model
+  cool_id prefix: "cus", alphabet: "ABCDEFGHIJKLMNOPQRSTUVWXYZ", length: 8
+end
+
+Customer.create!(name: "...").id
+# => "cus_UHNYBINU"
+```
+
+and these can be configured globally
+
+```ruby
+CoolId.configure do |config|
+  config.separator = "-"
+  config.alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+  config.length = 8
+end
+```
+
 ## installation
 
+add cool_id to your Gemfile:
+
 ```bash
 bundle add cool_id
 ```
@@ -47,7 +72,7 @@ bundle add cool_id
 gem "cool_id"
 ```
 
-### per-model
+### using cool_id in one model
 
 use string ids when creating a table
 
@@ -66,9 +91,9 @@ class User < ActiveRecord::Base
 end
 ```
 
-### all models
+### using cool_id on all models
 
-use string ids on all new generated migrations
+you have drank the coolaid. setup rails to use string ids on all new generated migrations
 
 ```ruby
 # config/initializers/generators.rb
@@ -77,7 +102,7 @@ Rails.application.config.generators do |g|
 end
 ```
 
-setup `ApplicationRecord` to include cool id and ensure it's setup in classes that inherit from it
+then setup `ApplicationRecord` to include cool id and ensure it's setup in classes that inherit from it
 
 ```ruby
 # app/models/application_record.rb
@@ -87,3 +112,21 @@ class ApplicationRecord < ActiveRecord::Base
   enforce_cool_id_for_descendants
 end
 ```
+
+### graphql
+
+if you use the graphql ruby node interface, you can implement [object identification](https://graphql-ruby.org/schema/object_identification)
+
+
+```ruby
+# app/graphql/app_schema.rb
+class AppSchema < GraphQL::Schema
+  def self.id_from_object(object, type_definition, query_ctx)
+    object.id
+  end
+
+  def self.object_from_id(id, query_ctx)
+    CoolId.locate(id)
+  end
+end
+```

data/lib/cool_id/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CoolId
-  VERSION = "0.1.5"
+  VERSION = "0.1.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cool_id
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - Peter Schilling
@@ -76,13 +76,15 @@ files:
 - ".rspec"
 - ".standard.yml"
 - CHANGELOG.md
+- LICENSE
 - README.md
 - Rakefile
 - lib/cool_id.rb
 - lib/cool_id/version.rb
 - sig/cool_id.rbs
 homepage: https://github.com/schpet/cool_id
-licenses: []
+licenses:
+- ISC
 metadata:
   homepage_uri: https://github.com/schpet/cool_id
   source_code_uri: https://github.com/schpet/cool_id