jsus 0.1.19 → 0.1.20

data/CHANGELOG

@@ -1,4 +1,15 @@
 = Jsus Changelog
+== Version 0.1.20
+* Better integration for murdoc (factored it into class Jsus::Documenter)
+* Tree structure for future reuse
+
+== Versions 0.1.11 to 0.1.19
+* Murloc Documentation experimental support (a bit dirty for now)
+* Verbose mode for command-line, showing some missing dependencies and redeclared
+  provides
+* Miscellanous changes and tweaks (was too lazy to write changelogs, sorry)
+
+
 == Version 0.1.10
 * Package.json files are now supported too (with the same format as yaml packages)
 

data/VERSION

@@ -1 +1 @@
-0.1.19
+0.1.20

data/bin/jsus

@@ -1,6 +1,12 @@
 #!/usr/bin/env ruby
 require 'rubygems'
-require 'jsus'
+begin
+  require 'jsus'
+rescue LoadError
+  $: << "./lib"
+  require "jsus"
+end
+
 require "fileutils"
 require 'choice'
 start_time = Time.now
@@ -54,7 +60,8 @@ Choice.options do
   option "docs_classes", :required => false do
     default []
     long "--generate-docs *CLASSES"
-    desc "Generate documentation for classes via murdoc, e.g.: lsd-* mootools-*"
+    desc "Generate documentation for classes via murdoc. You need to use FULL PATHS, e.g.: " <<
+         "/mootools/*, /LSD/*, /**/*"
 
   end
 
@@ -99,48 +106,11 @@ if Choice.choices[:generate_includes]
 end
 
 # Generate documentation
-unless Choice.choices[:docs_classes].empty?
-  require "murdoc"
-  documented_sources = Jsus::Container.new
-  sources = pool ? pool.sources : package.source_files
-  Choice.choices[:docs_classes].each do |expr|
-    regex = Regexp.new("^" + expr.gsub("*", ".*") + "$", Regexp::IGNORECASE)
-    sources.each {|s| documented_sources << s if s.provides.any? {|provided| provided.to_s =~ regex } }
-  end
-
-  doc_dir = Choice.choices[:output_directory] + "/docs"
-  FileUtils.mkdir_p(doc_dir)
-  template = File.dirname(__FILE__) + "/../markup/template.haml"
-  sources_index = {}
-  documented_sources.each do |source|
-    skipped_lines = 0
-    content = source.original_content.gsub(/\A\s*\/\*.*?\*\//m) {|w| skipped_lines += w.split("\n").size; "" } # deleting initial comment
-    annotator = Murdoc::Annotator.new(content, :javascript, :highlight_source => true)
-    header = source.header
-    sources_index[source.package.name] ||= []
-    source_dir = "#{doc_dir}/#{source.package.name}"
-    FileUtils.mkdir_p(source_dir)
-    File.open("#{source_dir}/#{File.basename(source.filename)}.html", "w+") do |f|
-      sources_index[source.package.name] << File.basename(source.filename)
-      f.puts Murdoc::Formatter.new(template).render(:paragraphs => annotator.paragraphs, :header => header, :source => source, :skipped_lines => skipped_lines)
-    end
-  end
-
-  FileUtils.cp(File.dirname(__FILE__) + "/../markup/stylesheet.css", doc_dir)
-
-  # building indices
-  sources_index.each do |pkg, sources_names|
-    source_dir = "#{doc_dir}/#{pkg}"
-    FileUtils.cp("#{doc_dir}/stylesheet.css", source_dir)
-    File.open("#{source_dir}/index.html", "w+") do |f|
-      f.puts Haml::Engine.new(File.read(File.dirname(__FILE__) + "/../markup/index.haml")).render(self, :package => pkg, :sources => sources_names)
-    end
-  end
-
-  # building main index of packages
-  File.open("#{doc_dir}/index.html", "w+") do |f|
-    f.puts Haml::Engine.new(File.read(File.dirname(__FILE__) + "/../markup/packages_index.haml")).render(self, :packages => sources_index.keys)
-  end
+unless Choice.choices[:docs_classes].empty?  
+  documenter = Jsus::Documenter.new
+  package.source_files.each {|source| documenter << source }
+  pool.sources.each {|source| documenter << source } if pool
+  documenter.only(Choice.choices[:docs_classes]).generate(Choice.choices[:output_directory] + "/docs")
 end
 
 

data/jsus.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{jsus}
-  s.version = "0.1.19"
+  s.version = "0.1.20"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Mark Abramov"]
@@ -35,13 +35,14 @@ Gem::Specification.new do |s|
     "jsus.gemspec",
     "lib/jsus.rb",
     "lib/jsus/container.rb",
+    "lib/jsus/documenter.rb",
     "lib/jsus/package.rb",
     "lib/jsus/packager.rb",
     "lib/jsus/pool.rb",
     "lib/jsus/source_file.rb",
     "lib/jsus/tag.rb",
-    "markup/index.haml",
-    "markup/packages_index.haml",
+    "lib/jsus/tree.rb",
+    "markup/index_template.haml",
     "markup/stylesheet.css",
     "markup/template.haml",
     "spec/data/Basic/README",
@@ -93,11 +94,13 @@ Gem::Specification.new do |s|
     "spec/data/bad_test_source_two.js",
     "spec/data/test_source_one.js",
     "spec/jsus/container_spec.rb",
+    "spec/jsus/documenter_spec.rb",
     "spec/jsus/package_spec.rb",
     "spec/jsus/packager_spec.rb",
     "spec/jsus/pool_spec.rb",
     "spec/jsus/source_file_spec.rb",
     "spec/jsus/tag_spec.rb",
+    "spec/jsus/tree_spec.rb",
     "spec/shared/class_stubs.rb",
     "spec/spec_helper.rb"
   ]
