Skip to content

Commit 669d0a4

Browse files
committed
Bump text
1 parent 52b53bf commit 669d0a4

File tree

7 files changed

+20
-20
lines changed

7 files changed

+20
-20
lines changed

Diff for: _projects/jruby_art.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ keywords: 'propane, JRubyArt'
88

99
### Java
1010

11-
We strongly recommend you use [AdoptOpenJDK][adopt] binaries.
11+
If you run in to trouble use [AdoptOpenJDK][adopt] binaries, there eas once an issue with OpenGL with some JDKs but that seems to have been resolved.
1212

1313
### JRuby
1414

15-
With JRubyArt, there is the possibility of installing jruby-complete (using k9 --install), rather than install jruby on your system, you will need a vanilla ruby install and to configure `~/.jruby_art/config.yml` to run sketches. Otherwise install jruby (you do not need rvm or rbenv to this as jruby binary gets called directly).
15+
With JRubyArt, there was the possibility of installing jruby-complete (using k9 --install), rather than install jruby on your system, you will need a vanilla ruby install (but current MRI ruby may have compatability issues) and to configure `~/.jruby_art/config.yml` to run sketches. Otherwise install jruby (you do not need rvm or rbenv to this as jruby binary gets called directly).
1616

1717

1818
## Understanding A JRubyArt Sketch
@@ -79,7 +79,7 @@ module Processing
7979

8080
def draw
8181
# draw loop
82-
end
82+
end
8383
# end bare sketch ###########################################
8484
end
8585
Sketch.new
@@ -88,7 +88,7 @@ end
8888

8989
### class_sketch.rb
9090

91-
An explicitly class wrapped sketch can actually be run directly with `jruby`, but you should prefer [propane][propane] for that.
91+
An explicitly class wrapped sketch can actually be run directly with `jruby`, but you should prefer [propane][propane] or PiCrate for that.
9292

