Basic usage documentation

[charles-dyfis-net]

At present, clojure.osgi is substantially lacking in documentation.

• When and how should this be used? Is clojure.osgi intended to be used when bundling Clojure itself? For bundles using Clojure, but not Clojure itself?
• What are the current limitations and known issues? For instance, are namespaces associated with unloaded bundles properly cleared? Are users expected to do work to make this so, or is it a known limitation?
• Are platforms other than Eclipse supported? What needs to be done to add support for other OSGi frameworks, if anything?

A great deal of work and understanding has obviously gone into this tool, but it isn't presently very clear where to pick things up to make an effort at trying to use or extend it.

[aav]

Hello!

At present, clojure.osgi is substantially lacking in documentation.

• When and how should this be used? Is clojure.osgi intended to be used when bundling Clojure itself? For bundles using Clojure, but not Clojure itself?

clojure.osgi is for "bundles implemented in clojure". It is possible
to export/import clojure namespaces in accordance to osgi classloading
restrictions. It is also possible to define "activator" functions,
which are invoked on bundle start/stop.

For instance, are namespaces associated with unloaded bundles properly cleared?
Currently not, but I think, this should not be a very big issue.

• Are platforms other than Eclipse supported? What needs to be done to add support for other OSGi frameworks, if anything?
  At the moment it supports only Equionx, because it relies on a Equinox
  specific feature, which is not available within official osgi
  specification - there is no standard way to figure out which bundle
  exposes specific resource. If it would be possible to identify similar
  trick for other osgi implementation - clojure.osgi can support it.

A great deal of work and understanding has obviously gone into this tool, but it isn't presently very clear where to pick things up to make an effort at trying to use or extend it.
There are several example bundle projects clojure.osgi.example.* -
some basic info can be picked from there.

Once I will have slightly more time - I can do a more substantial
description/tutorial. As of today, clojure.osgi is still a very much
research project. (although it is used by several projects, including
CCW - clojure IDE for Eclipse).

/AAV

---

Reply to this email directly or view it on GitHub:
#6

Alexey Aristov

CONFIDENTIALITY:  This email (including any attachments) may contain
confidential, proprietary and privileged information, and it's
unauthorized disclosure or use is prohibited.  If you received this
email in error, please notify the sender and delete this email from
your system.  Thank you.