@@ -108,11 +111,13 @@ Gem::Specification.new do |s|
   s.summary = %q{Javascript packager and dependency resolver}
   s.test_files = [
     "spec/jsus/container_spec.rb",
+    "spec/jsus/documenter_spec.rb",
     "spec/jsus/package_spec.rb",
     "spec/jsus/packager_spec.rb",
     "spec/jsus/pool_spec.rb",
     "spec/jsus/source_file_spec.rb",
     "spec/jsus/tag_spec.rb",
+    "spec/jsus/tree_spec.rb",
     "spec/shared/class_stubs.rb",
     "spec/spec_helper.rb"
   ]

data/lib/jsus.rb

@@ -16,7 +16,8 @@ require 'jsus/tag'
 require 'jsus/container'
 require 'jsus/packager'
 require 'jsus/pool'
-
+require 'jsus/tree'
+require 'jsus/documenter'
 #
 # Jsus — a library for packaging up your source files.
 #

data/lib/jsus/documenter.rb

@@ -0,0 +1,96 @@
+module Jsus
+  class Documenter
+    def initialize
+      require "murdoc"
+    rescue LoadError
+      raise "You should install murdoc gem in order to produce documentation"
+    end
+
+    def generate(doc_dir = Dir.pwd)
+      #FileUtils.rm_rf(doc_dir)
+      FileUtils.mkdir_p(doc_dir)
+      template_path = File.dirname(__FILE__) + "/../../markup"
+      template = File.read("#{template_path}/template.haml")
+      index_template = File.read("#{template_path}/index_template.haml")
+      stylesheet_path = "#{template_path}/stylesheet.css"
+      documented_sources.traverse(true) do |node|
+        if node.value # leaf
+          dir = doc_dir + File.dirname(node.full_path)
+          FileUtils.mkdir_p(dir)
+          file_from_contents(dir + "/#{node.name}.html", create_documentation_for_source(node.value, template))
+        else
+          dir = doc_dir + node.full_path
+          FileUtils.mkdir_p(dir)
+          FileUtils.cp(stylesheet_path, dir)
+          file_from_contents(dir + "/index.html", create_index_for_node(node, index_template))
+        end
+      end
+    end
+
+    def create_documentation_for_source(source, template)
+      skipped_lines = 0
+      content = source.original_content.gsub(/\A\s*\/\*.*?\*\//m) {|w| skipped_lines += w.split("\n").size; "" }
+      annotator = Murdoc::Annotator.new(content, :javascript, :highlight_source => true)
+      Murdoc::Formatter.new(template).render(:paragraphs => annotator.paragraphs, :header => source.header, :source => source, :skipped_lines => skipped_lines)
+    end
+
+    def create_index_for_node(node, template)
+      Haml::Engine.new(template).render(self, :node => node)
+    end    
+
+    def <<(source)
+      filename = File.basename(source.filename)
+      if source.package
+        tree.insert("/#{source.package.name}/#{filename}", source)
+      else
+        tree.insert("/#{filename}", source)
+      end
+      self
+    end
+
+    def tree
+      @tree ||= Tree.new
+    end
+
+    def current_scope
+      @current_scope ||= default_scope
+    end
+
+    def default_scope
+      ["/**/*"]
+    end
+
+    def current_scope=(scope)
+      @current_scope = scope
+    end
+
+    # exclusive scope
+    def only(scope)
+      result = clone
+      result.current_scope = [scope].flatten
+      result
+    end
+
+    # additive scope
+    def or(scope)
+      result = clone
+      result.current_scope = current_scope + [scope].flatten
+      result
+    end
+
+    def documented_sources
+      @documented_sources ||= documented_sources!
+    end
+
+    def documented_sources!
+      doctree = Tree.new
+      current_scope.map {|pathspec| tree.glob(pathspec) }.flatten.each {|s| doctree.insert(s.full_path, s.value)}
+      doctree
+    end
+
+    protected
+    def file_from_contents(filename, contents)
+      File.open(filename, "w+") {|f| f << contents }
+    end
+  end
+end

data/lib/jsus/pool.rb

@@ -166,6 +166,42 @@ module Jsus
       Container.new(*result)
     end
 
+    #
+    # Returs a tree, containing all the sources
+    #
+    def source_tree
+      @source_tree ||= source_tree! 
+    end
+
+    def source_tree! # :nodoc:
+      tree = Tree.new
+      sources.each do |source|
+        if source.package
+          tree.insert("/" + source.package.name + "/" + File.basename(source.filename), source)
+        else
+          tree.insert("/" + File.basename(source.filename), source)
+        end
+      end
+      tree
+    end
+
+    #
+    # Returns a tree containing all the provides tags
+    #
+    def provides_tree
+      @provides_tree ||= provides_tree!
+    end
+
+    def provides_tree!
+      tree = Tree.new
+      sources.each do |source|
+        source.provides.each do |tag|
+          tree.insert("/" + tag.to_s, source)          
+        end
+      end
+      tree
+    end
+
     protected
 
     def provides_map # :nodoc:

data/lib/jsus/tree.rb

@@ -0,0 +1,118 @@
+module Jsus
+  class Tree
+    PATH_SEPARATOR = "/"
+
+    # Utility functions
+    def self.get_path_components(path)
+      raise "Path should start with root (got: #{path})" unless path && path[0,1] == PATH_SEPARATOR
+      path = path.dup
+      path[0,1] = ""
+      path.split(PATH_SEPARATOR)
+    end
+
+    def self.path_from_components(components)
+      "#{PATH_SEPARATOR}#{components.join(PATH_SEPARATOR)}"
+    end
+
+
+    class Node
+      attr_accessor :value
+      attr_accessor :parent
+      attr_accessor :path_components
+
+      def initialize(full_path, value = nil)
+        self.full_path = full_path
+        self.value = value
+      end
+
+      attr_reader :full_path
+      attr_reader :name
+      def full_path=(full_path)
+        @full_path = full_path
+        @path_components = Tree.get_path_components(full_path)
+        @name = @path_components[-1]
+      end
+
+      def children
+        @children ||= []
+      end
+
+      def find_child(name)
+        children.detect {|child| child.name == name }
+      end
+
+      def create_child(name, value = nil)
+        full_path = Tree.path_from_components(path_components + [name])
+        node = Node.new(full_path, value)
+        children << node
+        node.parent = self
+        node
+      end
+
+      def find_or_create_child(name, value = nil)
+        find_child(name) || create_child(name, value)
+      end
+
+      def find_children_matching(pathspec)
+        case pathspec
+          when "**"
+            [self] + children.select {|child| child.has_children? }
+          when /\*/
+            regexp = Regexp.new("^" + Regexp.escape(pathspec).gsub("\\*", ".*") + "$")
+            children.select {|child| !child.has_children? && child.name =~ regexp }
+          else
+            [find_child(pathspec)].compact
+        end
+      end
+
+      def has_children?
+        !children.empty?
+      end
+    end
+
+
+    def root
+      @root ||= Node.new("/", nil)
+    end
+
+    def [](path)
+      path_components = self.class.get_path_components(path)
+      path_components.inject(root) do |result, component|
+        if result
+          result.find_child(component)
+        end
+      end
+    end
+
+    def glob(pathspec)
+      self.class.get_path_components(pathspec).inject([root]) do |nodes, component|
+        nodes.map {|node| node.find_children_matching(component) }.flatten
+      end
+    end
+
+    def insert(full_path, value = nil)
+      node = create_all_nodes_if_needed(full_path)
+      node.value = value
+      node
+    end
+
+    def traverse(all_nodes = false)
+      node_list = [root]
+      while !node_list.empty?
+        node = node_list.shift
+        yield node if all_nodes || !node.has_children?
+        node.children.each {|child| node_list << child }
+      end
+    end
+
+
+
+    def create_all_nodes_if_needed(full_path)
+      self.class.get_path_components(full_path).inject(root) do |result, component|
+        result.find_or_create_child(component)
+      end
+    end
+
+  end
+
+end

data/markup/index_template.haml

@@ -0,0 +1,19 @@
+%html
+  %head
+    %title Documentation index for #{node.full_path}
+    %link{:rel => "stylesheet", :href => "stylesheet.css"}
+%body
+  - subdirectories = node.children.select {|s| s.has_children? }
+  - unless subdirectories.empty?
+    %h2 List of subdirectories for #{node.full_path}:
+    %ul
+      - subdirectories.each do |child|
+        %li
+          %a{:href => "#{child.name}/index.html"}= child.name
+  - files = node.children.select {|s| s.value }
+  - unless files.empty?
+    %h2 List of files for #{node.full_path}:
+    %ul
+      - files.each do |child|
+        %li
+          %a{:href => "#{child.name}.html"}= child.name

data/spec/jsus/documenter_spec.rb

@@ -0,0 +1,31 @@
+require "spec_helper"
+
+describe Jsus::Documenter do
+  subject { described_class.new }
+  let(:input_dir) { "#{File.dirname(__FILE__)}/../data/Basic/app/javascripts/Orwik" }
+  let(:pool) { Jsus::Pool.new(input_dir) }
+
+  describe "<<" do
+    it "should add source files to tree" do
+      pool.sources.each {|s| subject << s}
+      subject.tree["/Orwik/Color.js"].value.should be_a(Jsus::SourceFile)
+    end
+  end
+
+  describe "#documented_sources" do
+    before(:each) { pool.sources.each {|s| subject << s} }
+    it "should return all sources by default" do
+      subject.documented_sources.glob("/**/*").should have(4).elements
+    end
+
+    it "should accept #only scope as exclusive scope" do
+      subject.only("/Orwik/Wid*").documented_sources.glob("/**/*").should have(1).element # /Orwik/Widget.js
+    end
+
+    it "should accept #or scope as additive scope" do
+      # /Orwik/Widget.js, /Orwik/Input.js, /Orwik/Input.Color.js
+      subject.only("/Orwik/Wid*").or("/Orwik/Inp*").documented_sources.glob("/**/*").should have(3).elements
+    end
+  end
+
+end

data/spec/jsus/pool_spec.rb

@@ -126,4 +126,28 @@ describe Jsus::Pool do
       subject.lookup_extensions(Jsus::Tag["Core/Class"]).should have_exactly(1).item
     end
   end
+
+  describe "#source_tree" do
+    let(:input_dir) { "spec/data/Extensions/app/javascripts" }
+    subject { Jsus::Pool.new(input_dir) }
+
+    it "should return a tree with all the source elements in it" do
+      subject.source_tree["/Core/Class.js"].value.should be_a(Jsus::SourceFile)
+    end
+
+    it "should not choke when sources got no referenced package" do
+      subject.send(:sources).each {|s| s.package = nil}
+      lambda { subject.source_tree }.should_not raise_error
+    end
+  end
+
+  describe "#provides_tree" do
+    let(:input_dir) { "spec/data/Extensions/app/javascripts" }
+    subject { Jsus::Pool.new(input_dir) }
+
+    it "should return a tree with all the source elements in it" do
+      subject.provides_tree.glob("/Core/Class")[0].value.should be_a(Jsus::SourceFile)      
+    end
+  end
+
 end

data/spec/jsus/tree_spec.rb

@@ -0,0 +1,172 @@
+require "spec_helper"
+
+describe Jsus::Tree::Node do
+  describe "#initialize" do
+    it "should accept full path" do
+      described_class.new("/path/node", nil).full_path.should == "/path/node"
+    end
+
+    it "should extract node name" do
+      described_class.new("/path/node", nil).name.should == "node"
+    end
+
+    it "should set value" do
+      described_class.new("/path/node", 123).value.should == 123
+    end
+  end
+
+  describe "#children" do
+    subject { described_class.new("/") }
+    
+    it "should be initialized with an empty array" do
+      subject.children.should == []
+    end
+  end
+
+  describe "#find_children_matching" do
+    subject { described_class.new('/') }
+    let(:nodes) { [] }
+    before(:each) do
+      # [0] /one 1
+      # [1] /two 2
+      # [2] /one/three 3
+      # [3] /one/four 4
+      nodes << subject.create_child('one', 1) << subject.create_child('two', 2)
+      nodes << nodes[0].create_child('three', 3) << nodes[0].create_child('four', 4)
+    end
+
+    it "if it matches a child name, it should return that child" do
+      subject.find_children_matching("one").should == [nodes[0]]
+    end
+    
+    it "if it is *, it should return children, not containing other children" do
+      subject.find_children_matching("*").should == [nodes[1]]
+    end
+
+    it "if it is **, it should return self and children, containing other children" do
+      subject.find_children_matching("**").should == [subject, nodes[0]]
+    end
+
+    it "should search for occurences with wildcards" do
+      nodes[0].find_children_matching("thr*").should == [nodes[2]]
+    end
+  end
+end
+
+describe Jsus::Tree do
+  subject { Jsus::Tree.new }
+
+  describe "#root" do
+    it "should create node if needed" do
+      subject.root.should be_a(Jsus::Tree::Node)
+    end
+
+    it "should not recreate node" do
+      subject.root.should == subject.root
+    end
+  end
+
+  describe "#insert" do
+    it "should create a node and assign value to it" do
+      subject.insert("/hello", "Value")
+      subject.root.children.should have_exactly(1).element
+      subject.root.children[0].value.should == "Value"
+    end
+    
+    it "should create all underlying nodes if needed" do
+      subject.insert("/hello/world", "value")
+      subject.root.children[0].children[0].value.should == "value"
+    end
+
+    it "should replace value of existing node if it already exists" do
+      subject.insert("/hello/world", "value")
+      subject.insert("/hello", "other_value")
+      subject.root.children.should have_exactly(1).element
+      subject.root.children[0].value.should == "other_value"
+      subject.root.children[0].children.should have_exactly(1).element
+      subject.root.children[0].children[0].value.should == "value"
+    end
+
+    it "should not replace value of existing parent nodes" do
+      subject.insert("/hello", "value")
+      subject.insert("/hello/world", "other")
+      subject.root.children[0].value.should == "value"
+    end
+
+    it "should return a node" do
+      subject.insert("/hello/world", "value").value.should == "value"
+    end
+  end
+
+  describe "#[]" do
+    it "should raise error unless path starts with root" do
+      lambda { subject["hello"] }.should raise_error      
+    end
+
+    it "should allow to get node by path" do
+      subject.insert("/hello/world", 123)
+      subject["/hello/world"].value.should == 123
+    end
+
+    it "should return nil if node is not found" do
+      subject["/hello"].should be_nil
+      subject["/hello/world"].should be_nil
+    end
+  end
+
+  describe "#glob" do
+    subject { Jsus::Tree.new }
+    let(:nodes) { [] }
+    before(:each) do
+      nodes << subject.insert("/hello/world/one", 1) <<
+               subject.insert("/hello/world/two", 2) <<
+               subject.insert("/hello/three", 3)     <<
+               subject.insert("/hello/four", 4)
+    end
+
+    it "should return the node if exact path is given" do
+      subject.glob("/hello/four").should == [nodes[3]]
+    end
+
+    it "should return all nodes in given node AND WITHOUT CHILDREN if path with wildcard is given" do
+      subject.glob("/hello/*").should =~ [nodes[2], nodes[3]]
+    end
+
+    it "should search for children matching wildcards" do
+      subject.glob("/hello/thr*").should == [nodes[2]]
+    end
+
+    it "should return all nodes in all subtrees and in the given subtree if double wildcard is given" do
+      subject.glob("/hello/**/*").should =~ nodes
+    end
+
+    it "should not choke when it cannot find anything" do
+      subject.glob("/ololo").should == []
+      subject.glob("/ololo/mwahaha").should == []
+    end
+  end
+
+  describe "#traverse" do
+    subject { Jsus::Tree.new }
+    let(:nodes) { [] }
+    before(:each) do
+      nodes << subject.insert("/hello/world/one", 1) <<
+               subject.insert("/hello/world/two", 2) <<
+               subject.insert("/hello/three", 3)     <<
+               subject.insert("/hello/four", 4)
+    end
+
+    it "should traverse only leaves by default" do
+      counter = 0
+      subject.traverse { counter += 1 }
+      counter.should == 4
+    end
+
+    it "should traverse all nodes if given a true argument" do
+      counter = 0
+      subject.traverse(true) { counter += 1 }
+      counter.should == 7    
+    end
+  end
+
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 19
-  version: 0.1.19
+  - 20
+  version: 0.1.20
 platform: ruby
 authors: 
 - Mark Abramov
@@ -199,13 +199,14 @@ files:
 - jsus.gemspec
 - lib/jsus.rb
 - lib/jsus/container.rb
+- lib/jsus/documenter.rb
 - lib/jsus/package.rb
 - lib/jsus/packager.rb
 - lib/jsus/pool.rb
 - lib/jsus/source_file.rb
 - lib/jsus/tag.rb
-- markup/index.haml
-- markup/packages_index.haml
+- lib/jsus/tree.rb
+- markup/index_template.haml
 - markup/stylesheet.css
 - markup/template.haml
 - spec/data/Basic/README
@@ -257,11 +258,13 @@ files:
 - spec/data/bad_test_source_two.js
 - spec/data/test_source_one.js
 - spec/jsus/container_spec.rb
+- spec/jsus/documenter_spec.rb
 - spec/jsus/package_spec.rb
 - spec/jsus/packager_spec.rb
 - spec/jsus/pool_spec.rb
 - spec/jsus/source_file_spec.rb
 - spec/jsus/tag_spec.rb
+- spec/jsus/tree_spec.rb
 - spec/shared/class_stubs.rb
 - spec/spec_helper.rb
 has_rdoc: true
@@ -278,7 +281,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: -125126051440542470
+      hash: -1317162541712808956
       segments: 
       - 0
       version: "0"
@@ -299,10 +302,12 @@ specification_version: 3
 summary: Javascript packager and dependency resolver
 test_files: 
 - spec/jsus/container_spec.rb
+- spec/jsus/documenter_spec.rb
 - spec/jsus/package_spec.rb
 - spec/jsus/packager_spec.rb
 - spec/jsus/pool_spec.rb
 - spec/jsus/source_file_spec.rb
 - spec/jsus/tag_spec.rb
+- spec/jsus/tree_spec.rb
 - spec/shared/class_stubs.rb
 - spec/spec_helper.rb

data/markup/index.haml

@@ -1,10 +0,0 @@
-%html
-  %head
-    %title Index for #{package} documentation
-    %link{:rel => "stylesheet", :href => "stylesheet.css"}
-%body
-  %h1 List of package #{package} contents
-  %ul
-    - sources.each do |source|
-      %li
-        %a{:href => "#{source}.html"}= source

data/markup/packages_index.haml

@@ -1,10 +0,0 @@
-%html
-  %head
-    %title Index for documentation
-    %link{:rel => "stylesheet", :href => "stylesheet.css"}
-%body
-  %h1 List of packages
-  %ul
-    - packages.each do |package|
-      %li
-        %a{:href => "#{package}/index.html"}= package