wassup 0.1.2 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0460f6c9734dcfa48fe6d0561d1de6d5c81d1d49a6f8f6e89cfe8dbb54bb78a
-  data.tar.gz: f017aea6ab05afe32a5c21ba470f4aa82400d08a54d666172596c27c9f74659c
+  metadata.gz: 2ba0effd144c52ef2122ea0437d58d6d3cbb784a6f2bbbb8d1e85da6771076e0
+  data.tar.gz: 50a155898f0edca3b6a9be0bb43df316f0477c69fe002a52b0e2a06b2eebb635
 SHA512:
-  metadata.gz: 0a4d4e533f3519c77053a5388a00ad584b84203ae18926e7a105a05a72bbe27b68fac844c22ec152baa394b1dcdf1aafc6ae30bbe1b51c80f6a415baf70540c0
-  data.tar.gz: 447c01199ef5ee734f9836d30d1ee7fe24fdf01d6652b7499d1c053f4903cfba6e63ee979b26122b44b3ef0ba4c213a2ae0f9dc196effe3537d5cf00a2ef9bb7
+  metadata.gz: fbd28897624210fa90cb987570b7aaefaeec74abbdcbb75ba42d0ccb984438ba156bb7d5c2d729a0af42b2ddab550e9c567d94ddc5b6676e5071b695ba48a54e
+  data.tar.gz: d7a714ace610668a6cd6338547a404ef6d9dd5e6ea3bfc68e9d341a87647a8af70330166262e315eb56a4786add5b95569100dbd5bc4a467622f021fd171fb46

data/.gitignore

@@ -10,4 +10,8 @@
 # rspec failure tracking
 .rspec_status
 
+*.gem
+
+.DS_Store
+
 *.swp

data/Gemfile.lock

@@ -1,15 +1,30 @@
 PATH
   remote: .
   specs:
-    wassup (0.1.0)
+    wassup (0.2.1)
       curses
+      rest-client
 
 GEM
   remote: https://rubygems.org/
   specs:
     curses (1.4.2)
     diff-lcs (1.4.4)
+    domain_name (0.5.20190701)
+      unf (>= 0.0.5, < 1.0.0)
+    http-accept (1.7.0)
+    http-cookie (1.0.4)
+      domain_name (~> 0.5)
+    mime-types (3.4.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2021.1115)
+    netrc (0.11.0)
     rake (12.3.3)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
     rspec (3.10.0)
       rspec-core (~> 3.10.0)
       rspec-expectations (~> 3.10.0)
@@ -23,6 +38,9 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.10.0)
     rspec-support (3.10.3)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.8)
 
 PLATFORMS
   arm64-darwin-21

data/README.md

@@ -1,9 +1,15 @@
-# Wassup
+<h3 align="center">
+  <img height="200" alt="Wassup logo" src="https://user-images.githubusercontent.com/401294/145626927-7eb0fda5-c62a-47c8-9422-074b178fd8ef.png" />
+</h3>
 
