snowly 0.2.2 → 0.2.3

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  !binary "U0hBMQ==":
3
- metadata.gz: 8363b19687de0fa4f4812b7a6209a2caf414149e
4
- data.tar.gz: e9b6a30be212eb0f42196f696dc10a6013cad6b0
3
+ metadata.gz: 0dd1955dfdfa77ea8fb0cadd08bbe0f0c3659cbe
4
+ data.tar.gz: de6db92338bf7b3837ad94bf32db4a0c51505522
5
5
  SHA512:
6
- metadata.gz: 0e713e4e7f804f8cf715730a9c157cfb4bf6493f019f59658e83752af4fc0d029af70087d8368d59d1c34b6b72757fd1c57d00f6c898d3f54edca56489edbe37
7
- data.tar.gz: 71423a4271c014abdecd4f4e146cf5a8aaa338a482fd417386dd5a1424e150aa512fee2b113544868d3b9fe582bf35d4380b206b427d7d12b4febc379efc95ed
6
+ metadata.gz: f4bbfaf664d3f1442f21cc90f4ce50fbaf6886b8dec6f7a782802ed07844395c8230e43536ee7e8f54c4442a1078b686d969cf03e6e8a09b7564ec4967b69883
7
+ data.tar.gz: bc163eaf001af257dec0693e140d599dd88013724165510f93e8609fa7c2e1fd27165f66ab9469275c6093cceea48db45c4d1ead5ffebd098f6d18a570a0f3cf
data/README.md CHANGED
@@ -2,11 +2,11 @@
2
2
 
3
3
  Debug your Snowplow implementation locally, without resorting to Snowplow's ETL tasks. It's like Facebook's URL Linter, but for Snowplow.
4
4
 
