geewiz 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 014b8d7b3b4e8e467174f86e1784dbba0b1d83affbe0b19fa3c9cc6368c6573b
-  data.tar.gz: 0d503a8c1e3c3a0d3810728c9fb1d9d18e03530f6c39563e3b9e4548dd19aedc
+  metadata.gz: 470c2e0206995689b82812d1d2a357e9baf0f818ec89cc27153c597c6e6231cf
+  data.tar.gz: 392f167bcfa145c10c67a2c70789041b8dec625283b25f6606a6e3b305326479
 SHA512:
-  metadata.gz: c98200cb66fc440a00d1af44c539719b54f72ca3d8a4c96283bb566d93f617588cef237b9ad80001b8e4280cc0a1abbc2cc64e63bd5b39c0b72bfd5122f6962c
-  data.tar.gz: 905180bc3a49a60aa8b104e267432ec71bb0eebd8fe847463a9af30219b69783c450364f211b51e74934e8cd7c0f14e2b6eb4fcde885faafdad7bfc03e0e7cda
+  metadata.gz: d52dc1c3183b15bfb9bd1564f3ac7f8b1abeada4d5b5de47fb54a8226a21f48bd171a73803a5a0adad5e8ce681fb61822f331b2035826c21af95081434cc7e0e
+  data.tar.gz: 210d522fdb5488dbabfb77cd8896fa09a98851518cdcc193e786550c7cc7a0432d4aea5cfb2c8465a878b3b48d590083a0bb48bc16b3bd012f6d25260eaa5a74

data/README.md

@@ -1,32 +1,136 @@
 # Geewiz
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/geewiz`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+SDK for interacting with Geewiz. Works with Ruby 2.6 (the version that currently come preinstalled on MacOS) and above.
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+### For use with MacOS's system Ruby 2.6.0 using `bundler`
+
+To start a new project using MacOS's preinstalled Ruby:
+
+Make a new directory for your project
+
+```bash
+mkdir my-new-project
+cd my-new-project
+```
+
+Configure Bundler to use the `vendor/bundle` directory for your gems instead of installing them system wide, which requires root access:
+
+```bash
+bundle config --local path vendor/bundle
+
+# Ignore the bundled gems in git
+echo /vendor/ >> .gitignore
+```
+
+Create a new Gemfile
 
-    $ bundle add geewiz
+```bash
+# Make a new Gemfile
+bundle init
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+# Add the gem to the Gemfile
+bundle add geewiz
+```
+
+To use the gem in your project:
+
+```ruby
+require 'bundler/setup'
+require 'geewiz'
+
+Geewiz.card "hello-world-card"
+```
+
+### For most other cases:
+
+```bash
+bundle add geewiz
+```
+
+or
+
+```bash
+gem install geewiz
+```
 
-    $ gem install geewiz
 
 ## Usage
 
-TODO: Write usage instructions here
+### Requiring the gem
+
+```ruby
+require 'bundler/setup' # you may need to require this if you're using bundler
+
+require 'geewiz'
+```
+
+### Showing a card
+
+```ruby
+# show a card with the id "my_card_id"
+result = Geewiz.card :my_card_id
+result = Geewiz.card "another-card-id" # all data going to Geewiz is json encoded, so either symbols or strings are fine
+
+# show a card with the id "my_card_id" override `type` and `selectOne` parameters
+result = Geewiz.card :my_card_id, type: "selectOne", items: ["one", "two", "three"]
+
+# show a card with no id
+result = Geewiz.card type: "selectOne", items: ["one", "two", "three"]
+
+# `vars:` can be used to send variables to Geewiz before showing a card
+#    (it's a bit cleaner than using `Geewiz.vars[]=` directly)
+result = Geewiz.card :my_card, vars: { my_var: "my value", another_var: "another value" }
+
+# if card doesn't have an input, or you don't need the input:
+Geewiz.card :my_card_without_input
+```
+
+### Setting a variable
+
+```ruby
+Geewiz.vars[:my_var] = "my value"
+Geewiz.vars['my-var-with-dashes'] = "my value" # strings are fine as variable names
+
+# you can use the variables in Ruby
+Geewiz.vars[:username] = load_username_from_db
+
+if Geewiz.vars[:username] == 'nicholaides'
+  # ...
+end
+
+# this also works for setting one variable
+Geewiz.var :my_var, "my value"
+```
+
+### Setting the title of the app
+
+```ruby
+Geewiz.set title: "my app"
+```
+
+### Getting user config
+
+```ruby
+config_value = Geewiz.get_user_config :my_key
+```
 
-## Development
+### Using the global client (simplest way to use the gem)
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```ruby
+Geewiz.card :my_card_id
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+### Using a non-global client (better for testing/mocking)
 
-## Contributing
+```ruby
+geewiz = Geewiz::Client.new
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/geewiz.
+geewiz.set title: "my app"
+geewiz.vars[:my_var] = "my value"
+result = geewiz.card :my_card_id
+```
 
 ## License
 

data/lib/geewiz/client.rb

@@ -27,6 +27,10 @@ module Geewiz
     end
 
     def card(id = nil, vars: {}, **params)
+      if params[:responseFormat] && params[:responseFormat].to_s != "json"
+        raise Error, "responseFormat cannot be set to anything other than json"
+      end
+
       vars.each { |name, value| var(name, value) }
       command "card", **params, **(id ? { id: id } : {}), responseFormat: "json"
       read_response

data/lib/geewiz/version.rb

@@ -1,3 +1,3 @@
 module Geewiz
-  VERSION = "0.1.2".freeze
+  VERSION = "0.1.3".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: geewiz
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Mike Nicholaides
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-11 00:00:00.000000000 Z
+date: 2024-08-19 00:00:00.000000000 Z
 dependencies: []
 description: Geewiz SDK for Ruby
 email:
@@ -17,9 +17,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- LICENSE.txt
 - README.md
-- geewiz.gemspec
 - lib/geewiz.rb
 - lib/geewiz/client.rb
 - lib/geewiz/var_cache.rb

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2024 Mike Nicholaides
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

data/geewiz.gemspec

@@ -1,38 +0,0 @@
-require_relative "lib/geewiz/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "geewiz"
-  spec.version = Geewiz::VERSION
-  spec.authors = ["Mike Nicholaides"]
-  spec.email = ["mike@nicholaides.com"]
-
-  spec.summary = "Geewiz SDK for Ruby"
-  spec.description = "Geewiz SDK for Ruby"
-  # spec.homepage = "TODO: Put your gem's website or public repo URL here."
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["rubygems_mfa_required"] = "true"
-
-  # spec.metadata["homepage_uri"] = spec.homepage
-  # spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
-  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end - %w[.rspec .rubocop.yml .rubocop_todo.yml Gemfile Gemfile.lock Rakefile .tool-versions]
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end