9393
```ruby
9494
# frozen_string_literal: false

Diff for: _projects/picrate.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,15 @@ keywords: picrate, JRubyArt
88

99
### Java ###
1010

11-
Unlike vanilla processing, we do not distribute a java environment with our projects. It is the expectation that you will use the default openjdk11 suplied with Buster on the RaspberryPI3B+ or RaspberryPI4.
11+
Unlike vanilla processing, we do not distribute a java environment with our projects. It is the expectation that you will use the default openjdk11 suplied with RaspberryPI OS or Manjarao ARM on the RaspberryPI3B+ or RaspberryPI4.
1212

1313
### JRuby ###
1414

15-
With picrate you need to install jruby on your system (you do not need `rvm` or `rbenv` to do this since you call the jruby binary directly).
15+
With picrate you need to install jruby on your system (you do not need `rvm` or `rbenv` to do this since you call the jruby binary directly). On Manjaro ARM you can use pacman to do this.
1616

1717
## Understanding A picrate Sketch ##
1818

19-
How you might write a picrate sketch, including the `shebang` makes it easier to run the sketch using `script` in the `atom` editor, but assumes you have jruby available at `/usr/bin/jruby` or more likely via symbolic link (yet another reason not to use `rvm` or `rbenv` since they futz with your environment).
19+
How you might write a picrate sketch, including the `shebang` which makes it easier to run the sketch using `script` in the `atom` editor, but assumes you have jruby available at `/usr/bin/jruby` or more likely via symbolic link (yet another reason not to use `rvm` or `rbenv` since they futz with your environment). However you will likely use geany or vim on your RaspberryPI (atom is not available).
2020

2121
### my_sketch.rb ###
2222

@@ -73,8 +73,8 @@ module Processing
7373

7474
def draw
7575
# draw loop
76-
end
77-
end
76+
end
77+
end
7878
end
7979

8080
# NB: If you use this explicit form need to use PiCrate::MyApp.new to run sketch

Diff for: _projects/propane.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ keywords: propane, propane
88

99
### Java ###
1010

11-
We recommend you use [AdoptOpenJDK][adopt] binaries.
11+
Most openjdks 11+ will now probably work. We recommend you try [AdoptOpenJDK][adopt] binaries if you run into problems.
1212

1313
### JRuby ###
1414

@@ -73,8 +73,8 @@ module Propane
7373

7474
def draw
7575
# draw loop
76-
end
77-
end
76+
end
77+
end
7878
end
7979

8080
# NB: If you use this explicit form need to use Propane::MyApp.new to run sketch

Diff for: _testing/testing.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,17 @@ title: "Testing"
55

66
### Continous Integration ###
77

8-
[travis ci][travis], we are all set up to go and this would actually work if only the current version of processing was available from maven central
8+
[travis ci][travis]
99

1010
### Platform Testing ###
1111

12-
* Currently only linux64 bit gets proper testing (Archlinux and Debian/Mint)
13-
* Must be working on macOS (volunteers required), I know there are users and no-one complains
14-
* Windows I can only guess (no-one complains)
12+
* Currently only linuxAMD64 bit gets proper testing (Archlinux and Debian/Mint) for JRubyArt art and propane
13+
* RaspberryPI OS and Manjaro ARM also get full testing
14+
* Volunteers are required for Windows and MacOS, thought he probably work (_at least no-one complains_)
1515

1616
### Testing code ###
1717

18-
In a sense every example sketch is a test, if the sketch runs (and they all have run at least once) then the tests are passing. In general sketches are not formally tested, but it would be no bad thing to create tests before [re-factoring][99]. There are _in the main_ tests written into ruby-processing projects, and we favor [minitest][minitest] over [rspec][rspec]. Note that if you are going to use rspec you should probably use `jruby -S rspec` to run your tests and include `require 'java'` in your specs. Static tests such as rubocop can also be useful, but you should be wary of some of the suggested changes to `working code`, there's some funky stuff hidden in JRubyArt code.
18+
In a sense every example sketch is a test, if the sketch runs (and they all have run at least once) then the tests are passing. In general sketches are not formally tested, but it would be no bad thing to create tests before [re-factoring][99]. There are _in the main_ tests written into ruby-processing projects, and we favor [minitest][minitest] over [rspec][rspec]. Note that if you are going to use rspec you should probably use `jruby -S rspec` to run your tests and include `require 'java'` in your specs. Static tests such as rubocop can also be useful, but you should be wary of following all the suggested changes to `working code`, there's some funky stuff hidden in JRubyArt code.
1919

2020
[99]:http://www.sandimetz.com/99bottles/
2121
[minitest]:https://github.com/seattlerb/minitest/

Diff for: _welcome/welcome.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ layout: post
33
title: "The Ruby-Processing Group Site"
44
---
55

6-
This site is the home of the ruby-processing group, which exists to collect together projects that have evolved from the original [ruby-processing][ruby-processing] see about. New members are always welcome, but preferably leave any opinionated frameworks behind, this is emphatically not a __rails project__, and does not require __bundler__, __rvm__ or __rbenv__, use these tools (crutches) locally if you must (but don't blame me when they screw up, __as well they might__, just take a look at the screwy travis-ci stack traces of any build using jruby). At the simplest level there is always scope for developing spiffy new examples (ruby), but the recently created atom projects could also use some love (javascript / cson), where the possibilities far exceed my limited abilities. To develop [JRubyArt][jruby_art] or [propane][propane] a knowledge of java and polyglot maven builds would come in handy. Knowledge of current javascript (since coffeescript is slipping out of favor) would be handy to improve [atom-k9][atom-k9] and [language-jruby-art][language-jruby-art], atom is fast becoming the editor of choice for JRubyArt, propane etc. In general unit testing (minitest/JUnit) is preferred to rspec etc.
6+
This site is the home of the ruby-processing group, which exists to collect together projects that have evolved from the original [ruby-processing][ruby-processing] see about. New members are always welcome, but preferably leave any opinionated frameworks behind, this is emphatically not a __rails project__, and does not require __bundler__, __rvm__ or __rbenv__, use these tools (crutches) locally if you must (but don't blame me when they screw up, __as well they might__, just take a look at the screwy travis-ci stack traces of any build using jruby). At the simplest level there is always scope for developing spiffy new examples (ruby), but the recently created atom projects could also use some love (javascript / cson), where the possibilities far exceed my limited abilities. To develop [JRubyArt][jruby_art] or [propane][propane] a knowledge of java and polyglot maven builds would come in handy. Knowledge of current javascript (since coffeescript is slipping out of favor) would be handy to improve [atom-k9][atom-k9] and [language-jruby-art][language-jruby-art], atom is the editor of choice for JRubyArt, propane etc. In general unit testing (minitest/JUnit) is preferred to rspec etc.
77

88
[ruby-processing]:https://github.com/jashkenas/ruby-processing
99
[jruby_art]: https://ruby-processing.github.io/index.html

Diff for: about.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ There are three main projects [JRubyArt][jruby_art], [PiCrate][picrate] and [pro
1414

1515
[Propane][propane] is a configuration free, complete version of ruby-processing (_does not require installed vanilla processing_) that depends on an installed jruby (_is slightly more experimental however since a modified PApplet is required with jdk9+ propane may take over in future_). Since propane-3.2.0, propane is compiled with jdk11, and thus jdk11 is a requirement.
1616

17-
[PiCrate][picrate] is a standalone version targetting the [RaspberryPI][rpi], but it can be developed and run 64 bit linux.
17+
[PiCrate][picrate] is a standalone version targetting the [RaspberryPI][rpi], but it can be developed and run 64 bit linux, tested with Raspberry OS (32 bit) and Manajaro Arm (64 bit). Needs at least RaspberryPI3B+, currently works best on RaspberryPI4. Suggested ide geany.
1818

1919
Other projects include the pbox2d gem (a gem wrapper around [jbox2d]), toxiclibs gem (a gem wrapper around [toxiclibs]) and geomerative gem (a gem wrapper around [geomerative]).
2020

Diff for: gems.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ title: "Gems"
66
RubyGems is a package manager for the Ruby programming language that provides a standard format for distributing Ruby programs and [libraries][libraries] (in a self-contained format called a "gem"), a tool designed to easily manage the installation of gems, and a server for distributing them. In the main you can use most of these gems in ruby-processing projects, though some built with native extensions may not be usable with jruby, there are usually good and sometimes better java alternatives (including [gems built for jruby][jgem]). But there's more there are [gems][gems] that have been build exclusively for use with jruby-projects, that make it even easier to use processing libraries in JRubyArt and propane. There are gems to help with maven builds, publish web-pages (_jekyll and its github flavors_) that are used to bring you this content etc.
77

88
#### Building a gem for use with JRubyArt / Propane ####
9-
The [arcball.gem][arcball] for propane, is a reasonable template for producing your own standalone processing library, that can be installed as a gem. You may also found my [guide to creating jruby-extensions][extensions] useful if you wish to stick to the 'jruby-extension convention' (my extensions and those created by jruby guys are sublety different we use `implements Library`, whereas proposed convention is to use `implements BasicLibraryService`). You could also look at other [gems built for jruby][jgem], which include more advanced features, there is no requirement to stick to convention, since both forms are likely to continue to be supported.
9+
The [arcball.gem][arcball] for propane and PiCrate, is a reasonable template for producing your own standalone processing library, that can be installed as a gem. You may also found my [guide to creating jruby-extensions][extensions] useful if you wish to stick to the 'jruby-extension convention' (my extensions and those created by jruby guys are sublety different we use `implements Library`, whereas proposed convention is to use `implements BasicLibraryService`). You could also look at other [gems built for jruby][jgem], which include more advanced features, there is no requirement to stick to convention, since both forms are likely to continue to be supported.
1010

1111
[extensions]:https://github.com/jruby/jruby-examples
1212
[arcball]:https://github.com/ruby-processing/ArcBall

0 commit comments

Comments
 (0)