bpm 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+tmp
+devbin
+.bundle
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,16 @@
+# A sample Gemfile
+source "http://rubygems.org"
+
+if ENV["SPADE_PATH"]
+  gem 'spade', :path => ENV["SPADE_PATH"]
+else
+  gem 'spade', :git => "git://github.com/sproutcore/spade-ruby"
+end
+
+if ENV["SPOCKETS_PATH"]
+  gem 'sprockets', :path => ENV["SPROCKETS_PATH"]
+else
+  gem 'sprockets', :git => "git://github.com/sstephenson/sprockets"
+end
+
+gemspec

data/README.md

@@ -0,0 +1,55 @@
+bpm - browser packager manager
+
+bpm is a system for managing resource dependencies for client-side browser 
+applications.  It is inspired by npm, but has better support for the unique 
+needs of browser applications including:
+ 
+  * Supports multiple module loaders (i.e. you can choose RequireJS, spade or 
+    even no loader at all)
+  * Handles non-JS assets such as CSS and images. (Support for SCSS/Sass 
+    coming soon)  
+  * Can autocompile other languages such as CoffeeScript.
+
+bpm also implements a basic build system that generates cache-optimized 
+assets.
+
+Finally, bpm is based on the rubygems library.  Although you don't need to 
+know any ruby to use bpm, this means that we also benefit from nearly 10 years
+of lessons learned to jump start bpm.
+
+# Workflow Quick Start
+
+Once you have bpm installed (see below), create a demo app like so:
+
+    bpm new my_app
+    cd my_app
+    
+Then add jquery as a dependency:
+
+    bpm add jquery
+    
+This will create a file called `assets/bpm_packages.js` which will include
+jquery.  You can then create an index.html and reference that js.  Everytime
+you add a dependency, it will be based into this JS file . 
+
+Note that there is also a CSS file at `assets/bpm_styles.css` - we do the same
+thing there.
+
+# Installing
+
+When we release, bpm will be available via PKG and MSI installers as well as via rubygems.  For now the best way to try bpm is to clone it from github and then:
+
+  `bundle install`
+  
+From the directory.  (If you don't have bundler, you will need ruby 1.9.2 installed and type `gem install bundler` to get it.)
+
+# Current Development Status
+
+Alpha.  You should be able to work the basic system, but some features are 
+still incomplete including:
+
+  * SASS and other CSS plugins
+  * Format plugins (i.e. CoffeeScript)
+  * Minification plugins
+  * lots of other stuff I am forgetting
+  * node support - you will eventually be able to run JS that doesn't require the DOM in node.  We've prototyped this but it needs to be polished still.

data/TODO.md

@@ -0,0 +1,3 @@
+
+* Better support for using plugins during builds.  Ideal solution would create a .js file for each plugin and load it in a separate context.  This would  allow each plugin to actually require other dependencies, etc.  This is required to properly support format plugins.
+

data/bin/bpm

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$:.unshift(lib) if File.exists?(lib)
+
+require 'bpm'
+
+BPM::CLI::Base.start
+

data/bpm.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+require 'bpm/version'
+
+Gem::Specification.new do |s|
+  s.name        = "bpm"
+  s.version     = BPM::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Charles Jolley", "Peter Wagenet"]
+  s.email       = ["charles@sproutcore.com", "peterw@strobecorp.com"]
+  s.homepage    = "http://github.com/strobecorp/spade"
+  s.summary = s.description = "Package Manager for JavaScript"
+
+  mswin = RbConfig::CONFIG["host_os"] =~ %r!(msdos|mswin|djgpp|mingw)!
+  mri = !mswin && (!defined?(RUBY_ENGINE) || RUBY_ENGINE == "ruby")
+
+  s.add_dependency "libgems",      "~> 0.0.2"
+  s.add_dependency "gemcutter",    "~> 0.6.1"
+  s.add_dependency "highline",     "~> 1.6.1"
+  s.add_dependency "json_pure",    "~> 1.4.6"
+  s.add_dependency "thor",         "~> 0.14.3"
+  s.add_dependency "sprockets"
+  s.add_dependency "spade"
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rack", "~> 1.2.1"
+
+  paths = `git submodule`.split("\n").map do |line|
+    path = line.gsub(/^ \w+ ([^\s]+) .+$/,'\1')
+    `cd #{path}; git ls-files`.split("\n").map { |p| File.join(path, p) }
+  end
+  paths << `git ls-files`.split("\n")
+  s.files      = paths.flatten
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+
+  s.executables        = ['bpm']
+  s.require_paths      = ["lib"]
+end
+

data/lib/bpm.rb

@@ -0,0 +1,18 @@
+module BPM
+  BPM_DIR = ".bpm"
+  TEMPLATES_DIR = File.expand_path("../../templates", __FILE__)
+
+  autoload :CLI,                  'bpm/cli'
+  autoload :Credentials,          'bpm/credentials'
+  autoload :Local,                'bpm/local'
+  autoload :Package,              'bpm/package'
+  autoload :Remote,               'bpm/remote'
+  autoload :Repository,           'bpm/repository'
+  autoload :Project,              'bpm/project'
+  autoload :Server,               'bpm/server'
+
+end
+
+require 'bpm/libgems_ext'
+require 'bpm/pipeline'
+

data/lib/bpm/cli.rb

@@ -0,0 +1,6 @@
+module BPM
+  module CLI
+    autoload :Base,             'bpm/cli/base'
+    autoload :Owner,            'bpm/cli/owner'
+  end
+end

data/lib/bpm/cli/base.rb

@@ -0,0 +1,358 @@
+require 'thor'
+require 'highline'
+
+module BPM
+  module CLI
+    LOGIN_MESSAGE = "Please login first with `bpm login`."
+
+    class Base < Thor
+
+      class_option :verbose, :type => :boolean, :default => false,
+        :aliases => ['-V'],
+        :desc => 'Show additional debug information while running'
+
+      desc "owner", "Manage users for a package"
+      subcommand "owner", BPM::CLI::Owner
+
+      desc "fetch [PACKAGE]", "Fetch one or many bpm packages to local cache"
+      method_option :version,    :type => :string,  :default => ">= 0", :aliases => ['-v'],    :desc => 'Specify a version to install'
+      method_option :prerelease, :type => :boolean, :default => false,  :aliases => ['--pre'], :desc => 'Install a prerelease version'
+      def fetch(*packages)
+        project = BPM::Project.nearest_project(Dir.pwd) if packages.empty?
+        if project
+          success = project.fetch_dependencies options[:verbose]
+          if !success
+            abort project.errors * "\n"
+          else
+            say "Fetched dependent packages for #{project.name}"
+          end
+
+        else
+          report_arity_error("fetch") and return if packages.size.zero?
+
+          begin
+            packages.each do |package|
+              installed = BPM::Remote.new.install(package, options[:version], options[:prerelease])
+              installed.each do |spec|
+                say "Successfully fetched #{spec.name} (#{spec.version})"
+              end
+            end
+          rescue LibGems::InstallError => e
+            abort "Fetch error: #{e}"
+          rescue LibGems::GemNotFoundException => e
+            abort "Can't find package #{e.name} #{e.version} available for fetch"
+          rescue Errno::EACCES, LibGems::FilePermissionError => e
+            abort e.message
+          end
+        end
+      end
+
+
+      desc "fetched [PACKAGE]", "Shows what bpm packages are fetched"
+      def fetched(*packages)
+        local = BPM::Local.new
+        index = local.installed(packages)
+        print_specs(packages, index)
+      end
+
+      desc "add [PACKAGE]", "Add package to project"
+      method_option :version,    :type => :string,  :default => ">= 0", :aliases => ['-v'],    :desc => 'Specify a version to install'
+      method_option :project,    :type => :string,  :default => nil, :aliases => ['-p'],    :desc => 'Specify project location other than working directory'
+      method_option :prerelease, :type => :boolean, :default => false,  :aliases => ['--pre'], :desc => 'Install a prerelease version'
+      def add(*package_names)
+
+        # map to dependencies
+        if package_names.size.zero?
+          abort "You must specify at least one package"
+        elsif package_names.size == 1
+          deps = {}
+          vers = options[:version]
+          vers = '>= 0-pre' if vers == '>= 0' && options[:prerelease]
+          deps[package_names.first] = vers
+        else
+          if options[:version] != '>= 0'
+            abort "You can only name one package with the version option"
+          end
+          
+          deps = {}
+          vers = options[:prerelease] ? '>= 0-pre' : '>= 0'
+          package_names.each { |name| deps[name] = vers }
+        end
+
+        # find project
+        project = find_project
+
+        begin
+          project.add_dependencies deps, true
+          project.build :debug, true
+        # rescue Exception => e
+        #   abort e.message
+        end
+      end
+
+      desc "remove [PACKAGE]", "Remove package from project"
+      method_option :project,    :type => :string,  :default => nil, :aliases => ['-p'],    :desc => 'Specify project location other than working directory'
+      def remove(*package_names)
+
+        # map to dependencies
+        if package_names.size.zero?
+          abort "You must specify at least one package"
+        end
+
+        begin
+          project = find_project
+          project.unbuild options[:verbose]
+          project.remove_dependencies package_names, true
+          project.build :debug, true
+          
+        rescue Exception => e
+          abort e.message
+        end
+      end
+
+      desc "autocompile", "Preview server that will autocompile assets.  Useful for hacking"
+      method_option :mode, :type => :string, :default => :debug, :aliases => ['-m'], :desc => 'Set build mode for compile (default debug)'
+      method_option :project,    :type => :string,  :default => nil, :aliases => ['-p'],    :desc => 'Specify project location other than working directory'
+      method_option :port,       :type => :string,  :default => '4020', :desc => "Port to host server on"
+      def autocompile
+        
+        project = find_project
+        puts project
+        BPM::Server.start project, :Port => options[:port]
+        
+      end
+      
+      desc "compile", "Build the bpm_package.js for development"
+      method_option :mode, :type => :string, :default => :debug, :aliases => ['-m'], :desc => 'Set build mode for compile (default debug)'
+      method_option :project,    :type => :string,  :default => nil, :aliases => ['-p'],    :desc => 'Specify project location other than working directory'
+      def compile
+        
+        begin
+          project = find_project
+          project.fetch_dependencies options[:verbose]
+          project.build options[:mode], options[:verbose]
+        rescue Exception => e
+          abort e.message
+        end
+      end
+      
+      desc "login", "Log in with your BPM credentials"
+      method_option :username,  :type => :string,  :default => nil, :aliases => ['-u'], :desc => 'Specify the username to login as'
+      method_option :password,  :type => :string,  :default => nil, :aliases => ['-p'], :desc => 'Specify the login password'
+      def login
+        email = options[:username]
+        password = options[:password]
+
+        unless email && password
+          highline = HighLine.new
+          say "Enter your BPM credentials."
+
+          begin
+            email ||= highline.ask "\nEmail:" do |q|
+              next unless STDIN.tty?
+              q.readline = true
+            end
+
+            password ||= highline.ask "\nPassword:" do |q|
+              next unless STDIN.tty?
+              q.echo = "*"
+            end
+          rescue Interrupt => ex
+            abort "Cancelled login."
+          end
+        end
+
+        say "\nLogging in as #{email}..."
+
+        if BPM::Remote.new.login(email, password)
+          say "Logged in!"
+        else
+          say "Incorrect email or password."
+          login unless options[:username] && options[:password]
+        end
+      end
+
+      desc "push", "Distribute your bpm package"
+      def push(package)
+        remote = BPM::Remote.new
+        if remote.logged_in?
+          say remote.push(package)
+        else
+          say LOGIN_MESSAGE
+        end
+      end
+
+      desc "yank", "Remove a specific package version release from SproutCutter"
+      method_option :version, :type => :string,  :default => nil,   :aliases => ['-v'],    :desc => 'Specify a version to yank'
+      method_option :undo,    :type => :boolean, :default => false,                        :desc => 'Unyank package'
+      def yank(package)
+        if options[:version]
+          remote = BPM::Remote.new
+          if remote.logged_in?
+            if options[:undo]
+              say remote.unyank(package, options[:version])
+            else
+              say remote.yank(package, options[:version])
+            end
+          else
+            say LOGIN_MESSAGE
+          end
+        else
+          say "Version required"
+        end
+      end
+
+      desc "list", "View available packages for download"
+      method_option :all,        :type => :boolean, :default => false, :aliases => ['-a'],    :desc => 'List all versions available'
+      method_option :prerelease, :type => :boolean, :default => false, :aliases => ['--pre'], :desc => 'List prerelease versions available'
+      def list(*packages)
+        remote = BPM::Remote.new
+        index  = remote.list_packages(packages, options[:all], options[:prerelease])
+        print_specs(packages, index)
+      end
+
+      desc "new [NAME]", "Generate a new project skeleton"
+      method_option :path, :type => :string, :default => nil, :desc => 'Specify a different name for the project'
+      method_option :package, :type => :string, :default => nil, :desc => 'Specify a package template to build from'
+      def new(name)
+        package = install_package(options[:package])
+        template_path = package ? package.template_path(:project) : nil
+
+        path = File.expand_path(options[:path] || underscore(name))
+        generator = get_generator(:project, package)
+        success = generator.new(self, name, path, template_path).run
+
+        run_init(name, path, package) if success
+      end
+
+      desc "init [PATHS]", "Configure a project to use bpm for management"
+      method_option :name, :type => :string, :default => nil, :desc => 'Specify a different name for the project'
+      method_option :skip, :type => :boolean, :default => false, :desc => 'Skip any conflicting files'
+      def init(*paths)
+        paths = [Dir.pwd] if paths.empty?
+        paths.map!{|p| File.expand_path(p) }
+
+        if paths.length > 1 && options[:name]
+          abort "Can't specify a name with multiple paths"
+        end
+
+        paths.each do |path|
+          run_init(options[:name] || File.basename(path), path)
+        end
+      end
+
+      desc "build [PACKAGE]", "Build a bpm package from a package.json"
+      method_option :email, :type => :string,  :default => nil,   :aliases => ['-e'],    :desc => 'Specify an author email address'
+      def build(package_path=nil)
+        package_path ||= Dir.pwd
+        local = BPM::Local.new
+        package = local.pack(File.join(package_path, "package.json"), options[:email])
+
+        if package.errors.empty?
+          puts "Successfully built package: #{package.to_ext}"
+        else
+          failure_message = "BPM encountered the following problems building your package:"
+          package.errors.each do |error|
+            failure_message << "\n* #{error}"
+          end
+          abort failure_message
+        end
+      end
+
+      desc "unpack [PACKAGE]", "Extract files from a bpm package"
+      method_option :target, :type => :string, :default => ".", :aliases => ['-t'], :desc => 'Unpack to given directory'
+      def unpack(*paths)
+        local = BPM::Local.new
+
+        paths.each do |path|
+          begin
+            package     = local.unpack(path, options[:target])
+            unpack_path = File.expand_path(File.join(Dir.pwd, options[:target], package.to_full_name))
+            puts "Unpacked package into: #{unpack_path}"
+          rescue Errno::EACCES, LibGems::FilePermissionError => ex
+            abort "There was a problem unpacking #{path}:\n#{ex.message}"
+          end
+        end
+      end
+
+      private
+
+        def get_generator(type, package=nil)
+          require 'bpm/generator'
+          generator_pkg = package ? package.name : :default
+          package ? package.generator_for(type) : BPM.generator_for(type)
+        end
+
+        def run_init(name, path, package=nil)
+          template_path = package ? package.template_path(:init) : nil
+
+          generator = get_generator(:init, package)
+          generator.new(self, name, path, package && template_path).run
+
+          project = BPM::Project.new(path, name)
+          project.fetch_dependencies true
+          project.build :debug, true
+        end
+
+        def report_arity_error(name)
+          self.class.handle_argument_error(self.class.tasks[name], nil)
+        end
+
+        def find_project
+          if options[:project]
+            project_path = File.expand_path options[:project]
+            if BPM::Project.is_project_root? project_path
+              abort "#{project_path} does not appear to be managed by bpm"
+            else
+              project = BPM::Project.new project_path
+            end
+          else
+            project = BPM::Project.nearest_project Dir.pwd
+            if project.nil?
+              abort "You do not appear to be inside of a bpm project"
+            end
+          end
+          
+          project
+        end
+        
+        def print_specs(names, index)
+          packages = {}
+
+          index.each do |(name, version, platform)|
+            packages[name] ||= []
+            packages[name] << version
+          end
+
+          if packages.size.zero?
+            abort %{No packages found matching "#{names.join('", "')}".}
+          else
+            packages.each do |name, versions|
+              puts "#{name} (#{versions.sort.reverse.join(", ")})"
+            end
+          end
+        end
+
+        def install_package(pkg_name)
+          return nil unless pkg_name
+          dep = LibGems::Dependency.new(pkg_name)
+          installed = LibGems.source_index.search(dep)
+          if installed.empty?
+            installed = BPM::Remote.new.install(pkg_name)
+          end
+          spec = installed.find{|p| p.name == pkg_name }
+          abort "Unable to find package: #{pkg_name}" unless spec
+          BPM::Package.from_spec(spec)
+        end
+
+        def underscore(str)
+          str.gsub(/::/, '/').
+            gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+            gsub(/([a-z\d])([A-Z])/,'\1_\2').
+            tr("-", "_").
+            downcase
+        end
+
+    end
+  end
+end