log-analyser 0.1.1.pre.expandreadme.20201107175459 → 0.1.1.pre.test.20201106194135
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/Manifest +0 -0
- data/README.md +15 -107
- data/Rakefile +3 -8
- data/log-analyser.gemspec +1 -1
- metadata +7 -6
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 6912b36d30f208b346179fcf9513486d1327a7f1c80ce3bbc761ac52662fceff
|
|
4
|
+
data.tar.gz: f68d64ad5f087c3af8db3fb90fc6bcfa16ddf3a68a8d03790bfd22fc4f2a70e6
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5416de8c283c39a961749b7a26d9f2b3494aad29041b5a2d22846a557082a46f64521be753655a70acb213ca3c5eba3f140327bb88817308e5c2bf9f87818277
|
|
7
|
+
data.tar.gz: c4a40bd86969b4c9898b85333398421a0cec1071e080c16300ca370d2f51c451c8feb6a248ad946bfd279f0ffa8c634250400ab7bf7dd7d30e9e39e7a7b97027
|
data/Manifest
ADDED
|
File without changes
|
data/README.md
CHANGED
|
@@ -1,143 +1,51 @@
|
|
|
1
1
|
[](https://coveralls.io/github/DMazzei/log-analyser?branch=master)
|
|
2
|
-
[](https://badge.fury.io/rb/log-analyser)
|
|
3
|
-
[](https://app.circleci.com/pipelines/github/DMazzei/log-analyser)
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
# Log-Analyser
|
|
8
2
|
|
|
9
|
-
## About
|
|
10
3
|
|
|
11
|
-
Simple ruby library to read and parse web-server's log files and aggregate pageview data.
|
|
12
4
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
<summary>check minimal instructions</summary>
|
|
5
|
+
```
|
|
6
|
+
A pageview is defined as a view of a page on your site that is being tracked by the Analytics tracking code. If a user clicks reload after reaching the page, this is counted as an additional pageview. If a user navigates to a different page and then returns to the original page, a second pageview is recorded as well.
|
|
16
7
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
</br>- the method `all` will return the pageview count
|
|
20
|
-
</br>- whilst method `unique` will return the unique pageview count.
|
|
8
|
+
A unique pageview, as seen in the Content Overview report, aggregates pageviews that are generated by the same user during the same session. A unique pageview represents the number of sessions during which that page was viewed one or more times.
|
|
9
|
+
```
|
|
21
10
|
|
|
22
|
-
</details>
|
|
23
11
|
|
|
24
|
-
|
|
25
|
-
<details>
|
|
26
|
-
<summary>click to expand the index</summary>
|
|
12
|
+
# Log::Analyser
|
|
27
13
|
|
|
28
|
-
|
|
29
|
-
- [Usage](#usage)
|
|
30
|
-
- [Logs and Pageviews](#logs-and-pageviews)
|
|
31
|
-
* [Definitions](#definitions)
|
|
32
|
-
* [Log Formatting](#log-formatting)
|
|
33
|
-
- [Development](#development)
|
|
34
|
-
- [Contributing](#contributing)
|
|
35
|
-
- [Next Steps](#next-steps)
|
|
36
|
-
- [License](#license)
|
|
37
|
-
|
|
14
|
+
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/log/analyser`. To experiment with that code, run `bin/console` for an interactive prompt.
|
|
38
15
|
|
|
39
|
-
|
|
16
|
+
TODO: Delete this and the text above, and describe your gem
|
|
40
17
|
|
|
41
18
|
## Installation
|
|
42
19
|
|
|
43
|
-
|
|
20
|
+
Add this line to your application's Gemfile:
|
|
44
21
|
|
|
45
22
|
```ruby
|
|
46
23
|
gem 'log-analyser'
|
|
47
24
|
```
|
|
48
25
|
|
|
26
|
+
And then execute:
|
|
27
|
+
|
|
28
|
+
$ bundle install
|
|
29
|
+
|
|
49
30
|
Or install it yourself as:
|
|
50
31
|
|
|
51
32
|
$ gem install log-analyser
|
|
52
33
|
|
|
53
34
|
## Usage
|
|
54
35
|
|
|
55
|
-
|
|
56
|
-
...
|
|
57
|
-
...
|
|
58
|
-
...
|
|
59
|
-
...
|
|
60
|
-
...
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
## Logs and Pageviews
|
|
64
|
-
|
|
65
|
-
### Definitions
|
|
66
|
-
```
|
|
67
|
-
A pageview is defined as a view of a page on your site that is being tracked by the Analytics tracking code.
|
|
68
|
-
If a user clicks reload after reaching the page, this is counted as an additional pageview.
|
|
69
|
-
If a user navigates to a different page and then returns to the original page, a second pageview is recorded as well.
|
|
70
|
-
|
|
71
|
-
A unique pageview, as seen in the Content Overview report, aggregates pageviews that are generated by the same
|
|
72
|
-
user during the same session. A unique pageview represents the number of sessions during which that page was
|
|
73
|
-
viewed one or more times.
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
### Log Formatting
|
|
77
|
-
|
|
78
|
-
The library is prepared to parser text files, containing one entry per line, in the format: `\page_name identifier`.
|
|
79
|
-
|
|
80
|
-
A space must separate the page name (first column) from the user identifier (e.g. IP address):
|
|
81
|
-
|
|
82
|
-
```
|
|
83
|
-
/help_page/1 126.318.035.038
|
|
84
|
-
/contact 184.123.665.067
|
|
85
|
-
/home 184.123.665.067
|
|
86
|
-
```
|
|
36
|
+
TODO: Write usage instructions here
|
|
87
37
|
|
|
88
38
|
## Development
|
|
89
39
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
Install the Ruby version specified in `.ruby-version` </br>
|
|
93
|
-
Clone the project and install Bundler
|
|
40
|
+
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.
|
|
94
41
|
|
|
95
|
-
|
|
96
|
-
git clone git@github.com:DMazzei/log-analyser.git
|
|
97
|
-
cd log-analyser
|
|
98
|
-
gem install bundler
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
#### Setup:
|
|
102
|
-
|
|
103
|
-
Run the initial setup
|
|
104
|
-
|
|
105
|
-
$ bin/setup
|
|
106
|
-
|
|
107
|
-
> If you need to reinstall dependencies or something alike:
|
|
108
|
-
> ```
|
|
109
|
-
> $ bundle install
|
|
110
|
-
> ```
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
You can also run `Bundle exec console` for an interactive prompt that will allow you to experiment.
|
|
114
|
-
|
|
115
|
-
To install this gem onto your local machine, run `bundle exec rake install`.
|
|
116
|
-
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 tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
|
117
|
-
|
|
118
|
-
#### Linter (rubocop)
|
|
119
|
-
|
|
120
|
-
_*Rubocop*_ is used as code analyser and maintain code formatting (as well as some best practices).
|
|
121
|
-
|
|
122
|
-
Use `Bundle exec rake rubocop` to run the checks.
|
|
123
|
-
|
|
124
|
-
#### Test coverage
|
|
125
|
-
|
|
126
|
-
Use `Bundle exec rake rspec` to run the tests.
|
|
127
|
-
|
|
128
|
-
The test coverage is handled by `rspec`, `simplecov` and `coveralls`.
|
|
129
|
-
Status and coverage history can be checked [here](https://coveralls.io/github/DMazzei/log-analyser).
|
|
42
|
+
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 tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
|
130
43
|
|
|
131
44
|
## Contributing
|
|
132
45
|
|
|
133
46
|
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/log-analyser.
|
|
134
47
|
|
|
135
|
-
## Next Steps
|
|
136
|
-
|
|
137
|
-
- Extend the logfile formatting;
|
|
138
48
|
|
|
139
49
|
## License
|
|
140
50
|
|
|
141
51
|
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|
|
142
|
-
|
|
143
|
-
|
data/Rakefile
CHANGED
|
@@ -1,16 +1,11 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
require 'bundler/setup'
|
|
5
|
-
rescue LoadError
|
|
6
|
-
puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
|
|
7
|
-
end
|
|
8
|
-
|
|
9
|
-
Bundler::GemHelper.install_tasks
|
|
10
|
-
|
|
3
|
+
require 'bundler/setup'
|
|
11
4
|
require 'rubygems'
|
|
12
5
|
require 'rspec/core/rake_task'
|
|
13
6
|
|
|
7
|
+
Bundler::GemHelper.install_tasks
|
|
8
|
+
|
|
14
9
|
RSpec::Core::RakeTask.new(:spec)
|
|
15
10
|
|
|
16
11
|
task default: :spec
|
data/log-analyser.gemspec
CHANGED
|
@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
|
|
|
22
22
|
|
|
23
23
|
# Specify which files should be added to the gem when it is released.
|
|
24
24
|
# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
|
|
25
|
-
spec.files = %w(.ruby-version CHANGELOG Gemfile Gemfile.lock Guardfile LICENSE.txt README.md Rakefile bin/setup config/environment.rb lib/pageviews.rb lib/pageviews_log_aggregator.rb lib/parser.rb lib/unique_pageviews.rb log-analyser.gemspec version.rb)
|
|
25
|
+
spec.files = %w(.ruby-version CHANGELOG Gemfile Gemfile.lock Guardfile LICENSE.txt Manifest README.md Rakefile bin/setup config/environment.rb lib/pageviews.rb lib/pageviews_log_aggregator.rb lib/parser.rb lib/unique_pageviews.rb log-analyser.gemspec version.rb)
|
|
26
26
|
spec.bindir = 'exe'
|
|
27
27
|
spec.executables = spec.files.grep(/^exe\//) { |f| File.basename(f) }
|
|
28
28
|
spec.require_paths = ['lib']
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: log-analyser
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1.1.pre.
|
|
4
|
+
version: 0.1.1.pre.test.20201106194135
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Dan Mazzei
|
|
8
|
-
autorequire:
|
|
8
|
+
autorequire:
|
|
9
9
|
bindir: exe
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2020-11-
|
|
11
|
+
date: 2020-11-06 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
13
|
description: Log reader and data aggregator for pageviews information.
|
|
14
14
|
email:
|
|
@@ -23,6 +23,7 @@ files:
|
|
|
23
23
|
- Gemfile.lock
|
|
24
24
|
- Guardfile
|
|
25
25
|
- LICENSE.txt
|
|
26
|
+
- Manifest
|
|
26
27
|
- README.md
|
|
27
28
|
- Rakefile
|
|
28
29
|
- bin/setup
|
|
@@ -38,7 +39,7 @@ licenses:
|
|
|
38
39
|
- MIT
|
|
39
40
|
metadata:
|
|
40
41
|
homepage_uri: https://github.com/DMazzei/log-analyser
|
|
41
|
-
post_install_message:
|
|
42
|
+
post_install_message:
|
|
42
43
|
rdoc_options: []
|
|
43
44
|
require_paths:
|
|
44
45
|
- lib
|
|
@@ -53,8 +54,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
53
54
|
- !ruby/object:Gem::Version
|
|
54
55
|
version: 1.3.1
|
|
55
56
|
requirements: []
|
|
56
|
-
rubygems_version: 3.1.
|
|
57
|
-
signing_key:
|
|
57
|
+
rubygems_version: 3.1.2
|
|
58
|
+
signing_key:
|
|
58
59
|
specification_version: 4
|
|
59
60
|
summary: Log reader and data aggregator for pageviews information.
|
|
60
61
|
test_files: []
|