mythic-beasts 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff19b7149b4146959d99412af78e9cc2ffe5b9c7a210faff7ee5fc83dbbcb957
-  data.tar.gz: e200bed772b3a84c4c39ed454ab4f2b957f066d3710d83d0b3fa9e5e77865d51
+  metadata.gz: e734cacf00418c70c1454d64245f1a1dc59d67b97cab096acd53ca2f793f0c53
+  data.tar.gz: 8e0e5cce97bc96c7308f5876e1060a9b872ca16bd66b740a8d54344f0990c79c
 SHA512:
-  metadata.gz: bf9e744f9f587ca9ea65d78a5d86b4cb6b20876770ec559667c94b635fc2d04687c510b5b125f8560560e33df4595142d6a2dae9a7307608e668cf082676303d
-  data.tar.gz: f5d16e71f563a97e9c4b570d7b90e7c48a0f546bc1ab3428b570feff147fed6f69453855e46e2de4682137a311a56b9ffcfd6a968f2edb9eded8ec18f75058ec
+  metadata.gz: b543c6e8697ad0053624bf2da72db6600a36a1b951697b76ddece75484af95d498e6b4c6316e1c9ff1dcba2486fb832f8199f30fa40bb3eeae89907c4fd9c8f8
+  data.tar.gz: 4493ff77b9877d8bc635da3074a13affdfd2f81a37a0e67f42c121434ce1522ce3846bee6331ccc95d370574b9187adcae4f16b96817adf055531246b27978c3

data/CHANGELOG.md

@@ -5,10 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.0] - 2025-01-27
+## [0.1.1] - 2025-11-05
 
 ### Added
 
+- VPS zones listing method (`MythicBeasts.client.vps.zones`) to query available datacenters
+- VPS types listing method (`MythicBeasts.client.vps.types`) to query available VPS plans
+- Optional parameters for VPS creation: `location`, `service`, `description`, `notes`
+- Example scripts in `examples/` directory:
+  - `list_zones_and_types.rb` - List available zones and VPS types
+  - `provision_vps.rb` - Complete VPS provisioning example
+
+### Changed
+
+- Updated README with new VPS methods and examples
+- Improved VPS create documentation with optional parameters
+
+## [0.1.0] - 2025-01-27
+
+### Features
+
 - Initial release by James Inman (@jfi)
 - OAuth2 authentication support with automatic token refresh
 - DNS API v2 client with full CRUD operations

data/README.md

@@ -87,6 +87,14 @@ MythicBeasts.client.dns.dynamic_update('home.example.com')
 ### VPS Management
 
 ```ruby
+# List available zones/datacenters
+zones = MythicBeasts.client.vps.zones
+# => ["london", "cambridge", "amsterdam", "fremont"]
+
+# List available VPS types/plans
+types = MythicBeasts.client.vps.types
+# => ["VPS-1", "VPS-2", "VPS-3", ...]
+
 # List all VPS servers
 servers = MythicBeasts.client.vps.list
 
@@ -97,7 +105,11 @@ server = MythicBeasts.client.vps.get('my-server')
 MythicBeasts.client.vps.create(
   name: 'my-new-server',
   type: 'VPS-2',
-  ssh_key: 'ssh-rsa AAAAB3...'
+  ssh_key: 'ssh-rsa AAAAB3...',
+  location: 'london',  # Optional: specify datacenter
+  service: 'my-service',  # Optional: service/project name
+  description: 'My test server',  # Optional: server description
+  notes: 'Any additional notes'  # Optional: special requests
 )
 
 # Control servers
@@ -131,6 +143,7 @@ end
 ```
 
 Available error classes:
+
 - `MythicBeasts::Error` - Base error class
 - `MythicBeasts::AuthenticationError` - Invalid credentials
 - `MythicBeasts::NotFoundError` - Resource not found
@@ -138,13 +151,48 @@ Available error classes:
 - `MythicBeasts::RateLimitError` - Rate limit exceeded
 - `MythicBeasts::ServerError` - Server-side error
 
+## Examples
+
+See the `examples/` directory for complete working examples:
+
+- `examples/list_zones_and_types.rb` - List available zones and VPS types
+- `examples/provision_vps.rb` - Provision a new VPS server
+
+Run examples with:
+
+```bash
+export MYTHIC_BEASTS_API_KEY=your_key
+export MYTHIC_BEASTS_API_SECRET=your_secret
+ruby examples/list_zones_and_types.rb
+```
+
 ## Development
 
-After checking out the repo:
+After checking out the repo, run the setup script to install dependencies and git hooks:
 
 ```bash
-bundle install
-bundle exec rspec
+bin/setup
+```
+
+This will:
+
+- Install all gem dependencies
+- Set up lefthook git hooks that run before pushing
+
+The pre-push hooks automatically run:
+
+- `bundle exec standardrb` - Ruby code linting
+- `npx markdownlint-cli2 "**/*.md"` - Markdown linting
+- `bundle exec rspec` - Test suite
+- `bundle exec bundler-audit check --update` - Security audit
+
+You can also run these checks manually:
+
+```bash
+bundle exec rspec                           # Run tests
+bundle exec standardrb                      # Run linter
+npx markdownlint-cli2 "**/*.md"             # Run markdown linter
+bundle exec bundler-audit check --update    # Run security audit
 ```
 
 ## Contributing
@@ -154,6 +202,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/tastyb
 ## Author
 
 **James Inman** ([@jfi](https://github.com/jfi))
+
 - Email: james@otaina.co.uk
 - GitHub: https://github.com/tastybamboo
 

data/lib/mythic_beasts/version.rb

@@ -1,3 +1,3 @@
 module MythicBeasts
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/mythic_beasts/vps.rb

@@ -57,5 +57,15 @@ module MythicBeasts
     def console(server_name)
       client.get("/api/vps/#{server_name}/console")
     end
+
+    # List available zones/locations for VPS provisioning
+    def zones
+      client.get("/api/vps/zones")
+    end
+
+    # List available VPS types/plans
+    def types
+      client.get("/api/vps/types")
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mythic-beasts
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - James Inman
@@ -121,6 +121,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: lefthook
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
 description: A Ruby gem for interacting with Mythic Beasts APIs including DNS, VPS
   provisioning, and domain management
 email: