JAL/Package Manager/jpkg

From J Wiki
Jump to: navigation, search

Console interface for Package Manager

The jpkg verb provides console access to the functionality of Package Manager.
It is available as part of the Base Library in versions 6.02.048/9 onwards.

Syntax

   <option> jpkg <addon name(s)>

<option> is a one of the following literal lists:

  • 'help' - display list of valid options for jpkg
  • 'history' - display the changelog for specified installed addon if present
  • 'install' - install specified addons if not installed locally, upgrades them to latest JAL version if already installed
  • 'manifest - show manifest for specified installed addon
  • 'reinstall- shortcut for using the remove then install options
  • 'remove' - remove specified installed addon(s)
  • 'search' - display list of addons that contain the any of the "words" specified as the right argument
  • 'show' - display summary of addon(s) specified in the right argument
  • 'showinstalled' - display list of all installed addons
  • 'shownotinstalled' - display list of all addons not yet installed
  • 'showupgrade' - display list of all installed addons with later versions available
  • 'status' - display addon and base library status.
  • 'update' - update local copy of addon information from the JAL server
  • 'upgrade' - upgrade specified installed addon(s) if later version is available

<addon name(s)> is one of the following:

  • space-delimited literal list of addon names
  • list of boxed literal addon names
  • zero length literal list - if specified with 'upgrade', all installed addons with later versions available will be upgraded.

The following options require write access to the ~addons directory:

  • 'remove'

The following options require internet access as well as write access to the ~addons directory:

'install' , 'reinstall' , 'update' , 'upgrade'

All other options only require read access to the ~addons directory.

Example Use

To load the script:

   load 'pacman'

If you haven't used Package Manager for a while then you should update the local version of the JAL server catalog that contains information on what addons/versions of addons are currently available from JAL.

   'update' jpkg ''         NB. updates local version of JAL catalog
Updating server catalog...
Local JAL information was last updated: 08 Sep 2010 19:08:54
Installed addons are up to date, 6 addons are not yet installed.
The base library is up to date.


   'install' jpkg 'convert/misc'
Installing 1 package
Downloading convert/misc...
Installing convert/misc...
Done.
Installed addons are up to date, 28 addons are not yet installed.
The base library is up to date.

Other examples for 'install' include:

   'install' jpkg 'convert/misc tables/csv'
   'install' jpkg 'base library'
   'install' jpkg 'math/misc base library stats/base'  NB. "base library" is specially handled
   'install' jpkg 'math/misc';'base library;'stats/base'


   'search' jpkg 'xml'
┌──────────────┬─────┬─────┬─────────────────────────────────────────────┐
│tables/taraxml│1.0.3│1.0.3│Platform independent system for reading Op...│
├──────────────┼─────┼─────┼─────────────────────────────────────────────┤
│xml/loose     │     │1.0.3│Loose XML parser based on regex              │
├──────────────┼─────┼─────┼─────────────────────────────────────────────┤
│xml/sax       │1.1.1│1.1.1│XML parser based on Expat library            │
├──────────────┼─────┼─────┼─────────────────────────────────────────────┤
│xml/xslt      │1.0.9│1.0.9│XSL Transform tool                           │
└──────────────┴─────┴─────┴─────────────────────────────────────────────┘

   'search' jpkg 'xml/'
┌─────────┬─────┬─────┬─────────────────────────────────┐
│xml/loose│     │1.0.3│Loose XML parser based on regex  │
├─────────┼─────┼─────┼─────────────────────────────────┤
│xml/sax  │1.1.1│1.1.1│XML parser based on Expat library│
├─────────┼─────┼─────┼─────────────────────────────────┤
│xml/xslt │1.0.9│1.0.9│XSL Transform tool               │
└─────────┴─────┴─────┴─────────────────────────────────┘

   'search' jpkg 'pcall nuri'
┌──────────────┬─────┬─────┬──────────────────────────────┐
│games/nurikabe│     │1.0.2│Nurikabe                      │
├──────────────┼─────┼─────┼──────────────────────────────┤
│general/pcall │0.2.7│0.2.7│Pointer call to a DLL function│
└──────────────┴─────┴─────┴──────────────────────────────┘

   'search' jpkg 'tara'
┌──────────────┬─────┬─────┬─────────────────────────────────────────────┐
│tables/tara   │1.2.8│1.2.8│Platform independent system for reading an...│
├──────────────┼─────┼─────┼─────────────────────────────────────────────┤
│tables/taraxml│1.0.3│1.0.3│Platform independent system for reading Op...│
└──────────────┴─────┴─────┴─────────────────────────────────────────────┘

   'show' jpkg 'search' jpkg 'tara'
== tables/tara

Tara reads and writes files in Excel format. It supports the biff8
format used in Excel 97/2000/xp/2003. It also reads older formats used
in earlier versions of Excel. It can also work with spreadsheets like
OpenOffice and Gnumeric that support Excel formats. It runs on
Windows, Linux and Mac OSX. MS Excel or OpenOffice is not required to
use Tara.

After it is installed, run lab 'Tara and Excel' for examples of using
the system.

Tara was developed and is copyrighted by Bill Lam,
bbill.lam@gmail.com, but may be used freely, even for commercial
purposes.

== tables/taraxml

The TaraXML addon reads files in Microsoft Excel's OpenXML format. For
reading and writing older non-XML Excel formats see the Tara addon.

TaraXML depends on the arc/zip, xml/xslt and general/pcall addons.
TaraXML was developed by Ric Sherlock and Bill Lam.

   'showinstalled' jpkg ''
┌─────────────────┬──────┬──────┬─────────────────────────────────────────────┐
│arc/zip          │1.1.1 │1.1.1 │zip file utilities                           │
├─────────────────┼──────┼──────┼─────────────────────────────────────────────┤
│arc/ziptrees     │1.0.2 │1.0.2 │Zips and Unzips directory trees              │
├─────────────────┼──────┼──────┼─────────────────────────────────────────────┤
│base library     │6.2.49│6.2.49│base library scripts and labs                │
├─────────────────┼──────┼──────┼─────────────────────────────────────────────┤
│convert/misc     │1.1.31│1.1.31│miscellaneous scripts                        │
├─────────────────┼──────┼──────┼─────────────────────────────────────────────┤
...

   'update' jpkg ''
Updating server catalog...
Local JAL information was last updated: 12 Jun 2009 23:50:59
Installed addons are up to date, 28 addons are not yet installed.
The base library is up to date.

   'status' jpkg ''
Local JAL information was last updated: 12 Jun 2009 23:15:27
Installed addons are up to date, 28 addons are not yet installed.
The base library is up to date.