-A scriptable terminal dashboard
+[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/fastlane/blob/master/LICENSE)
+[![Gem](https://img.shields.io/gem/v/wassup.svg?style=flat)](https://rubygems.org/gems/wassup)
 
+**Wassup** is a scriptable terminal dashboard. Configure panes and content logic in a `Supfile` and then run `wassup`.
 
-https://user-images.githubusercontent.com/401294/144465499-a8903d4c-f003-4550-b47c-f70c17cc02d8.mov
+<hr/>
+
+https://user-images.githubusercontent.com/401294/145632767-d75a8244-b68f-4838-8ff4-4017ba0c1ed2.mov
 
 ## Example `Supfile`
 
@@ -11,25 +17,25 @@ https://user-images.githubusercontent.com/401294/144465499-a8903d4c-f003-4550-b4
 require 'json'
 require 'rest-client'
 
-add_pane do |pane|                                                                                                   
-  pane.height = 0.5                                                                                                  
-  pane.width = 00.5                                                                                                   
-  pane.top = 0                                                                                                   
+add_pane do |pane|
+  pane.height = 0.5
+  pane.width = 0.5
+  pane.top = 0
   pane.left = 0
 
   pane.highlight = true
   pane.title = "Open PRs - fastlane/fastlane"
 
   pane.interval = 60 * 5
-  pane.content do
+  pane.content do |builder|
     resp = RestClient.get "https://api.github.com/repos/fastlane/fastlane/pulls"
     json = JSON.parse(resp)
     json.map do |pr|
-      display = "##{pr["number"]} pr["title"]"
-      
-      # First element is displayed
-      # Second element is passed to pane.selection
-      [display, pr["html_url"]]   
+      display = "##{pr["number"]} #{pr["title"]}"
+
+      # First argument is displayed
+      # Second argument is passed to pane.selection
+      builder.add_row(display, pr["html_url"])
     end
   end
   pane.selection do |url|

data/bin/wassup

@@ -2,10 +2,15 @@
 
 require 'wassup'
 
+debug = ARGV.delete("--debug")
 path = ARGV[0] || 'Supfile'
 
 unless File.exists?(path)
   raise "Missing file: #{path}"
 end
 
-Wassup::App.start(path: path)
+if debug
+  Wassup::App.debug(path: path)
+else
+  Wassup::App.start(path: path)
+end

data/docs/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

data/docs/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ yarn
+```
+
+### Local Development
+
+```
+$ yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

data/docs/babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

data/docs/blog/2021-12-09-welcome/index.md

@@ -0,0 +1,8 @@
+---
+slug: welcome
+title: Welcome
+authors: [joshdholtz]
+tags: [wassup, hello]
+---
+
+This is the first blog

data/docs/blog/authors.yml

@@ -0,0 +1,5 @@
+joshdholtz:
+  name: Josh Holtz
+  title: Maintainer of wassup
+  url: https://github.com/joshdholtz
+  image_url: https://github.com/joshdholtz.png

data/docs/docs/Supfile-basics/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "Supfile - Basics",
+  "position": 2
+}

data/docs/docs/Supfile-basics/understanding-the-supfile.md

@@ -0,0 +1,50 @@
+---
+sidebar_position: 1
+---
+
+# Understanding the `Supfile`
+
+The `Supfile` is what **Wassup** uses to generate the dashboard.
+
+The dashboard is made up of **panes**. These **panes** are configured by the `Supfile`.
+
+```ruby title="Supfile"
+add_pane do |pane|
+  pane.height = 0.5
+  pane.width = 0.4
+  pane.top = 0
+  pane.left = 0
+
+  pane.title = "Current Time"
+
+  pane.highlight = false
+
+  pane.interval = 1
+  pane.content do |content|
+    date = `date`
+    content.add_row(date)
+  end
+end
+```
+
+## Properties
+
+### Positioning
+
+| Property | Type | Description |
+| --- | --- | --- |
+| height | Float | Height of the pane (value between 0 and 1) |
+| width | Float | Width of the pane (value between 0 and 1) |
+| top | Float | Top positioning of the pane (value between 0 and 1) |
+| left | Float | Left positioning of the pane (value between 0 and 1) |
+| title | String | Title to display in the top border of the pane |
+
+### Content
+
+| Property | Type | Description |
+| --- | --- | --- |
+| interval | Integer (or Float) | Interval (in seconds) on how often to refresh pane with the `content` block |
+| show_refresh | Boolean | Whether or not to show when a content refresh is happening |
+| highlight | Boolean | Whether or not to allow highlighting and selection of rows |
+| content | Block | A Ruby block for fetching and adding content to the pane |
+| selection | Block | A Ruby block for fetching and adding content to the pane |

data/docs/docs/intro.md

@@ -0,0 +1,54 @@
+---
+sidebar_position: 1
+---
+
+# Getting Started
+
+Get started by **installing the gem**.
+
+## Installing
+
+Install **Wassup** from RubyGems:
+
+```shell
+gem install wassup
+```
+
+Or in a `Gemfile`:
+
+```rb
+source "https://rubygems.org"
+
+gem "wassup"
+```
+
+## Create Your First `Supfile`
+
+Create a `Supfile` with the following contents:
+
+```ruby title="Supfile"
+add_pane do |pane|
+  pane.height = 0.5
+  pane.width = 0.4
+  pane.top = 0
+  pane.left = 0
+
+  pane.highlight = false
+  pane.title = "Current Time"
+
+  pane.interval = 1
+  pane.content do |content|
+    date = `date`
+
+    content.add_row(date)
+  end
+end
+```
+
+Run `wassup` (or `bundle exec wassup` if using a `Gemfile`) from your terminal in the same directory as your `Supfile`.
+
+### Screenshot
+
+You should see a pane in the top left corner that updates the time every second.
+
+![Tutorial intro starter screenshot](/img/tutorial-intro-starter-screenshot.png)

data/docs/docusaurus.config.js

@@ -0,0 +1,110 @@
+// @ts-check
+// Note: type annotations allow type checking and IDEs autocompletion
+
+const lightCodeTheme = require('prism-react-renderer/themes/github');
+const darkCodeTheme = require('prism-react-renderer/themes/dracula');
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+  title: 'Wassup',
+  tagline: 'Scriptable terminal dashboard',
+  url: 'https://wassup.tools',
+  baseUrl: '/',
+  onBrokenLinks: 'throw',
+  onBrokenMarkdownLinks: 'warn',
+  favicon: 'img/favicon.ico',
+  organizationName: 'joshdholtz', // Usually your GitHub org/user name.
+  projectName: 'wassup', // Usually your repo name.
+
+  presets: [
+    [
+      'classic',
+      /** @type {import('@docusaurus/preset-classic').Options} */
+      ({
+        docs: {
+          sidebarPath: require.resolve('./sidebars.js'),
+          // Please change this to your repo.
+          editUrl: 'https://github.com/facebook/docusaurus/edit/main/website/',
+        },
+        blog: {
+          showReadingTime: true,
+          // Please change this to your repo.
+          editUrl:
+            'https://github.com/facebook/docusaurus/edit/main/website/blog/',
+        },
+        theme: {
+          customCss: require.resolve('./src/css/custom.css'),
+        },
+      }),
+    ],
+  ],
+
+  themeConfig:
+    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+    ({
+      navbar: {
+        title: 'Wassup',
+        logo: {
+          alt: 'Wassup Logo',
+          src: 'img/logo.svg',
+        },
+        items: [
+          {
+            type: 'doc',
+            docId: 'intro',
+            position: 'left',
+            label: 'Tutorial',
+          },
+          {to: '/blog', label: 'Blog', position: 'left'},
+          {
+            href: 'https://github.com/joshdholtz/wassup',
+            label: 'GitHub',
+            position: 'right',
+          },
+        ],
+      },
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Docs',
+            items: [
+              {
+                label: 'Tutorial',
+                to: '/docs/intro',
+              },
+            ],
+          },
+          {
+            title: 'Community',
+            items: [
+              {
+                label: 'Twitter',
+                href: 'https://twitter.com/joshdholtz',
+              },
+            ],
+          },
+          {
+            title: 'More',
+            items: [
+              {
+                label: 'Blog',
+                to: '/blog',
+              },
+              {
+                label: 'GitHub',
+                href: 'https://github.com/joshdholtz/wassup',
+              },
+            ],
+          },
+        ],
+        copyright: `Copyright © ${new Date().getFullYear()} Josh Holtz. Built with Docusaurus.`,
+      },
+      prism: {
+        theme: lightCodeTheme,
+        darkTheme: darkCodeTheme,
+      },
+    }),
+};
+
+module.exports = config;