Eclipse Smarthome Project archived?

Tags: #<Tag:0x00007f5c8fa23a58> #<Tag:0x00007f5c8fa23990> #<Tag:0x00007f5c8fa238c8>

While trying to find the API documentation for Items in the official openHAB documentation with this link, i got redirected to the eclipse archived projects page.
Does that mean the eclipse project no longer persues this effort? On a broader scale, what does that mean for the openHAB codebase?

The OpenHAB codebase started moving away from ESH with version 2.5. They are completing the split with OH3, I believe.

Can someone give a hint on the direction this is going then? Just asking, i watched the migration to ESH closely and was a bis surprised that this is archived now.

See this post: The Road Ahead - Reintegrating ESH

As a result, since only openHAB developers were contributing, no one was left to maintain ESH. As a consequence the only logical thing Eclipse could do was to archive the project.

2 Likes

Thank you for the clarification. It’s sad to see that albeit the openHAB project has covered a lot of ground over the last years, not enough comes back in terms of commercial usage and contribution.

Cheers to this great project and the people who dedicate their time and effort!

I think one of our developers here supports commercial systems worldwide. Message @chris for details.

I am picking up on this, but with a slightly different angle:

For some of the Jyhton programming, I need access to the Eclipse Smarthome Reference.
Is there a copy available online somewhere?

I know, I can download the complete archive (1,2GB), but I’d prefer not to :slight_smile:

@bastian Specifically what are you looking for? The OP said “API documentation”, which I would interpret at the Javadocs for the project. Is that what you’re after?

@mhilbush - thanks for the quick reply!
Let me rather describe, before I make it more complicated with possibly wrong terminology:

I want to see what properties and methods with which variables and return values there are for a java class like e.g. org.eclipse.smarthome.core.items.MetadataRegistry.
Is JavaDocs the correct term for that?

A while back I reenabled the Javadoc generation with this PR.

Until the resulting artifact is hosted somewhere, I’ve posted them here temporarily. Take a look to see if that’s what you’re looking for.

For 3.0 (with nifty search feature)
https://mhilbush.github.io/apidocs-next/index.html?overview-summary.html

For 2.5.0
https://mhilbush.github.io/apidocs/index.html

4 Likes

That’s exactly what I was looking for - thank you very much!

1 Like

These seem a bit out of date?
The Jenkins job (https://ci.openhab.org/view/Documentation%20(3.x)/job/openHAB-JavaDoc/) generating the javadoc has been running smoothly for some time now and the latest results can be seen here: https://ci.openhab.org/view/Documentation%20(3.x)/job/openHAB-JavaDoc/javadoc/overview-summary.html
Sadly the JavaScript doesn’t seem to load properly though so we still plan to put them on the site with the rest of the documentation in the future.

1 Like

Yeah, I haven’t been keeping it up to date. I only put it there temporarily. And, I didn’t think it would take so long to get it hosted somewhere where it could be refreshed automatically.

Yep. The best thing is the nifty search feature, which doesn’t work when you use that CI link.

1 Like

Will keep that in mind. I can’t seem to find a link to download the artifacts from Jenkins right now though…

1 Like

Yeah, it looks like it’s not working anymore.

When I run it locally on the current master, I get this error.

/Users/mark/Development/openhab-master/git/openhab-core/bundles/org.openhab.core.io.rest.sse/src/main/java/org/openhab/core/io/rest/sse/SseResource.java:151: error: cannot find symbol
    @Produces(MediaType.SERVER_SENT_EVENTS)
                       ^
  symbol:   variable SERVER_SENT_EVENTS
  location: class MediaType
/Users/mark/Development/openhab-master/git/openhab-core/bundles/org.openhab.core.io.rest.sse/src/main/java/org/openhab/core/io/rest/sse/SseResource.java:182: error: cannot find symbol
    @Produces(MediaType.SERVER_SENT_EVENTS)
                       ^
  symbol:   variable SERVER_SENT_EVENTS
  location: class MediaType

Command line was: /Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home/bin/javadoc --no-module-directories @options @packages

Did you try Java 8?

No. 3.0 requires Java 11.

2 Likes

@ysc I posed a question to @wborn about this here, as these symbols were added recently.

1 Like

We now have hosted JavaDocs for openHAB:

2.5.0:
https://www.openhab.org/javadoc/v2.5/

3.0.0-SNAPSHOT:
https://next.openhab.org/javadoc/latest/

We might also want to add some links to the Developer Guide so they are more easily discovered. :slight_smile:

5 Likes