[[PageOutline(2-5,Contents,pullout)]]

= Package Repository

== Description

This plugin turns Trac into a private package repository.

The plugin provides:
* Support for multiple programming language package repositories:
  * [#python Python Packages]
  * [#javascript Javascript Packages]

* New Trac admin panel for managing packages:
  * Upload package files to Trac
  * Delete package files

* New permissions:
  * `PACKAGE_REPOSITORY_VIEW`: Required to use the package repository
  * `PACKAGE_REPOSITORY_ADMIN`: Required to use the admin panel

=== Python Packages #python
The plugin implements the [https://www.python.org/dev/peps/pep-0503/ Simple Repository API] so Trac acts as a private package repository similar to PyPI.

Upload wheel (`.whl`) package files created by `python setup.py bdist_wheel`.
Install them with: `pip install --index-url https://<tracurl>/packages/py/ <packagename>`

=== Javascript Packages #javascript
The plugin implements a [http://wiki.commonjs.org/wiki/Packages/Registry  CommonJS Compliant package registry] so Trac acts as a private package repository similar to npm.

Upload tarball (`.tgz`) package files create by `npm pack`.
Install them with `npm install <packagename> --registry https://<tracurl>/packages/js/`


== !Bugs/Feature Requests

Existing bugs and feature requests for PackageRepositoryPlugin are 
[report:9?COMPONENT=PackageRepositoryPlugin here].

If you have any issues, create a 
[/newticket?component=PackageRepositoryPlugin new ticket].

[[TicketQuery(component=PackageRepositoryPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:packagerepositoryplugin here].

== Source

You can check out PackageRepositoryPlugin from [/svn/packagerepositoryplugin here] using Subversion, or [source:packagerepositoryplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(packagerepositoryplugin, 3)]]

== !Author/Contributors

**Author:** [wiki:psuter] [[BR]]
**Maintainer:** [[Maintainer]] [[BR]]
**Contributors:**