svelte-on-rails 0.0.45 → 1.0.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 (3) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +25 -14
  3. metadata +1 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6ff301ac1c131b28f869668ca522cef6127e3d0946ed87b41da478555048fd8e
4
- data.tar.gz: 4acb430643e3b6962c595299e2265c7c1075eb11c65eccb08b0fbc7ccc08e6b5
3
+ metadata.gz: af9b4125161ea52c5785989db9e7f4b250a4bbe993f49264403680c5aa5467fb
4
+ data.tar.gz: 1d21a733aa52d57f892159baeb88c162cb78f46fca648dd2f31b45e3db8819e0
5
5
  SHA512:
6
- metadata.gz: 67fc3e82acf84cf6e09a4eded78d0ab8cd74b4bee8b92a91438382205e4f81c6f4fa5f443c6e4ba06ba935ae7799e1ea3a7fe3e26c9306ec7a8696766162526a
7
- data.tar.gz: f6f4564ded3293a4e6b37b65bf1557b88f69faba8e9ae0c7b857921b3733b73f144924ce81456b857d437dc0e9bf049ef174d1dd799355ba031e448514528690
6
+ metadata.gz: 72c0797453be3020409b6e28f5b7f472e8e0c1a22e010c401925ad2a81ac360c522612a7e52bac3d7a8da5a4c51f62668a68d46a33b3a955ed9e072366a567fd
7
+ data.tar.gz: 7f377d2c359daa8a9a2e18cd7c147187dd4249bbd0a8b5987f0feddb4a7b72020bc49591e04502055e4a7223e78e05b8e832c21c345dc93ac1d943440587dfc0
data/README.md CHANGED
@@ -17,8 +17,8 @@ Thanks to [shakacode](https://github.com/shakacode/react_on_rails)
17
17
  and [ElMassimo](https://github.com/ElMassimo) for inspiring and helping me with their gems.
18
18
 
19
19
  **STATUS** This gem is in early development but ready to use for curious developers.
20
- It has a 100% test coverage, all tests pass when triggered indiviudally.
21
- Running all tests together fails for some tests (ToDo).
20
+ It has a 100% test coverage, all tests pass.
21
+ It is not yet implemented on my customer projects, but this will follow soon.
22
22
 
23
23
  If you have issues, please open one and contributors are welcome!
24
24
 
@@ -34,9 +34,7 @@ If you have issues, please open one and contributors are welcome!
34
34
 
35
35
  ## Installation from cero
36
36
 
37
- together with haml, vite, svelte and turbo
38
-
39
- If you want to start from a new rails app, follow theese tutorials
37
+ With haml, vite, svelte and turbo:
40
38
 
41
39
  ```bash
42
40
  rails new my-test-app --skip-javascript
@@ -75,14 +73,17 @@ And there is the option `--force` that would not ask you whether it should overw
75
73
  This means, if you want all, except haml, you can run:
76
74
 
77
75
  ```bash
78
- rails g svelte_on_rails:install --vite --turbo --svelte --hello-world --force
76
+ rails g svelte_on_rails:install --vite --turbo --svelte --hello-world
79
77
  ```
80
78
 
81
- The installer is written carefully: It does not overwrite a file without asking.
82
- It tells you all what he is doing.
79
+ The installer is written carefully: It does not overwrite a file without asking
80
+ and tells you all what he is doing.
83
81
 
84
82
  At the end, you just have to (re-) start your server
85
- and you will see a Svelte component.
83
+ and you will see a Svelte Hello World component.
84
+
85
+ This hello world has a second page where the most common import statements are demonstrated,
86
+ separated for server and client side rendering.
86
87
 
87
88
  Then, you can run
88
89
 
@@ -120,12 +121,13 @@ Both should return the same html. And your global styles should be applied same
120
121
  for both cases. For 95% of use cases this is the case.
121
122
 
122
123
  For check the **ssr pipeline** you can pass the options `ssr: true` and `hydrate: false`
123
- to the view helper. That Way you will see a dead html (no javascript is working).
124
+ to the view helper. This way you will see a «dead» html (no javascript is working).
124
125
 
125
126
  For check the **client side pipeline** you can pass the option `ssr: false` and
126
127
  `hydrate: true` to the view helper.
127
128
 
128
- If both are looking similar, you are good to go.
129
+ If both are looking similar, you are good to go. Then, remove theese options, the defaults are
130
+ `ssr: :auto` and `hydrate: true`.
129
131
 
130
132
  ### Import statements
131
133
 
@@ -191,19 +193,28 @@ rails svelte_on_rails:remove_hello_world
191
193
 
192
194
  Contributors welcome!
193
195
 
194
- After downloaded the gem, please run the task
196
+ **Download the code and run the tests**
197
+
198
+ Download the source code from the repository, and within the project folder run:
195
199
 
196
200
  ```bash
197
201
  rake svelte_on_rails:create_contributor_configs_file
198
202
  ```
199
203
  and define a `generated_test_app_folder_path` (required) for apps, generated for the testings.
200
204
 
201
- For development of the **npm package @csedl/svelte-on-rails** you can set the
202
- `local_npm_package_path` (optional) and insert the path to the npm package on your local machine.
205
+ For development of the **npm package @csedl/svelte-on-rails** (optional) please download the source code of the
206
+ npm package and set
207
+ `local_npm_package_path` and set the path to the npm package on your local machine.
203
208
  This will cause the installer, to install the npm package from a local path instead from the npm registry.
204
209
 
210
+ Then run the tests and start contributing.
211
+
205
212
  Tests are based on the included templates, like the `hello world template` and on the installer.
206
213
 
214
+ Here I learned how to write tests! Testing installers is heavy, you will read about it in the
215
+ test_helpers. But I have done my best to give all the code a clear structure.
216
+ I hope you like it, and improvements are welcome.
217
+
207
218
  **Installer tests** starting with completely destroy the rails app within the `generated_test_app_path`,
208
219
  generating a new rails app and running the installer and test by `playwright` if the components are working.
209
220
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: svelte-on-rails
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.45
4
+ version: 1.0.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Christian Sedlmair