Browse Source

RSwitch 1.5.0

tags/v1.5.0
boB Rudis 6 months ago
parent
commit
c99071a477
No known key found for this signature in database GPG Key ID: 1D7529BE14E2BBA9
22 changed files with 48 additions and 20 deletions
  1. +2
    -2
      RSwitch.xcodeproj/project.pbxproj
  2. +19
    -7
      guide/_site/index.html
  3. BIN
      guide/_site/menu-info.png
  4. BIN
      guide/_site/rswitch-1.5.0-main.png
  5. BIN
      guide/_site/rswitch-1.5.0-prefs.png
  6. BIN
      guide/_site/rswitch-1.5.0-resources-reorg.png
  7. BIN
      guide/_site/rswitch-1.5.0-rstudio-example.png
  8. BIN
      guide/_site/rswitch-1.5.0-rstudio-server-new.png
  9. BIN
      guide/_site/rswitch-1.5.0-rstudio-server.png
  10. BIN
      guide/_site/rswitch-1.5.0-switch-to.png
  11. +1
    -1
      guide/acknowledgements.Rmd
  12. +26
    -10
      guide/index.Rmd
  13. BIN
      guide/menu-info.png
  14. BIN
      guide/rswitch-1.5.0-main.png
  15. BIN
      guide/rswitch-1.5.0-prefs.png
  16. BIN
      guide/rswitch-1.5.0-resources-reorg.png
  17. BIN
      guide/rswitch-1.5.0-rstudio-example.png
  18. BIN
      guide/rswitch-1.5.0-rstudio-server-new.png
  19. BIN
      guide/rswitch-1.5.0-rstudio-server.png
  20. BIN
      guide/rswitch-1.5.0-switch-to.png
  21. BIN
      releases/RSwitch-1.5.0.app.zip
  22. BIN
      rswitch-menu-example.png

+ 2
- 2
RSwitch.xcodeproj/project.pbxproj View File

@@ -561,7 +561,7 @@
MARKETING_VERSION = 1.5.0;
PRODUCT_BUNDLE_IDENTIFIER = is.rud.bob.RSwitch;
PRODUCT_NAME = "$(TARGET_NAME)";
PROVISIONING_PROFILE_SPECIFIER = "";
PROVISIONING_PROFILE_SPECIFIER = "rswitch-1+";
SWIFT_OBJC_BRIDGING_HEADER = "RSwitch/ObjC/RSwitch-Bridging-Header.h";
SWIFT_OPTIMIZATION_LEVEL = "-O";
SWIFT_VERSION = 5.0;
@@ -594,7 +594,7 @@
MARKETING_VERSION = 1.5.0;
PRODUCT_BUNDLE_IDENTIFIER = is.rud.bob.RSwitch;
PRODUCT_NAME = "$(TARGET_NAME)";
PROVISIONING_PROFILE_SPECIFIER = "";
PROVISIONING_PROFILE_SPECIFIER = "rswitch-1+";
SWIFT_OBJC_BRIDGING_HEADER = "RSwitch/ObjC/RSwitch-Bridging-Header.h";
SWIFT_OPTIMIZATION_LEVEL = "-O";
SWIFT_VERSION = 5.0;


+ 19
- 7
guide/_site/index.html View File

