brightbox-cli 2.3.4 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. checksums.yaml +4 -4
  2. data/.travis.yml +2 -0
  3. data/CHANGELOG.md +11 -0
  4. data/Gemfile.lock +5 -5
  5. data/README.rdoc +170 -0
  6. data/brightbox-cli.gemspec +1 -1
  7. data/lib/brightbox-cli/version.rb +1 -1
  8. metadata +65 -65
  9. data/README.rdoc +0 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 9cf0beb67f410d3e6ea79a9e185061bcb55459e8
4
- data.tar.gz: a36384bb42af2559dbe1abc52d42d8467e67a4e5
3
+ metadata.gz: 19a5a3b2411db9bbb8a93da680fcaa462d0b6676
4
+ data.tar.gz: 71069abea72fc45d2f70b9332e4a0452dee57cc6
5
5
  SHA512:
6
- metadata.gz: 85a949a8c34514f1cec2ab33bfde714837f6df01545272479697f851b96b6ca21e1bb05ba706ea99c2b7196c049586d32ea67e26bec7db60c783d75e2503ce91
7
- data.tar.gz: eaa699fc2ca894d4925dc2559e7c2259cda25ea042b1cd7c43ca8279c1462bb5eb1e12ee2a913eee43d90c890b96a0195fb54ae03bb8066fdb9e50e54c7c2d4f
6
+ metadata.gz: 30fb4fcb513d901a2c5597208223bc5a19790fef47f506622e005d5c600e1b3f6359f5f97c63029f9b981f0014e4f90008c9665c6692679bd3d48bd3bf08a8d8
7
+ data.tar.gz: b1a024f43884334d5672b77d0ceeb4af69f9f9ad5214f56eac8fbdb5d8b8b36e44c54a2b42a80ce3e4e5370ab574efa85b1fa0a49d4fd434ed8c85b39d6129c3
data/.travis.yml CHANGED
@@ -1,5 +1,7 @@
1
1
  language: ruby
2
+ sudo: false
2
3
  rvm:
3
4
  - 1.9.3
4
5
  - 2.0.0
5
6
  - 2.1.0
