pakyow 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0196fc05cda2ed329d3043ad7b5541a386da93cc
-  data.tar.gz: 22c0fa93bc38ce6de66aeb8a20a9346b2225e012
+  metadata.gz: 0ef3516f5955639e910668c039ccc52302453426
+  data.tar.gz: 87dec5942d0b34f6109dd2f8e4f5452ae21ce27e
 SHA512:
-  metadata.gz: 5322b06c42a16e68e59fa3d3fb782770b20fc2b02c2ad58afa698100d4bdf2e2291636622ff43ad4c6041b8abd03dcea74a932236f3bbc39ba045fa1c37572ff
-  data.tar.gz: 733e3f692fccf51b93cfc15c80571fb3772c12a1b12a2c705b9f0cc473af89211035a364b9e81404e0d860fb4aaec2d7fb884708222c8ecdf4dac4cc4bab46d5
+  metadata.gz: 11e159d2d315517b53f3ad49725d04e2f7608123439443c48f63e4168beeeb1ac795015327cf72eb0587de3d4cfa1132d9b780053433e76afef85ae5fd11a926
+  data.tar.gz: cbaa7ae39e057a0d3a89d75b9636b695635208984a8dccfa5bd3ddac7f2612d03b5d7d2a91efd56626e180ba06be5cf173bb1693f566afb6a4f4b4282aeb1b18

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 0.10.0 (to be released)
+
+  * Rename `app.rb` to `setup/app.rb`
+  * Adds Pakyow icons to generated app
+  * Adds Ring to generated app
+  * Updates Pakyow CSS in generated app
+  * Adds session middleware to generated app

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011-2015 Bryan Powell
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,86 @@
+[gem]: https://rubygems.org/gems/pakyow
+[travis]: https://travis-ci.org/pakyow/pakyow
+[gemnasium]: https://gemnasium.com/pakyow/pakyow
+
+# Pakyow Framework [![Gitter chat](https://badges.gitter.im/pakyow/chat.svg)](https://gitter.im/pakyow/chat)
+
+Pakyow is a framework for building modern websites and web apps. Views update in
+realtime to stay in sync with backend state. This is done using a traditional,
+backend-driven architecture, which means business logic is written once and
+stays on the server (write no JavaScript).
+
+Pakyow is also designed with progressive enhancement in mind. Because views are
+rendered on the server, they remain accessible to users who happen to be using
+unsupported browsers. The realtime layer is simply disabled, while all content
+continues to remain accessible.
+
+There are three core concepts you should be familiar with:
+
+**View-First Development**
+
+View-First Development is a process that enables the presentation layer of a
+website or web app to be built completely separate from the backend code. Read
+more:
+
+- http://pakyow.org/docs/presentation
+
+**Simple State Propagation**
+
+Simple State Propagation is the mechanism through which Pakyow propagates
+changes in state from one client to another. It prioritizes user trust and makes
+it easier to reason about your program. Read more:
+
+- http://pakyow.org/docs/concepts/simple-state-propagation
+
+**View Transformation Protocol**
+
+The View Transformation Protocol is a way to represent view rendering as a set
+of instructions that can later be applied to the view template. Pakyow
+implements this protocol on the backend for initial rendering and in
+[Ring](https://github.com/pakyow/ring) for client-side rendering. Read more:
+
+- http://pakyow.org/docs/concepts/view-transformation-protocol
+
+---
+
+[![Gem Version](https://badge.fury.io/rb/pakyow.svg)][gem]
+[![Build Status](https://travis-ci.org/pakyow/pakyow.svg?branch=master)][travis]
+[![Dependency Status](https://gemnasium.com/pakyow/pakyow.svg)][gemnasium]
+
+---
+
+# Getting Started
+
+1. Install Pakyow:
+
+    `gem install pakyow`
+
+2. Create a new Pakyow project from the command line:
+
+    `pakyow new webapp`
+
+3. Move to the new directory and start the server:
+
+    `cd webapp; pakyow server`
+
+4. You'll find your project running at [http://localhost:3000](http://localhost:3000)!
+
+# Next Steps
+
+The following resources might be handy:
+
+- [Website](http://pakyow.org)
+- [Docs](http://pakyow.org/docs)
+- [Code](http://github.com/pakyow/pakyow)
+
+Want to keep up with the latest development? Follow along:
+
+- [Blog](http://pakyow.org/blog)
+- [Forums](http://forums.pakyow.org)
+- [Gitter](https://gitter.im/pakyow/chat)
+- [Twitter](http://twitter.com/pakyow)
+
+# License
+
+Pakyow is released free and open-source under the [MIT
+License](http://opensource.org/licenses/MIT).

data/lib/commands/console.rb

@@ -3,7 +3,7 @@ if ARGV.first == '--help' || ARGV.first == '-h'
 else
   $:.unshift(Dir.pwd)
 
-  require 'app'
+  require 'app/setup'
   Pakyow::App.stage(ARGV.first)
 
   def reload

data/lib/commands/server.rb

@@ -3,7 +3,7 @@ if ARGV.first == '--help' || ARGV.first == '-h'
 else
   $:.unshift(Dir.pwd)
 
-  require 'app'
+  require 'app/setup'
 
   valid_args = true
   if port_arg = ARGV.index("-p")

data/lib/generators/pakyow/app/templates/Gemfile

@@ -1,8 +1,17 @@
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
-gem "pakyow", "0.9.1"
+# live on the edge and uncomment this line
+# gem 'pakyow', github: 'pakyow/pakyow'
 
-# application server
-gem "puma"
+# use the latest released version
+gem 'pakyow', '0.10'
+
+# app server
+gem 'puma', platforms: :ruby
+gem 'thin', platforms: :mswin
+
+group :test do
+  gem 'rspec'
+end
 
 # your gems here

data/lib/generators/pakyow/app/templates/README.md

@@ -1,14 +1,14 @@
-This is a Pakyow v0.9 app.
+This is a Pakyow v0.10 project.
 
 # Getting Started
 
-Start the app server:
+Start the server:
 
   `pakyow server`
 
 You'll find your app running at [http://localhost:3000](http://localhost:3000)!
 
-Need to interact with your app? Fire up a console:
+Need to interact with your code? Fire up a console:
 
   `pakyow console`
 
@@ -16,13 +16,13 @@ Need to interact with your app? Fire up a console:
 
 The following resources might be handy:
 
-- [Website](http://pakyow.com)
-- [Warmup](http://pakyow.com/warmup)
-- [Docs](http://pakyow.com/docs)
-- [Code](http://github.com/metabahn/pakyow)
+- [Website](http://pakyow.org)
+- [Docs](http://pakyow.org/docs)
+- [Code](http://github.com/pakyow/pakyow)
 
 Want to keep up with the latest development? Follow along:
 
-- [Blog](http://pakyow.com/blog)
-- [Mailing List](http://groups.google.com/group/pakyow)
+- [Blog](http://pakyow.org/blog)
+- [Forums](http://forums.pakyow.org)
+- [Gitter](https://gitter.im/pakyow/chat)
 - [Twitter](http://twitter.com/pakyow)

data/lib/generators/pakyow/app/templates/app/lib/routes.rb

@@ -1,8 +1,7 @@
 Pakyow::App.routes do
-  # define your routes here
+  default do
+    logger.info 'hello'
+  end
 
-  # see something working by uncommenting the line below
-  # default do
-  #   puts 'hello'
-  # end
+  # define application routes here
 end

data/lib/generators/pakyow/app/templates/{app.rb → app/setup.rb}

@@ -1,9 +1,10 @@
 require 'bundler/setup'
-
 require 'pakyow'
 
 Pakyow::App.define do
   configure :global do
+    Bundler.require :default, Pakyow::Config.env
+
     # put global config here and they'll be available across environments
     app.name = 'Pakyow'
   end
@@ -24,4 +25,9 @@ Pakyow::App.define do
   configure :production do
     # put your production config here
   end
+
+  middleware do |builder|
+    # TODO: you will most definitely want to change this secret
+    builder.use Rack::Session::Cookie, key: "#{Pakyow::Config.app.name}.session", secret: 'sekret'
+  end
 end

data/lib/generators/pakyow/app/templates/app/views/_templates/default.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>
+    Pakyow
+  </title>
+
+  <meta content="width=device-width, initial-scale=1.0, maximum-scale=1.0" name="viewport">
+
+  <link rel="stylesheet" type="text/css" href="/styles/pakyow-css/reset.css">
+  <link rel="stylesheet" type="text/css" href="/styles/pakyow-css/structure.css">
+  <link rel="stylesheet" type="text/css" href="/styles/pakyow-css/syntax.css">
+  <link rel="stylesheet" type="text/css" href="/styles/pakyow-css/theme.css">
+
+  <script src="/scripts/ring/pakyow.js"></script>
+</head>
+
+<body>
+  <main class="container-1">
+    <!-- @container -->
+  </main>
+
+  <footer class="container-1 margin-t">
+    <p>
+      Built with
+      <svg class="icon" width="10" height="10" viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path d="M896 1664q-26 0-44-18l-624-602q-10-8-27.5-26t-55.5-65.5-68-97.5-53.5-121-23.5-138q0-220 127-344t351-124q62 0 126.5 21.5t120 58 95.5 68.5 76 68q36-36 76-68t95.5-68.5 120-58 126.5-21.5q224 0 351 124t127 344q0 221-229 450l-623 600q-18 18-44 18z"></svg>
+      and <a href="http://pakyow.org">Pakyow</a>.
+    </p>
+  </footer>
+</body>
+</html>

data/lib/generators/pakyow/app/templates/app/views/index.html

@@ -0,0 +1,96 @@
+<h1>
+  Welcome to Pakyow :)
+</h1>
+
+<p class="lead margin-t">
+  The following links might be handy:
+</p>
+
+<ul>
+  <li>
+    <a href="http://pakyow.org/">Official Website</a>
+  </li>
+
+  <li>
+    <a href="http://pakyow.org/docs">Guides &amp; Documentation</a>
+  </li>
+
+  <li>
+    <a href="http://github.com/pakyow/pakyow">Source Code</a>
+  </li>
+</ul>
+
+<h3 class="margin-t">
+  Show Your Support
+</h3>
+
+<p>
+  Give us a star on <a href="http://github.com/pakyow">Github</a>. But don't
+  stop there &ndash; tell your friends about the project! Writing blog posts,
+  giving talks to local user groups, and screencasting your experiences with
+  Pakyow all help spread the word. We'll return the favor by helping promote
+  the things you create. Also consider adding a link back to pakyow.org from your
+  project.
+</p>
+
+<ul class="plain social-links inline margin-t">
+  <li>
+    <iframe src="https://ghbtns.com/github-btn.html?user=pakyow&repo=pakyow&type=star&count=true&v=2" frameborder="0" scrolling="0" width="85px" height="20px"></iframe>
+  </li>
+
+  <li>
+    <a href="https://twitter.com/pakyow" class="twitter-follow-button" data-show-count="false">Follow @pakyow</a>
+    <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
+  </li>
+
+  <li>
+    <div id="fb-root"></div>
+    <script>(function(d, s, id) {
+      var js, fjs = d.getElementsByTagName(s)[0];
+      if (d.getElementById(id)) return;
+      js = d.createElement(s); js.id = id;
+      js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.3&appId=1611480632444271";
+      fjs.parentNode.insertBefore(js, fjs);
+    }(document, 'script', 'facebook-jssdk'));</script>
+    <div class="fb-like" data-href="https://www.facebook.com/pakyow.rb" data-layout="button_count" data-action="like" data-show-faces="false" data-share="false"></div>
+  </li>
+
+  <li>
+    <!-- Place this tag in your head or just before your close body tag. -->
+    <script src="https://apis.google.com/js/platform.js" async defer></script>
+    <!-- Place this tag where you want the +1 button to render. -->
+    <div class="g-plusone" data-size="medium" data-href="http://pakyow.org"></div>
+  </li>
+</ul>
+
+<div style="clear:both"></div>
+
+<h3 class="margin-t">
+  Join the Conversation
+</h3>
+
+<p>
+  Come hang out on our <a href="https://gitter.im/pakyow/chat">Gitter channel</a>,
+  which took the place of our IRC channel in 2015. You should also join the
+  <a href="http://forums.pakyow.org">forums</a>, where early discussions about new Pakyow features often take place.
+  Don't forget to lend a hand &ndash; ask and answer <a href="http://stackoverflow.com/questions/tagged/pakyow">questions on Stack Overflow</a>.
+</p>
+
+<h3 class="margin-t">
+  Contribute to the Project
+</h3>
+
+<p>
+  We'd love your contributions to Pakyow code or documentation. Everything is hosted publicly on <a href="http://github.com/pakyow">Github</a>.
+  Looking through the list of open issues would be a great place to start. If you need more direction, jump on
+  one of the communication channels listed above; we're happy to help!
+</p>
+
+<h3 class="margin-t">
+  Report Problems you Encounter
+</h3>
+
+<p>
+  Found a bug or have an idea for a new feature?
+  Open up an issue on our <a href="https://github.com/pakyow/pakyow/issues">Github issues page</a>.
+</p>

data/lib/generators/pakyow/app/templates/config.ru

@@ -1,4 +1,4 @@
-require File.expand_path('../app', __FILE__)
+require File.expand_path('../app/setup', __FILE__)
 
 app = Pakyow::App
 app.builder.run(app.stage(ENV['APP_ENV'] || ENV['RACK_ENV']))

data/{MIT-LICENSE → lib/generators/pakyow/app/templates/public/scripts/ring/LICENSE}

@@ -1,4 +1,4 @@
-Copyright (c) 2011 Bryan Powell
+Copyright (c) 2015 Bryan Powell
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -17,4 +17,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/generators/pakyow/app/templates/public/scripts/ring/components/fastlink.js

@@ -0,0 +1,13 @@
+pw.component.register('fastlink', function (view, config) {
+  var that = this;
+
+  if (window.history) {
+    view.node.addEventListener('click', function (evt) {
+      evt.preventDefault();
+      window.history.pushState({ uri: this.href }, this.href, this.href);
+      return false;
+    });
+  } else {
+    // unsupported
+  }
+});

data/lib/generators/pakyow/app/templates/public/scripts/ring/components/fastlink.min.js

@@ -0,0 +1 @@
+pw.component.register("fastlink",function(t,e){window.history&&t.node.addEventListener("click",function(t){return t.preventDefault(),window.history.pushState({uri:this.href},this.href,this.href),!1})});

data/lib/generators/pakyow/app/templates/public/scripts/ring/components/loader.js

@@ -0,0 +1,9 @@
+pw.component.register('loader', function (view) {
+  this.listen('socket:loading', function () {
+    view.node.classList.add('ui-show');
+  });
+
+  this.listen('socket:loaded', function () {
+    view.node.classList.remove('ui-show');
+  });
+});

data/lib/generators/pakyow/app/templates/public/scripts/ring/components/loader.min.js

@@ -0,0 +1 @@
+pw.component.register("loader",function(o){this.listen("socket:loading",function(){o.node.classList.add("ui-show")}),this.listen("socket:loaded",function(){o.node.classList.remove("ui-show")})});

data/lib/generators/pakyow/app/templates/public/scripts/ring/components/modal.js

@@ -0,0 +1,78 @@
+pw.component.register('modal', function (view, config, name, id) {
+  var self = this;
+  var channel = 'modal:' + id;
+  var blinder;
+  var modal;
+
+  this.listen(channel + ':navigator:enter', function (response) {
+    if (!blinder) {
+      blinder = document.createElement('DIV');
+      blinder.classList.add('ui-modal-blinder');
+
+      modal = document.createElement('DIV');
+      modal.classList.add('ui-modal');
+
+      blinder.appendChild(modal);
+      document.body.appendChild(blinder);
+
+      blinder.addEventListener('click', function (evt) {
+        if (evt.target === blinder) {
+          evt.preventDefault();
+          self.close();
+
+          var uri = window.location.pathname;
+
+          var opts = {
+            uri: uri
+          };
+
+          window.history.pushState(opts, uri, uri);
+        }
+      });
+    }
+
+    modal.innerHTML = response.body;
+    pw.component.findAndInit(blinder);
+
+    blinder.classList.add('ui-appear');
+  });
+
+  this.listen(channel + ':navigator:exit', function () {
+    console.log('exit');
+    self.close();
+  });
+
+  this.listen(channel + ':navigator:boot', function (uri) {
+    self.load(uri);
+  });
+
+  view.node.addEventListener('click', function (evt) {
+    evt.preventDefault();
+    self.load(this.href);
+    return false;
+  });
+
+  this.load = function (uri) {
+    if (!window.socket) {
+      document.location = uri;
+      return;
+    }
+
+    var opts = {
+      uri: uri,
+      context: 'modal:' + id
+    }
+
+    if (config.container) {
+      opts.container = config.container;
+    }
+
+    window.history.pushState(opts, uri, uri);
+  };
+
+  this.close = function () {
+    pw.node.remove(blinder);
+    blinder = null;
+    modal = null;
+  };
+});