faster_path 0.0.3 → 0.0.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.gitignore +1 -1
- data/.travis.yml +10 -2
- data/README.md +53 -15
- data/lib/faster_path/version.rb +1 -1
- data/lib/faster_path.rb +4 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 12559a70086221b3a9d8bad4dd21a390bedd7672
|
|
4
|
+
data.tar.gz: 7a2924fd52a79a8fed10f83f49b2b262bb1fca58
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 8c8af46b6547dfe4676eb51797d2cd1768dd898e21b3b88c67214814600660bd498b81fe05408431a956fff3fc5080b527875637a49069c57e33cb2b9c218203
|
|
7
|
+
data.tar.gz: 407d21b3b56b670b3351d712bd4726805e2f53cf1d47f6f6074d50884c1d09ee45c11cc27ef231e2c2c0192eb11671dcd3ee1b21565b0e4756b2a273246d210b
|
data/.gitignore
CHANGED
data/.travis.yml
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
|
-
sudo:
|
|
1
|
+
sudo: true
|
|
2
2
|
language: ruby
|
|
3
3
|
rvm:
|
|
4
|
+
- 2.2.5
|
|
4
5
|
- 2.3.1
|
|
5
|
-
|
|
6
|
+
env:
|
|
7
|
+
- TEST_REFINEMENTS=true
|
|
8
|
+
- TEST_REFINEMENTS=false
|
|
9
|
+
before_install:
|
|
10
|
+
- gem install bundler -v 1.12.5
|
|
11
|
+
- curl -sSf https://static.rust-lang.org/rustup.sh | sudo sh -s -- --channel=nightly
|
|
12
|
+
- bundle && bundle exec rake build_src && rake clean_src
|
|
13
|
+
script: bundle exec rake test
|
data/README.md
CHANGED
|
@@ -1,21 +1,59 @@
|
|
|
1
1
|
# FasterPath
|
|
2
|
+
[](https://badge.fury.io/rb/faster_path)
|
|
3
|
+
[](https://travis-ci.org/danielpclark/faster_path)
|
|
2
4
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
The primary **GOAL** of this project is to improve performance in the Rails environment as path relation
|
|
8
|
-
and file lookup is a huge bottleneck in performance. As this is the case the path performance updates
|
|
9
|
-
will likely not be limited to just changing Pathname but also will be offering changes in related methods
|
|
10
|
-
and classes.
|
|
5
|
+
The primary **GOAL** of this project is to improve performance in the most heavily used areas of Ruby as
|
|
6
|
+
path relation and file lookup is currently a huge bottleneck in performance. As this is the case the
|
|
7
|
+
path performance updates will likely not be limited to just changing the Pathname class but also will
|
|
8
|
+
be offering changes in related methods and classes.
|
|
11
9
|
|
|
12
10
|
Users will have the option to write their apps directly for this library, or they can choose to either
|
|
13
|
-
refine or monkeypatch the existing library. Refinements are narrowed to scope and monkeypatching will
|
|
11
|
+
refine or monkeypatch the existing standard library. Refinements are narrowed to scope and monkeypatching will
|
|
14
12
|
be a sledge hammer ;-)
|
|
15
13
|
|
|
16
14
|
**NOTE**: Refinements and monkeypatch methods are highly likely to be changed and renamed pre version
|
|
17
15
|
0.1.0 so keep that in mind!
|
|
18
16
|
|
|
17
|
+
## Why
|
|
18
|
+
|
|
19
|
+
I did a check on Rails on what methods were being called the most and where the application spend
|
|
20
|
+
most of its time. It turns out roughly 80% _(as far as I can tell)_ of the time spent and calls made
|
|
21
|
+
are file Path handling. This is shocking, but it only gets worse when handling assets. **That is
|
|
22
|
+
why we need to deal with these load heavy methods in the most efficient manner!**
|
|
23
|
+
|
|
24
|
+
Here's a snippet of a Rails stack profile with some of the most used and time expensive methods.
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
Booting: development
|
|
28
|
+
Endpoint: "/"
|
|
29
|
+
user system total real
|
|
30
|
+
100 requests 26.830000 1.780000 28.610000 ( 28.866952)
|
|
31
|
+
Running `stackprof tmp/2016-06-09T00:42:10-04:00-stackprof-cpu-myapp.dump`. Execute `stackprof --help` for more info
|
|
32
|
+
==================================
|
|
33
|
+
Mode: cpu(1000)
|
|
34
|
+
Samples: 7184 (0.03% miss rate)
|
|
35
|
+
GC: 1013 (14.10%)
|
|
36
|
+
==================================
|
|
37
|
+
TOTAL (pct) SAMPLES (pct) FRAME
|
|
38
|
+
1894 (26.4%) 1894 (26.4%) Pathname#chop_basename
|
|
39
|
+
1466 (20.4%) 305 (4.2%) Pathname#plus
|
|
40
|
+
1628 (22.7%) 162 (2.3%) Pathname#+
|
|
41
|
+
234 (3.3%) 117 (1.6%) ActionView::PathResolver#find_template_paths
|
|
42
|
+
2454 (34.2%) 62 (0.9%) Pathname#join
|
|
43
|
+
57 (0.8%) 52 (0.7%) ActiveSupport::FileUpdateChecker#watched
|
|
44
|
+
760 (10.6%) 47 (0.7%) Pathname#relative?
|
|
45
|
+
131 (1.8%) 25 (0.3%) ActiveSupport::FileUpdateChecker#max_mtime
|
|
46
|
+
88 (1.2%) 21 (0.3%) Sprockets::Asset#dependency_fresh?
|
|
47
|
+
18 (0.3%) 18 (0.3%) ActionView::Helpers::AssetUrlHelper#compute_asset_extname
|
|
48
|
+
108 (1.5%) 14 (0.2%) ActionView::Helpers::AssetUrlHelper#asset_path
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Status
|
|
52
|
+
|
|
53
|
+
* Rust compilation is working
|
|
54
|
+
* Methods are _most likely_ stable
|
|
55
|
+
* Testers and developers are most welcome!
|
|
56
|
+
|
|
19
57
|
## Installation
|
|
20
58
|
|
|
21
59
|
Ensure Rust is installed:
|
|
@@ -44,11 +82,11 @@ Or install it yourself as:
|
|
|
44
82
|
|
|
45
83
|
Current methods implemented:
|
|
46
84
|
|
|
47
|
-
|Rust Implementation|Ruby Implementation|Performance
|
|
48
|
-
|
|
49
|
-
| `FasterPath.absolute?` | `Pathname#absolute?` |
|
|
50
|
-
| `FasterPath.chop_basename` | `Pathname#chop_basename` |
|
|
51
|
-
| FasterPath.blank
|
|
85
|
+
|FasterPath Rust Implementation|Ruby 2.3.1 Implementation|Performance Improvement|
|
|
86
|
+
|---|---|:---:|
|
|
87
|
+
| `FasterPath.absolute?` | `Pathname#absolute?` | 1234.6% |
|
|
88
|
+
| `FasterPath.chop_basename` | `Pathname#chop_basename` | 27.5% |
|
|
89
|
+
| `FasterPath.blank?` | | |
|
|
52
90
|
|
|
53
91
|
You may choose to use the methods directly, or scope change to rewrite behavior on the
|
|
54
92
|
standard library with the included refinements, or even call a method to monkeypatch
|
|
@@ -64,7 +102,7 @@ require "faster_path/optional/refinements"
|
|
|
64
102
|
using FasterPath::RefinePathname
|
|
65
103
|
```
|
|
66
104
|
|
|
67
|
-
And for the
|
|
105
|
+
And for the sledgehammer of monkey patching you can do
|
|
68
106
|
|
|
69
107
|
```
|
|
70
108
|
require "faster_path/optional/monkeypatching"
|
data/lib/faster_path/version.rb
CHANGED
data/lib/faster_path.rb
CHANGED
|
@@ -28,7 +28,10 @@ module FasterPath
|
|
|
28
28
|
private
|
|
29
29
|
module Rust
|
|
30
30
|
extend FFI::Library
|
|
31
|
-
ffi_lib 'target/release/libfaster_path.so'
|
|
31
|
+
#ffi_lib 'target/release/libfaster_path.so'
|
|
32
|
+
ffi_lib begin
|
|
33
|
+
"#{File.expand_path("../target/release/", File.dirname(__FILE__))}/libfaster_path.#{FFI::Platform::LIBSUFFIX}"
|
|
34
|
+
end
|
|
32
35
|
attach_function :is_absolute, [ :string ], :bool
|
|
33
36
|
attach_function :is_blank, [ :string ], :bool
|
|
34
37
|
attach_function :basename, [ :string ], :string
|