5
- Snowly is a minimal [Collector](https://github.com/snowplow/snowplow/wiki/Setting-up-a-collector) implementation intended to run on your development environment. It comes with a comprehensive validation engine, that will point out any schema requirement violations. You can easily validate your event requests before having to emmit them to a cloudfront, closure or scala collector.
5
+ Snowly is a minimal [Collector](https://github.com/snowplow/snowplow/wiki/Setting-up-a-collector) implementation intended to run on your development environment. It comes with a comprehensive validation engine, that will point out any schema requirement violations. You can easily validate your event requests before having to emit them to a cloudfront, closure or scala collector.
6
6
 
7
7
  ### Motivation
8
8
 
9
- Snowplow has an excellent toolset, but the first implementation stages can be hard. To run Snowplow properly you have to set up a lot of external dependencies like AWS permissions, Cloudfront distributions and EMR jobs. If you're tweaking the snowplow model to fit your needs or using trackers that don't enforce every requirement, you'll find yourself waiting for the ETL jobs to run in order to validate every implementation change. __[update] This has changed a quite a bit with Snowplow Mini's release. It's a lot easier to get started, but Snowly is still valuable as a first step and debug tool.__
9
+ Snowplow has an excellent toolset, but the first implementation stages can be hard. To run Snowplow properly you have to set up a lot of external dependencies like AWS permissions, Cloudfront distributions and EMR jobs. If you're tweaking the snowplow model to fit your needs or using trackers that don't enforce every requirement, you'll find yourself waiting for the ETL jobs to run in order to validate every implementation change.
10
10
 
11
11
  ### Who will get the most from Snowly
12
12
 
@@ -22,7 +22,7 @@ Use cases:
22
22
 
23
23
  - Validate custom contexts or unstructured event types and required fields.
24
24
  - Restrict values for any field, like using a custom dictionary for the structured event action field.
25
- - Define requirements based on the content of another field: If __event action__ is 'viewed_product', __event property__ is required.
25
+ - Define requirements based on the content of another field: If __event action__ is 'viewed_product', then __event property__ is required.
26
26
 
27
27
  ## Installation
28
28
 
@@ -63,32 +63,15 @@ touch ~/schemas/com.my_company/viewed_product/jsonschema/1-0-0
63
63
 
64
64
  ## Usage
65
65
 
66
- Just use `snowly` to start and `snowly -K` to stop. Where allowed, a browser window will open showing the collector's address.
67
-
68
- Other options:
69
-
70
- -K, --kill kill the running process and exit
71
- -S, --status display the current running PID and URL then quit
72
- -s, --server SERVER serve using SERVER (thin/mongrel/webrick)
73
- -o, --host HOST listen on HOST (default: 0.0.0.0)
74
- -p, --port PORT use PORT (default: 5678)
75
- -x, --no-proxy ignore env proxy settings (e.g. http_proxy)
76
- -e, --env ENVIRONMENT use ENVIRONMENT for defaults (default: development)
77
- -F, --foreground don't daemonize, run in the foreground
78
- -L, --no-launch don't launch the browser
79
- -d, --debug raise the log level to :debug (default: :info)
80
- --app-dir APP_DIR set the app dir where files are stored (default: ~/.vegas/collector)/)
81
- -P, --pid-file PID_FILE set the path to the pid file (default: app_dir/collector.pid)
82
- --log-file LOG_FILE set the path to the log file (default: app_dir/collector.log)
83
- --url-file URL_FILE set the path to the URL file (default: app_dir/collector.url)
66
+ Just use `snowly` to start and `snowly -K` to stop. Where allowed, a browser window will open showing the collector's address. Use `snowly --help` for other options.
84
67
 
85
68
  ### Output
86
69
 
87
70
  When Snowly finds something wrong, it renders a parsed array of requests along with its errors.
88
71
 
89
- If everything is ok, Snowly delivers the default Snowplow pixel, unless you're using the debug mode. In debug mode it always renders the parsed contents of your requests.
72
+ When everything is ok, Snowly delivers the default Snowplow pixel, unless you're using the debug mode.
90
73
 
91
- If you can't investigate the request's response, you can start Snowly in the foreground and in Debug Mode to output the response to STDOUT.
74
+ If you can't investigate the request's response, you can start Snowly in the foreground and in __Debug Mode__ to output the response to __STDOUT__.
92
75
  `snowly -d -F`
93
76
 
94
77
  Example:
@@ -116,6 +99,8 @@ Example:
116
99
 
117
100
  If you're using the closure collector and can't see your requests firing up right away, try [manually flushing](https://github.com/snowplow/snowplow/wiki/Ruby-Tracker#54-manual-flushing) or change your emitter's buffer_size(number of events before flusing) to a lower value.
118
101
 
102
+ In debug mode Snowly always renders the parsed contents of your requests. If you're using the javascript tracker, use the __post__ option to be able to read the response in your browser inspector. The js tracker implementation for __get__ requests works by changing an image src, so the inspector hides the response.
103
+
119
104
  ## JSON Schemas
120
105
 
121
106
  JSON Schema is a powerful tool for validating the structure of JSON data. I recommend reading this excellent [Guide](http://spacetelescope.github.io/understanding-json-schema/) from Michael Droettboom to understand all of its capabilities, but you can start with the examples bellow.
@@ -1,3 +1,3 @@
1
1
  module Snowly
2
- VERSION = "0.2.2"
2
+ VERSION = "0.2.3"
3
3
  end
data/snowly.gemspec CHANGED
@@ -27,11 +27,11 @@ Gem::Specification.new do |spec|
27
27
  spec.add_dependency 'sinatra-contrib', '~> 1.4'
28
28
  spec.add_dependency 'vegas', '~> 0.1'
29
29
  spec.add_dependency 'thin', '~> 1.7'
30
+ spec.add_dependency 'pry-byebug', '~> 3.3'
30
31
 
31
32
  spec.add_development_dependency 'bundler', '~> 1.11'
32
33
  spec.add_development_dependency 'rake', '~> 10.0'
33
34
  spec.add_development_dependency 'rspec', '~> 3.0'
34
- spec.add_development_dependency 'pry-byebug', '~> 3.3'
35
35
  spec.add_development_dependency 'snowplow-tracker', '~> 0.5'
36
36
  spec.add_development_dependency 'webmock', '~> 2.0'
37
37
  spec.add_development_dependency "shotgun", '~> 0.9'
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: snowly
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.2
4
+ version: 0.2.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - Alexandre Angelim
@@ -109,61 +109,61 @@ dependencies:
109
109
  - !ruby/object:Gem::Version
110
110
  version: '1.7'
111
111
  - !ruby/object:Gem::Dependency
112
- name: bundler
112
+ name: pry-byebug
113
113
  requirement: !ruby/object:Gem::Requirement
114
114
  requirements:
115
115
  - - ~>
116
116
  - !ruby/object:Gem::Version
117
- version: '1.11'
118
- type: :development
117
+ version: '3.3'
118
+ type: :runtime
119
119
  prerelease: false
120
120
  version_requirements: !ruby/object:Gem::Requirement
121
121
  requirements:
122
122
  - - ~>
123
123
  - !ruby/object:Gem::Version
124
- version: '1.11'
124
+ version: '3.3'
125
125
  - !ruby/object:Gem::Dependency
126
- name: rake
126
+ name: bundler
127
127
  requirement: !ruby/object:Gem::Requirement
128
128
  requirements:
129
129
  - - ~>
130
130
  - !ruby/object:Gem::Version
131
- version: '10.0'
131
+ version: '1.11'
132
132
  type: :development
133
133
  prerelease: false
134
134
  version_requirements: !ruby/object:Gem::Requirement
135
135
  requirements:
136
136
  - - ~>
137
137
  - !ruby/object:Gem::Version
138
- version: '10.0'
138
+ version: '1.11'
139
139
  - !ruby/object:Gem::Dependency
140
- name: rspec
140
+ name: rake
141
141
  requirement: !ruby/object:Gem::Requirement
142
142
  requirements:
143
143
  - - ~>
144
144
  - !ruby/object:Gem::Version
145
- version: '3.0'
145
+ version: '10.0'
146
146
  type: :development
147
147
  prerelease: false
148
148
  version_requirements: !ruby/object:Gem::Requirement
149
149
  requirements:
150
150
  - - ~>
151
151
  - !ruby/object:Gem::Version
152
- version: '3.0'
152
+ version: '10.0'
153
153
  - !ruby/object:Gem::Dependency
154
- name: pry-byebug
154
+ name: rspec
155
155
  requirement: !ruby/object:Gem::Requirement
156
156
  requirements:
157
157
  - - ~>
158
158
  - !ruby/object:Gem::Version
159
- version: '3.3'
159
+ version: '3.0'
160
160
  type: :development
161
161
  prerelease: false
162
162
  version_requirements: !ruby/object:Gem::Requirement
163
163
  requirements:
164
164
  - - ~>
165
165
  - !ruby/object:Gem::Version
166
- version: '3.3'
166
+ version: '3.0'
167
167
  - !ruby/object:Gem::Dependency
168
168
  name: snowplow-tracker
169
169
  requirement: !ruby/object:Gem::Requirement