Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sonatype-nexus-community/nexus-repository-elpa
https://github.com/sonatype-nexus-community/nexus-repository-elpa
elisp elpa emacs groovy java lisp nexus-repository sonatype-nexus
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/sonatype-nexus-community/nexus-repository-elpa
- Owner: sonatype-nexus-community
- License: epl-1.0
- Created: 2018-04-30T23:21:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-08-23T08:14:41.000Z (about 3 years ago)
- Last Synced: 2024-05-02T15:24:59.186Z (6 months ago)
- Topics: elisp, elpa, emacs, groovy, java, lisp, nexus-repository, sonatype-nexus
- Language: Java
- Size: 33.2 KB
- Stars: 8
- Watchers: 12
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: license.txt
- Security: SECURITY.md
Awesome Lists containing this project
README
# Nexus Repository ELPA Format
[](https://travis-ci.org/sonatype-nexus-community/nexus-repository-elpa) [](https://gitter.im/sonatype/nexus-developers?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://depshield.github.io)
# Table Of Contents
* [Developing](#developing)
* [Requirements](#requirements)
* [Building](#building)
* [Using ELPA with Nexus Repository Manger 3](#using-elpa-with-nexus-repository-manager-3)
* [Installing the plugin](#installing-the-plugin)
* [Temporary Install](#temporary-install)
* [(more) Permanent Install](#more-permanent-install)
* [(most) Permament Install](#most-permanent-install)
* [The Fine Print](#the-fine-print)
* [Getting Help](#getting-help)
## Developing
### Requirements
* [Apache Maven 3.3.3+](https://maven.apache.org/install.html)
* [Java 8+](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
* Network access to https://repository.sonatype.org/content/groups/sonatype-public-grid
Also, there is a good amount of information available at [Bundle Development](https://help.sonatype.com/display/NXRM3/Bundle+Development)
### Building
To build the project and generate the bundle use Maven
mvn clean install
If everything checks out, the bundle for ELPA should be available in the `target` folder
## Using ELPA With Nexus Repository Manager 3
[We have detailed instructions on how to get started here!](docs/ELPA_USER_DOCUMENTATION.md)
## Installing the plugin
There are a range of options for installing the ELPA plugin. You'll need to build it first, and
then install the plugin with the options shown below:
### Temporary Install
Installations done via the Karaf console will be wiped out with every restart of Nexus Repository. This is a
good installation path if you are just testing or doing development on the plugin.
* Enable Nexus console: edit `/bin/nexus.vmoptions` and change `karaf.startLocalConsole` to `true`.
More details here: [Bundle Development](https://help.sonatype.com/display/NXRM3/Bundle+Development+Overview)
* Run Nexus' console:
```
# sudo su - nexus
$ cd /bin
$ ./nexus run
> bundle:install file:///tmp/nexus-repository-elpa-1.0.0.jar
> bundle:list
```
(look for org.sonatype.nexus.plugins:nexus-repository-elpa ID, should be the last one)
```
> bundle:start
```
### (more) Permanent Install
For more permanent installs of the nexus-repository-elpa plugin, follow these instructions:
* Copy the bundle (nexus-repository-elpa-1.0.0.jar) into /deploy
This will cause the plugin to be loaded with each restart of Nexus Repository. As well, this folder is monitored
by Nexus Repository and the plugin should load within 60 seconds of being copied there if Nexus Repository
is running. You will still need to start the bundle using the karaf commands mentioned in the temporary install.
### (most) Permanent Install
If you are trying to use the ELPA plugin permanently, it likely makes more sense to do the following:
* Copy the bundle into `/system/org/sonatype/nexus/plugins/nexus-repository-elpa/1.0.0/nexus-repository-elpa-1.0.0.jar`
* Make the following additions marked with + to `/system/org/sonatype/nexus/assemblies/nexus-core-feature/3.x.y/nexus-core-feature-3.x.y-features.xml`
```
wrap
+ nexus-repository-elpa
```
to the `` section below the last (above is an example, the exact last one may vary).
And
```
+
+ org.sonatype.nexus.plugins:nexus-repository-elpa
+ mvn:org.sonatype.nexus.plugins/nexus-repository-elpa/1.0.0
+
```
as the last feature.
This will cause the plugin to be loaded and started with each startup of Nexus Repository.
## The Fine Print
It is worth noting that this is **NOT SUPPORTED** by Sonatype, and is a contribution of ours
to the open source community (read: you!)
Remember:
* Use this contribution at the risk tolerance that you have
* Do NOT file Sonatype support tickets related to ELPA support in regard to this plugin
* DO file issues here on GitHub, so that the community can pitch in
Phew, that was easier than I thought. Last but not least of all:
Have fun creating and using this plugin and the Nexus platform, we are glad to have you here!
## Getting help
Looking to contribute to our code but need some help? There's a few ways to get information:
* Chat with us on [Gitter](https://gitter.im/sonatype/nexus-developers)
* Check out the [Nexus3](http://stackoverflow.com/questions/tagged/nexus3) tag on Stack Overflow
* Check out the [Nexus Repository User List](https://groups.google.com/a/glists.sonatype.com/forum/?hl=en#!forum/nexus-users)