7
+ - 2.2.4
data/CHANGELOG.md CHANGED
@@ -1,3 +1,14 @@
1
+ ### v2.4.0 / 2016-01-20
2
+
3
+ [Full Changelog](https://github.com/brightbox/brightbox-cli/compare/v2.3.4...v2.4.0)
4
+
5
+ Changes:
6
+
7
+ * Update `fog-brightbox` to v0.10.1
8
+ * Default behaviour of fog-brightbox v0.10.0 is to use collapsed API response
9
+ to account listing resulting in faster calls in `brightbox accounts list`
10
+ * Various changes to Travis settings
11
+
1
12
  ### v2.3.4 / 2015-11-23
2
13
 
3
14
  [Full Changelog](https://github.com/brightbox/brightbox-cli/compare/v2.3.3...v2.3.4)
data/Gemfile.lock CHANGED
@@ -1,8 +1,8 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- brightbox-cli (2.3.4)
5
- fog-brightbox (>= 0.9.0)
4
+ brightbox-cli (2.4.0)
5
+ fog-brightbox (>= 0.10.1)
6
6
  gli (~> 2.12.0)
7
7
  highline (~> 1.6.0)
8
8
  hirb (~> 0.6)
@@ -21,7 +21,7 @@ GEM
21
21
  safe_yaml (~> 1.0.0)
22
22
  diff-lcs (1.2.5)
23
23
  excon (0.45.4)
24
- fog-brightbox (0.9.0)
24
+ fog-brightbox (0.10.1)
25
25
  fog-core (~> 1.22)
26
26
  fog-json
27
27
  inflecto (~> 0.0.2)
@@ -43,7 +43,7 @@ GEM
43
43
  inflecto (0.0.2)
44
44
  metaclass (0.0.1)
45
45
  method_source (0.8.1)
46
- mime-types (2.6.2)
46
+ mime-types (2.99)
47
47
  mocha (0.14.0)
48
48
  metaclass (~> 0.0.1)
49
49
  multi_json (1.11.2)
@@ -86,4 +86,4 @@ DEPENDENCIES
86
86
  webmock
87
87
 
88
88
  BUNDLED WITH
89
- 1.10.6
89
+ 1.11.2
data/README.rdoc ADDED
@@ -0,0 +1,170 @@
1
+ = Brightbox Cloud Command Line Interface
2
+
3
+ `brightbox-cli` is a set of cli tools to interact with the Brightbox Cloud API.
4
+
5
+ You will need a user account on the Brightbox Cloud in order to make use of
6
+ these tools.
7
+
8
+ You can sign up at https://manage.brightbox.com
9
+
10
+ {<img src="https://travis-ci.org/brightbox/brightbox-cli.png?branch=master" alt="Build Status" />}[https://travis-ci.org/brightbox/brightbox-cli]
11
+
12
+ == UPGRADE NOTES
13
+
14
+ Version 1.0.0 adds a new top level `brightbox` command for the suite.
15
+
16
+ This may clash with our `brightbox` (brightbox-deployment) gem which, before
17
+ version 2.4.0, used `brightbox` as the name for it's binary. Please ensure you
18
+ update your `brightbox` gem to avoid using the wrong command.
19
+
20
+ We have included backwards compatible binaries for all the older CLI commands
21
+ (brightbox-accounts, brightbox-servers etc...) but recommend getting used to the
22
+ new form.
23
+
24
+ == Installation instructions
25
+
26
+ Install from Rubygems
27
+
28
+ $ gem install brightbox-cli
29
+
30
+ == Usage
31
+
32
+ The Brightbox CLI is a suite of tools that are accessible through the
33
+ `brightbox` command in a similar way to how you access `git` commands.
34
+
35
+ For a list of available commands use:
36
+
37
+ $ brightbox help
38
+
39
+ To add client (account based) credentials use:
40
+
41
+ $ brightbox config client_add cli-2igtb theclientsecret
42
+ Using config file /home/ubuntu/.brightbox/config
43
+ Creating new api client config cli-2igtb
44
+
45
+ To browse available resources use the resource name as the command:
46
+
47
+ $ brightbox servers
48
+ ... List of servers
49
+ $ brightbox images
50
+ ... List of images
51
+
52
+ Command structure may be subject to change.
53
+
54
+ === Using GPG to secure passwords
55
+
56
+ If you use an OAuth application to access your accounts
57
+ (https://www.brightbox.com/docs/guides/manager/oauth-applications/) then you
58
+ frequently need to renter your password.
59
+
60
+ From v1.5.0 you can store your password locally encrypted by GPG (https://www.gnupg.org/)
61
+ which will decrypt the password when needed. This will prompt for your GPG key
62
+ if not available to the GPG agent using your OS's configured pinentry program.
63
+
64
+ You need to have setup GPG with your own keys and have configured the pinentry
65
+ to prompt you when the key is locked.
66
+
67
+ The password file is named after your configuration's alias:
68
+
69
+ $ brightbox config
70
+ alias client_id secret api_url auth_url
71
+ ------------------------------------------------------------------------------------------------------------------
72
+ *main app-12345 xxxxxxxxxxxxxxx https://api.gb1.brightbox.com https://api.gb1.brightbox.com
73
+ ------------------------------------------------------------------------------------------------------------------
74
+
75
+ The alias here is `main`. To prepare the password run this command:
76
+
77
+ $ gpg --encrypt --recipient gpg@example.com > ~/.brightbox/main.password.gpg
78
+ (type your password)<RETURN>
79
+ <CTRL+D>
80
+ # Test it with...
81
+ $ gpg --decrypt ~/.brightbox/main.password.gpg
82
+ password!2015
83
+ $ brightbox accounts
84
+ INFO: client_id: app-12345 (main)
85
+ INFO: Decrypting /home/user/.brightbox/main.password.gpg to obtain password
86
+ gpg: encrypted with 2048-bit RSA key, ID ABCDE890, created 2015-01-01
87
+ "Jason Null <gpg@example.com>"
88
+ Your API credentials have been updated, please re-run your command.
89
+
90
+ Now when making commands you should only have to unlock your keyring to avoid
91
+ typing your password.
92
+
93
+ If you are prompted to enter your password still then the file may be named
94
+ incorrectly or there may be an issue with your GPG configuration.
95
+
96
+ To remove the password delete the `~/.brightbox/main.password.gpg` file.
97
+
98
+ == Usage guides
99
+
100
+ * http://docs.brightbox.com/reference/cli
101
+ * http://brightbox.com
102
+ * http://docs.brightbox.com/reference/api/
103
+
104
+ == BASH Auto-completion
105
+
106
+ A bash shell auto-completion script is provided to allow
107
+ autocompletion of all sub-commands, options and resource
108
+ identifiers. It is automatically configured by the Debian/Ubuntu
109
+ packages, but if you're installing from a gem you can manually tell
110
+ bash about it like this:
111
+
112
+ complete -C _brightbox-bash-completer -o filenames brightbox
113
+
114
+ The command `_brightbox-bash-completer` should be installed in the
115
+ system path when you install the gem. If for whatever reason it is not
116
+ in the path, just specify the full path to it:
117
+
118
+ complete -C /full/path/to/bin/_brightbox-bash-completer -o filenames brightbox
119
+
120
+ == Testing
121
+
122
+ You should be able to run the specs and features with the following steps:
123
+
124
+ $ bundle install
125
+ $ bundle exec rake
126
+
127
+ The specs use VCR to playback filtered recordings from real API sessions. This
128
+ process is not perfect, please report an issue
129
+
130
+ == Alternatives
131
+
132
+ There are a number of alternative ways to interact with the Brightbox Cloud.
133
+
134
+ * The Web GUI - https://manage.brightbox.com/
135
+ * fog - https://github.com/fog/fog
136
+ * knife plugin - https://github.com/rubiojr/knife-brightbox
137
+ * Vagrant plugin - https://github.com/NeilW/vagrant-brightbox
138
+
139
+ == Packaging
140
+
141
+ === Vendoring libraries
142
+
143
+ gems can be vendored into `lib/brightbox-cli/vendor/` for packaging and will be
144
+ prioritised over any gems.
145
+
146
+ === Debian/Ubuntu packaging
147
+
148
+ Packaging scripts are available in https://github.com/NeilW/brightbox-cli-debian-packaging
149
+
150
+ == License
151
+
152
+ Copyright (c) 2010-2013 John Leach, Brightbox Systems Ltd <john@brightbox.co.uk>
153
+
154
+ Permission is hereby granted, free of charge, to any person obtaining a copy
155
+ of this software and associated documentation files (the "Software"), to deal
156
+ in the Software without restriction, including without limitation the rights
157
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
158
+ copies of the Software, and to permit persons to whom the Software is
159
+ furnished to do so, subject to the following conditions:
160
+
161
+ The above copyright notice and this permission notice shall be included in
162
+ all copies or substantial portions of the Software.
163
+
164
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
165
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
166
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
167
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
168
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
169
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
170
+ THE SOFTWARE.
data/brightbox-cli.gemspec CHANGED
@@ -21,7 +21,7 @@ Gem::Specification.new do |s|
21
21
  s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
22
22
  s.require_paths = ["lib"]
23
23
 
24
- s.add_dependency "fog-brightbox", ">= 0.9.0"
24
+ s.add_dependency "fog-brightbox", ">= 0.10.1"
25
25
  s.add_dependency "gli", "~> 2.12.0"
26
26
  s.add_dependency "i18n", "~> 0.6.0"
27
27
  s.add_dependency "mime-types", "~> 2.6"
data/lib/brightbox-cli/version.rb CHANGED
@@ -1,3 +1,3 @@
1
1
  module Brightbox
2
- VERSION = "2.3.4" unless defined?(Brightbox::VERSION)
2
+ VERSION = "2.4.0" unless defined?(Brightbox::VERSION)
3
3
  end
metadata CHANGED
@@ -1,209 +1,209 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: brightbox-cli
3
3
  version: !ruby/object:Gem::Version
4
- version: 2.3.4
4
+ version: 2.4.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - John Leach
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2015-11-23 00:00:00.000000000 Z
11
+ date: 2016-01-20 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
- prerelease: false
14
+ name: fog-brightbox
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - '>='
17
+ - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.9.0
20
- name: fog-brightbox
19
+ version: 0.10.1
21
20
  type: :runtime
21
+ prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
- - - '>='
24
+ - - ">="
25
25
  - !ruby/object:Gem::Version
26
- version: 0.9.0
26
+ version: 0.10.1
27
27
  - !ruby/object:Gem::Dependency
28
- prerelease: false
28
+ name: gli
29
29
  requirement: !ruby/object:Gem::Requirement
30
30
  requirements:
31
- - - ~>
31
+ - - "~>"
32
32
  - !ruby/object:Gem::Version
33
33
  version: 2.12.0
34
- name: gli
35
34
  type: :runtime
35
+ prerelease: false
36
36
  version_requirements: !ruby/object:Gem::Requirement
37
37
  requirements:
38
- - - ~>
38
+ - - "~>"
39
39
  - !ruby/object:Gem::Version
40
40
  version: 2.12.0
41
41
  - !ruby/object:Gem::Dependency
42
- prerelease: false
42
+ name: i18n
43
43
  requirement: !ruby/object:Gem::Requirement
44
44
  requirements:
45
- - - ~>
45
+ - - "~>"
46
46
  - !ruby/object:Gem::Version
47
47
  version: 0.6.0
48
- name: i18n
49
48
  type: :runtime
49
+ prerelease: false
50
50
  version_requirements: !ruby/object:Gem::Requirement
51
51
  requirements:
52
- - - ~>
52
+ - - "~>"
53
53
  - !ruby/object:Gem::Version
54
54
  version: 0.6.0
55
55
  - !ruby/object:Gem::Dependency
56
- prerelease: false
56
+ name: mime-types
57
57
  requirement: !ruby/object:Gem::Requirement
58
58
  requirements:
59
- - - ~>
59
+ - - "~>"
60
60
  - !ruby/object:Gem::Version
61
61
  version: '2.6'
62
- name: mime-types
63
62
  type: :runtime
63
+ prerelease: false
64
64
  version_requirements: !ruby/object:Gem::Requirement
65
65
  requirements:
66
- - - ~>
66
+ - - "~>"
67
67
  - !ruby/object:Gem::Version
68
68
  version: '2.6'
69
69
  - !ruby/object:Gem::Dependency
70
- prerelease: false
70
+ name: multi_json
71
71
  requirement: !ruby/object:Gem::Requirement
72
72
  requirements:
73
- - - ~>
73
+ - - "~>"
74
74
  - !ruby/object:Gem::Version
75
75
  version: 1.11.0
76
- name: multi_json
77
76
  type: :runtime
77
+ prerelease: false
78
78
  version_requirements: !ruby/object:Gem::Requirement
79
79
  requirements:
80
- - - ~>
80
+ - - "~>"
81
81
  - !ruby/object:Gem::Version
82
82
  version: 1.11.0
83
83
  - !ruby/object:Gem::Dependency
84
- prerelease: false
84
+ name: net-ssh
85
85
  requirement: !ruby/object:Gem::Requirement
86
86
  requirements:
87
- - - <
87
+ - - "<"
88
88
  - !ruby/object:Gem::Version
89
89
  version: '3.0'
90
- name: net-ssh
91
90
  type: :runtime
91
+ prerelease: false
92
92
  version_requirements: !ruby/object:Gem::Requirement
93
93
  requirements:
94
- - - <
94
+ - - "<"
95
95
  - !ruby/object:Gem::Version
96
96
  version: '3.0'
97
97
  - !ruby/object:Gem::Dependency
98
- prerelease: false
98
+ name: highline
99
99
  requirement: !ruby/object:Gem::Requirement
100
100
  requirements:
101
- - - ~>
101
+ - - "~>"
102
102
  - !ruby/object:Gem::Version
103
103
  version: 1.6.0
104
- name: highline
105
104
  type: :runtime
105
+ prerelease: false
106
106
  version_requirements: !ruby/object:Gem::Requirement
107
107
  requirements:
108
- - - ~>
108
+ - - "~>"
109
109
  - !ruby/object:Gem::Version
110
110
  version: 1.6.0
111
111
  - !ruby/object:Gem::Dependency
112
- prerelease: false
112
+ name: hirb
113
113
  requirement: !ruby/object:Gem::Requirement
114
114
  requirements:
115
- - - ~>
115
+ - - "~>"
116
116
  - !ruby/object:Gem::Version
117
117
  version: '0.6'
118
- name: hirb
119
118
  type: :runtime
119
+ prerelease: false
120
120
  version_requirements: !ruby/object:Gem::Requirement
121
121
  requirements:
122
- - - ~>
122
+ - - "~>"
123
123
  - !ruby/object:Gem::Version
124
124
  version: '0.6'
125
125
  - !ruby/object:Gem::Dependency
126
- prerelease: false
126
+ name: mocha
127
127
  requirement: !ruby/object:Gem::Requirement
128
128
  requirements:
129
- - - '>='
129
+ - - ">="
130
130
  - !ruby/object:Gem::Version
131
131
  version: '0'
132
- name: mocha
133
132
  type: :development
133
+ prerelease: false
134
134
  version_requirements: !ruby/object:Gem::Requirement
135
135
  requirements:
136
- - - '>='
136
+ - - ">="
137
137
  - !ruby/object:Gem::Version
138
138
  version: '0'
139
139
  - !ruby/object:Gem::Dependency
140
- prerelease: false
140
+ name: pry-remote
141
141
  requirement: !ruby/object:Gem::Requirement
142
142
  requirements:
143
- - - '>='
143
+ - - ">="
144
144
  - !ruby/object:Gem::Version
145
145
  version: '0'
146
- name: pry-remote
147
146
  type: :development
147
+ prerelease: false
148
148
  version_requirements: !ruby/object:Gem::Requirement
149
149
  requirements:
150
- - - '>='
150
+ - - ">="
151
151
  - !ruby/object:Gem::Version
152
152
  version: '0'
153
153
  - !ruby/object:Gem::Dependency
154
- prerelease: false
154
+ name: rake
155
155
  requirement: !ruby/object:Gem::Requirement
156
156
  requirements:
157
- - - '>='
157
+ - - ">="
158
158
  - !ruby/object:Gem::Version
159
159
  version: '0'
160
- name: rake
161
160
  type: :development
161
+ prerelease: false
162
162
  version_requirements: !ruby/object:Gem::Requirement
163
163
  requirements:
164
- - - '>='
164
+ - - ">="
165
165
  - !ruby/object:Gem::Version
166
166
  version: '0'
167
167
  - !ruby/object:Gem::Dependency
168
- prerelease: false
168
+ name: rspec
169
169
  requirement: !ruby/object:Gem::Requirement
170
170
  requirements:
171
- - - ~>
171
+ - - "~>"
172
172
  - !ruby/object:Gem::Version
173
173
  version: '2.99'
174
- name: rspec
175
174
  type: :development
175
+ prerelease: false
176
176
  version_requirements: !ruby/object:Gem::Requirement
177
177
  requirements:
178
- - - ~>
178
+ - - "~>"
179
179
  - !ruby/object:Gem::Version
180
180
  version: '2.99'
181
181
  - !ruby/object:Gem::Dependency
182
- prerelease: false
182
+ name: vcr
183
183
  requirement: !ruby/object:Gem::Requirement
184
184
  requirements:
185
- - - ~>
185
+ - - "~>"
186
186
  - !ruby/object:Gem::Version
187
187
  version: '2.5'
188
- name: vcr
189
188
  type: :development
189
+ prerelease: false
190
190
  version_requirements: !ruby/object:Gem::Requirement
191
191
  requirements:
192
- - - ~>
192
+ - - "~>"
193
193
  - !ruby/object:Gem::Version
194
194
  version: '2.5'
195
195
  - !ruby/object:Gem::Dependency
196
- prerelease: false
196
+ name: webmock
197
197
  requirement: !ruby/object:Gem::Requirement
198
198
  requirements:
199
- - - '>='
199
+ - - ">="
200
200
  - !ruby/object:Gem::Version
201
201
  version: '0'
202
- name: webmock
203
202
  type: :development
203
+ prerelease: false
204
204
  version_requirements: !ruby/object:Gem::Requirement
205
205
  requirements:
206
- - - '>='
206
+ - - ">="
207
207
  - !ruby/object:Gem::Version
208
208
  version: '0'
209
209
  description: Scripts to interact with the Brightbox cloud API
@@ -227,8 +227,8 @@ executables:
227
227
  extensions: []
228
228
  extra_rdoc_files: []
229
229
  files:
230
- - .gitignore
231
- - .travis.yml
230
+ - ".gitignore"
231
+ - ".travis.yml"
232
232
  - CHANGELOG.md
233
233
  - Gemfile
234
234
  - Gemfile.lock
@@ -730,17 +730,17 @@ require_paths:
730
730
  - lib
731
731
  required_ruby_version: !ruby/object:Gem::Requirement
732
732
  requirements:
733
- - - '>='
733
+ - - ">="
734
734
  - !ruby/object:Gem::Version
735
735
  version: 1.9.3
736
736
  required_rubygems_version: !ruby/object:Gem::Requirement
737
737
  requirements:
738
- - - '>='
738
+ - - ">="
739
739
  - !ruby/object:Gem::Version
740
740
  version: '0'
741
741
  requirements: []
742
742
  rubyforge_project: brightbox-cli
743
- rubygems_version: 2.5.0
743
+ rubygems_version: 2.4.5.1
744
744
  signing_key:
745
745
  specification_version: 4
746
746
  summary: The Brightbox cloud management system
data/README.rdoc DELETED
@@ -1 +0,0 @@
1
- README