enquo-core 0.6.0-aarch64-linux → 0.6.0.4.gd752e84-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dae7f8d1d26aeda51167f0d5b3139a4280a2d36b2d4246d8fe0233d66216741d
-  data.tar.gz: de3babdd59b817fedbc2c91c00b1791ab6afeb0166ac0dd19ef3bae09abb7115
+  metadata.gz: b11bd7db1deaee73dc3076d65b3e31cdff900fdf4e90d5436649679a1b7e0bfa
+  data.tar.gz: a5d0dfb05a4912651d52519cf3d8b46ebc092ebc76b50f97fda550ed2d8dab68
 SHA512:
-  metadata.gz: ec6730c6776cd7bc1f0a8a751df90efe782cf732105d4ef0e2d28568d3f1ead62cd9e07b8b34da426fd6bc74955d07ea61b6a83673ccd5e335fea869057fe18f
-  data.tar.gz: 93fd8401e5489b590b405bf049ead5e31f87716b92d23a56b1bc823c2841a591cc9d2d45fad3079329dff73f2cfcb18c05bb0bb3380b6e43b09c41f6e4824d7a
+  metadata.gz: 7490e40ada36ec79237143f6b54b9bd4a397339f0a1480a5157be96fb575acacb475084de00e4e8df5b310bab445a8fbd5528ec36e24be26bcdefc2b93c6b3dd
+  data.tar.gz: 8dc913d7b67508c5ba1492533dcfc3bb2a20e1ca8418e5e7b10727c5842d702fbac328303e289e90baa4c9e19d1cbbe8635478c6ea4679ce900a6284aa785609

data/README.md

@@ -0,0 +1,55 @@
+This directory contains the Ruby bindings for the [Enquo](https://enquo.org) core cryptography library.
+
+## Note Well
+
+When reading these docs, bear in mind that this is a *low level* cryptographic library.
+It is not intended that most users will use `enquo-core` directly.
+Instead, typically you will use Enquo via your preferred ORM or other higher-level integration.
+This library is intended to be used to build *those* integrations, not to be used in applications directly.
+
+
+# Installation
+
+Typically you'll want to install [the rubygem]:
+
+```bash
+gem install enquo-core
+```
+
+If you use a platform for which pre-built binary packages are available, this will Just Work.
+Otherwise, you'll need a [Rust toolchain](https://www.rust-lang.org/learn/get-started) to build.
+
+
+# Usage
+
+The Enquo core is all about encrypting and decrypting *field data*, using keys derived from a *root*.
+
+Load the library:
+
+```ruby
+require "enquo-core"
+```
+
+Create the root key, from which all other cryptographic keys are derived:
+
+```ruby
+root_key = Enquo::RootKey::Static.new(SecureRandom.bytes(32))
+```
+
+(In real-world use, you'll want to take that key from somewhere it can be securely stored)
+
+Now, you can create the root itself:
+
+```ruby
+root = Enquo::Root.new(root_key)
+```
+
+Finally, you can now create a "field" object, which is what is used to do encryption and decryption:
+
+```ruby
+f = root.field("some_relation", "some_field_name")
+ciphertext = f.encrypt_text("this is some text", "test")
+puts f.decrypt_text(ciphertext, "test").inspect  # Should print "this is some text"
+```
+
+For more details on the full API, consult [the fine manual](https://www.rubydoc.info/gems/enquo-core).

data/lib/enquo/root_key/static.rb

@@ -2,23 +2,23 @@ module Enquo
 	module RootKey
 		class Static
 			def self.new(k)
-            unless k.is_a?(String)
-               raise ArgumentError, "An Enquo static root key must be passed a string"
-            end
+				unless k.is_a?(String)
+					raise ArgumentError, "An Enquo static root key must be passed a string"
+				end
 
-            key = if k.encoding == Encoding::BINARY
-               unless k.bytesize == 32
-                  raise ArgumentError, "An Enquo static root key must be a 32 byte binary string"
-               end
+				key = if k.encoding == Encoding::BINARY
+					unless k.bytesize == 32
+						raise ArgumentError, "An Enquo static root key must be a 32 byte binary string"
+					end
 
-               k
-            else
-               unless k =~ /\A\h{64}\z/
-                  raise ArgumentError, "An Enquo static root key must be a 64 byte hex string"
-               end
+					k
+				else
+					unless k =~ /\A\h{64}\z/
+						raise ArgumentError, "An Enquo static root key must be a 64 byte hex string"
+					end
 
-               [k].pack("H*")
-            end
+					[k].pack("H*")
+				end
 
 				_new(key)
 			end

data/lib/enquo-core.rb

@@ -0,0 +1 @@
+require_relative "./enquo.rb"

data/lib/enquo_core.rb

@@ -0,0 +1 @@
+require_relative "./enquo.rb"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: enquo-core
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.0.4.gd752e84
 platform: aarch64-linux
 authors:
 - Matt Palmer
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-08 00:00:00.000000000 Z
+date: 2023-01-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -150,7 +150,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
+description: 
 email:
 - matt@enquo.org
 executables: []
@@ -158,6 +158,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- README.md
 - enquo-core.gemspec
 - ext/enquo/.gitignore
 - ext/enquo/Cargo.lock
@@ -167,11 +168,13 @@ files:
 - lib/2.7/enquo.so
 - lib/3.0/enquo.so
 - lib/3.1/enquo.so
+- lib/enquo-core.rb
 - lib/enquo.rb
 - lib/enquo/field.rb
 - lib/enquo/root.rb
 - lib/enquo/root_key.rb
 - lib/enquo/root_key/static.rb
+- lib/enquo_core.rb
 homepage: https://enquo.org/active_enquo
 licenses: []
 metadata:
@@ -179,7 +182,7 @@ metadata:
   source_code_uri: https://github.com/enquo/enquo-core
   changelog_uri: https://github.com/enquo/enquo-core/releases
   bug_tracker_uri: https://github.com/enquo/enquo-core/issues
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -193,12 +196,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 3.2.dev
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.3.22
-signing_key:
+rubygems_version: 3.4.3
+signing_key: 
 specification_version: 4
 summary: Core library for encrypted querying operations
 test_files: []