snowly 0.2.2 → 0.2.3
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.
- checksums.yaml +4 -4
- data/README.md +8 -23
- data/lib/snowly/version.rb +1 -1
- data/snowly.gemspec +1 -1
- metadata +14 -14
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
!binary "U0hBMQ==":
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 0dd1955dfdfa77ea8fb0cadd08bbe0f0c3659cbe
|
4
|
+
data.tar.gz: de6db92338bf7b3837ad94bf32db4a0c51505522
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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
|
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.
|
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
|
-
|
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
|
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.
|
data/lib/snowly/version.rb
CHANGED
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.
|
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:
|
112
|
+
name: pry-byebug
|
113
113
|
requirement: !ruby/object:Gem::Requirement
|
114
114
|
requirements:
|
115
115
|
- - ~>
|
116
116
|
- !ruby/object:Gem::Version
|
117
|
-
version: '
|
118
|
-
type: :
|
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: '
|
124
|
+
version: '3.3'
|
125
125
|
- !ruby/object:Gem::Dependency
|
126
|
-
name:
|
126
|
+
name: bundler
|
127
127
|
requirement: !ruby/object:Gem::Requirement
|
128
128
|
requirements:
|
129
129
|
- - ~>
|
130
130
|
- !ruby/object:Gem::Version
|
131
|
-
version: '
|
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: '
|
138
|
+
version: '1.11'
|
139
139
|
- !ruby/object:Gem::Dependency
|
140
|
-
name:
|
140
|
+
name: rake
|
141
141
|
requirement: !ruby/object:Gem::Requirement
|
142
142
|
requirements:
|
143
143
|
- - ~>
|
144
144
|
- !ruby/object:Gem::Version
|
145
|
-
version: '
|
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: '
|
152
|
+
version: '10.0'
|
153
153
|
- !ruby/object:Gem::Dependency
|
154
|
-
name:
|
154
|
+
name: rspec
|
155
155
|
requirement: !ruby/object:Gem::Requirement
|
156
156
|
requirements:
|
157
157
|
- - ~>
|
158
158
|
- !ruby/object:Gem::Version
|
159
|
-
version: '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.
|
166
|
+
version: '3.0'
|
167
167
|
- !ruby/object:Gem::Dependency
|
168
168
|
name: snowplow-tracker
|
169
169
|
requirement: !ruby/object:Gem::Requirement
|