@@ -484,28 +484,25 @@ div.tocify {
<p>RSwitch provides two handy menu item shortcuts to download either of those resources, but it expects you do <em>some</em> work to use them. When you select either of the “Download latest&amp;hellip” items some checks are performed (mostly to find the current version of the latest RStudio daily) and if it finds either the r-devel tarball or the exact same version of the RStudio disk image in the <code>~/Downloads</code> directory it will let you know you need to clean up after yourself first:</p>
<p><img src="r-devel-exists.png" /></p>
<p><img src="rstudio-exists.png" /></p>
<p>If RSwitch can download the requested resource it will do so in the background and grey out the selected item until the process is complete:</p>
<p><img src="rstudio-in-progress.png" /></p>
<p>When the process is complete (or errors) a notification will be sent:</p>
<p>If RSwitch can download the requested resource it will do so in the background and grey out the selected item until the process is complete. When the process is complete (or errors) a notification will be sent:</p>
<p><img src="rstudio-success.png" /></p>
<p>and the Finder will open up to <code>~/Downloads</code> with the target file selected.</p>
</div>
<div id="getting-help-or-resources-from-the-internet" class="section level2">
<h2>Getting Help or Resources from the Internet</h2>
<p>Since RSwitch is designed to help you work with R on macOS it seemed only fitting to provide some handy links to resources like the R for macOS page, the CRAN R page, RStudio dailies link, etc. They’re all available via the fairly obvious sub-menu:</p>
<p><img src="web-help.png" /></p>
<p><img src="rswitch-1.5.0-resources-reorg.png" /></p>
<p>and each item will open up in your default web browser. (File an issue if you’d like more links added)</p>
</div>
<div id="even-moar-switching" class="section level2">
<h2>Even Moar Switching</h2>
<p>Since the theme of RSwitch is, well, <em>switching</em> it, further, seemed only fitting to allow you to make any open RStudio or R GUI instance active from the app:</p>
<p><img src="app-switch.png" /></p>
<p><img src="rswitch-1.5.0-switch-to.png" /></p>
<p>The list is presented in app order (RStudio first since it’s super likely that’s what most macOS R folk are using) and then in app launch order (oldest on top). As shown, if RSwitch can detect what the open RStudio project or package is, that name gets added to the switching title.</p>
</div>
<div id="the-item-that-launched-a-thousand-instances" class="section level2">
<h2>The Item That Launched A Thousand Instances</h2>
<p>While being able to switch to running instances is fine, it would also be handy to be able to launch RStudio or R GUI from the menubar app. If none are currently running you can launch them with the obviously named menu items. If you hold down <code>&lt;Control&gt;</code> as you click on the RSwitch icon you’ll be given the opportunity to launch new, concurrent instances of either application:</p>
<p><img src="launch-new.png" /></p>
<p>While being able to switch to running instances is fine, it would also be handy to be able to launch RStudio or R GUI from the menubar app. If none are currently running you can launch them with the obviously named menu items. If you hold down <code>&lt;Control&gt;</code> as you click on the RSwitch icon you’ll be given the opportunity to launch new, concurrent instances of either application.</p>
</div>
<div id="speaking-of-current" class="section level2">
<h2>Speaking of Current</h2>
@@ -513,6 +510,21 @@ div.tocify {
<p><img src="latest.png" /></p>
<p>otherwise, a link will open in your default browser so you can download the latest version.</p>
</div>
<div id="beyond-the-desktop" class="section level2">
<h2>Beyond The Desktop</h2>
<p>Starting with version 1.5.0, RSwitch is now your control center for organizing and accessing RStudio Server instances:</p>
<p><img src="rswitch-1.5.0-rstudio-server.png" /></p>
<p>Creating a new connection is just a simple form:</p>
<p><img src="rswitch-1.5.0-rstudio-server-new.png" /></p>
<p>and you can then launch a task-specific browser for each instance you have defined:</p>
<p><img src="rswitch-1.5.0-rstudio-example.png" /></p>
<p>This allows you to keep RStudio Server work separate from your internet browsing, creating a more focused workspace that you never have to worry about accidentally closing. Window size &amp; position are preserved across launches, too.</p>
</div>
<div id="have-it-your-way" class="section level2">
<h2>Have It Your Way</h2>
<p>There’s a new minimal preferences system for showing/hiding the dock icon and for enabling background checks for and notifications when new RStudio Dailies are available:</p>
<p><img src="rswitch-1.5.0-prefs.png" /></p>
</div>
<div id="always-on" class="section level2">
<h2>Always On</h2>
<p>If you like RSwitch enough to keep it running all the time, just drag the item to the “Login Items” table of your user in the “Users &amp; Groups” pane of “System Preferences”</p>


BIN
guide/_site/menu-info.png View File

Before After
Width: 1898  |  Height: 778  |  Size: 252KB Width: 1972  |  Height: 946  |  Size: 283KB

BIN
guide/_site/rswitch-1.5.0-main.png View File

Before After
Width: 658  |  Height: 946  |  Size: 175KB

BIN
guide/_site/rswitch-1.5.0-prefs.png View File

Before After
Width: 855  |  Height: 587  |  Size: 355KB

BIN
guide/_site/rswitch-1.5.0-resources-reorg.png View File

Before After
Width: 1068  |  Height: 713  |  Size: 690KB

BIN
guide/_site/rswitch-1.5.0-rstudio-example.png View File

Before After
Width: 1901  |  Height: 1188  |  Size: 528KB

BIN
guide/_site/rswitch-1.5.0-rstudio-server-new.png View File

Before After
Width: 638  |  Height: 203  |  Size: 42KB

BIN
guide/_site/rswitch-1.5.0-rstudio-server.png View File

Before After
Width: 758  |  Height: 598  |  Size: 376KB

BIN
guide/_site/rswitch-1.5.0-switch-to.png View File

Before After
Width: 647  |  Height: 601  |  Size: 345KB

+ 1
- 1
guide/acknowledgements.Rmd View File

@@ -8,7 +8,7 @@ Despite having found and old-old copy of the source code by hacking URLs via the

RSwitch uses three external frameworks to accomplish its tasks:

- [SwiftSoup](https://github.com/scinfu/SwiftSoup) by Nabil Chatbi
- [Just](https://github.com/dduan/Just) by Daniel Duan
- [ProcInfo](https://github.com/objective-see/ProcInfo) by the infamous Patrick Wardle
- [VersionCompare](https://github.com/DragonCherry/VersionCompare/) by DragonCherry



+ 26
- 10
guide/index.Rmd View File

@@ -91,11 +91,7 @@ RSwitch provides two handy menu item shortcuts to download either of those resou

![](rstudio-exists.png)

If RSwitch can download the requested resource it will do so in the background and grey out the selected item until the process is complete:

![](rstudio-in-progress.png)

When the process is complete (or errors) a notification will be sent:
If RSwitch can download the requested resource it will do so in the background and grey out the selected item until the process is complete. When the process is complete (or errors) a notification will be sent:

![](rstudio-success.png)

@@ -105,7 +101,7 @@ and the Finder will open up to `~/Downloads` with the target file selected.

Since RSwitch is designed to help you work with R on macOS it seemed only fitting to provide some handy links to resources like the R for macOS page, the CRAN R page, RStudio dailies link, etc. They're all available via the fairly obvious sub-menu:

![](web-help.png)
![](rswitch-1.5.0-resources-reorg.png)

and each item will open up in your default web browser. (File an issue if you'd like more links added)

@@ -113,15 +109,13 @@ and each item will open up in your default web browser. (File an issue if you'd

Since the theme of RSwitch is, well, _switching_ it, further, seemed only fitting to allow you to make any open RStudio or R GUI instance active from the app:

![](app-switch.png)
![](rswitch-1.5.0-switch-to.png)

The list is presented in app order (RStudio first since it's super likely that's what most macOS R folk are using) and then in app launch order (oldest on top). As shown, if RSwitch can detect what the open RStudio project or package is, that name gets added to the switching title.

## The Item That Launched A Thousand Instances

While being able to switch to running instances is fine, it would also be handy to be able to launch RStudio or R GUI from the menubar app. If none are currently running you can launch them with the obviously named menu items. If you hold down `<Control>` as you click on the RSwitch icon you'll be given the opportunity to launch new, concurrent instances of either application:

![](launch-new.png)
While being able to switch to running instances is fine, it would also be handy to be able to launch RStudio or R GUI from the menubar app. If none are currently running you can launch them with the obviously named menu items. If you hold down `<Control>` as you click on the RSwitch icon you'll be given the opportunity to launch new, concurrent instances of either application.

## Speaking of Current

@@ -131,6 +125,28 @@ RSwitch is under active, heavy development. Even when the development cycle dies

otherwise, a link will open in your default browser so you can download the latest version.

## Beyond The Desktop

Starting with version 1.5.0, RSwitch is now your control center for organizing and accessing RStudio Server instances:

![](rswitch-1.5.0-rstudio-server.png)

Creating a new connection is just a simple form:

![](rswitch-1.5.0-rstudio-server-new.png)

and you can then launch a task-specific browser for each instance you have defined:

![](rswitch-1.5.0-rstudio-example.png)

This allows you to keep RStudio Server work separate from your internet browsing, creating a more focused workspace that you never have to worry about accidentally closing. Window size & position are preserved across launches, too.

## Have It Your Way

There's a new minimal preferences system for showing/hiding the dock icon and for enabling background checks for and notifications when new RStudio Dailies are available:

![](rswitch-1.5.0-prefs.png)

## Always On

If you like RSwitch enough to keep it running all the time, just drag the item to the "Login Items" table of your user in the "Users & Groups" pane of "System Preferences"


BIN
guide/menu-info.png View File

Before After
Width: 1898  |  Height: 778  |  Size: 252KB Width: 1972  |  Height: 946  |  Size: 283KB

BIN
guide/rswitch-1.5.0-main.png View File

Before After
Width: 658  |  Height: 946  |  Size: 175KB

BIN
guide/rswitch-1.5.0-prefs.png View File

Before After
Width: 855  |  Height: 587  |  Size: 355KB

BIN
guide/rswitch-1.5.0-resources-reorg.png View File

Before After
Width: 1068  |  Height: 713  |  Size: 690KB

BIN
guide/rswitch-1.5.0-rstudio-example.png View File

Before After
Width: 1901  |  Height: 1188  |  Size: 528KB

BIN
guide/rswitch-1.5.0-rstudio-server-new.png View File

Before After
Width: 638  |  Height: 203  |  Size: 42KB

BIN
guide/rswitch-1.5.0-rstudio-server.png View File

Before After
Width: 758  |  Height: 598  |  Size: 376KB

BIN
guide/rswitch-1.5.0-switch-to.png View File

Before After
Width: 647  |  Height: 601  |  Size: 345KB

BIN
releases/RSwitch-1.5.0.app.zip View File


BIN
rswitch-menu-example.png View File

Before After
Width: 1898  |  Height: 778  |  Size: 252KB Width: 1972  |  Height: 946  |  Size: 272KB

Loading…
Cancel
Save