EPM Development - Revision history

Drn@ecs.soton.ac.uk: Might as well just make this a redirect to My First Bazaar Package

2022-01-21T12:31:01Z

Might as well just make this a redirect to My First Bazaar Package

Kgoetz: fix category, point to replacement page

2018-09-26T04:00:16Z

fix category, point to replacement page

Kgoetz: VCS editing has been added to My First Bazaar Package, which is otherwise a more comprehensive overview of this topic.

2018-09-26T03:56:36Z

VCS editing has been added to My First Bazaar Package, which is otherwise a more comprehensive overview of this topic.

Tdb01r at 15:26, 16 December 2011

2011-12-16T15:26:49Z

Tdb01r at 14:04, 16 December 2011

2011-12-16T14:04:44Z

Tdb01r: /* Create a blank EPM */

2011-12-16T13:43:23Z

‎Create a blank EPM

Tdb01r: /* Create a blank EPM */

2011-12-16T13:43:08Z

‎Create a blank EPM

Tdb01r: /* Create a blank EPM */

2011-12-16T13:42:58Z

‎Create a blank EPM

Tdb01r: /* Add a plugin */

2011-12-16T13:42:13Z

‎Add a plugin

Tdb01r: Created page with 'Category:EPM This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed …'

2011-12-16T13:40:49Z

Created page with 'Category:EPM This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed …'

New page

[[Category:EPM]]

This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool.

The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live system.

==Create a blank EPM==

Under Admin (System Tools) -> EPrints Bazaar (Developer Tools), enter a unique name for the package in ''Create a new EPM'' and click ''Create''. For this howto we will call the extension "biscuits".

==Add the blank EPM to SVN==

From your EPrints root directory create a new SVN directory:

svn mkdir https://mysvn.example/biscuits -m " * Biscuits"
svn checkout https://mysvn.example/biscuits lib/epm/biscuits

Add '''.epmi''' and '''cfg''' to SVN:

cd lib/epm/biscuits
svn add biscuits.epmi cfg/
svn commit -m " * Biscuits EPM blank"

==Add a plugin==

We'll use the '''epm/biscuits''' directory to hold our other files to be managed by SVN.

cd lib/epm/biscuits
mkdir -p lib/plugins/EPrints/Plugin/Export/
nano lib/plugins/EPrints/Plugin/Export/Biscuits.pm [ ... make a basic plugin ... ]
svn add lib
svn commit -m " * Biscuits export"
cd ../../..

Use the ''link_lib'' argument with [[API:tools/epm]] to sym-link the plugin into your live archive:

./tools/epm link_lib biscuits

Finally, add your plugin to the list of files the biscuits EPM is tracking. In the Developer Tools screen for ''biscuits'' find the plugin and click to track it. (If the file does not appear you may need to refresh the file list by ''Save and Return'' and re-editing the EPM.)

← Older revision		Revision as of 12:31, 21 January 2022
Line 1:		Line 1:
−	~~[[Category:Rubbish]]~~	+	#REDIRECT [[My First Bazaar Package]]
−
−
−	~~WARNING: This page has been superseded by~~ [[My First Bazaar Package]]
−
−
−
−	This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.
−
−	Tracking files in EPM and SVN is more complex but allows easier development. Because you can't track individual files in SVN you must place all of your package's files under an independent directory tree and then sym-link them into the correct locations in EPrints. The [[API:tools/epm]] provides a ''link_lib'' option that makes this easier to achieve, as long as you follow the directory layout described below.
−
−	'''Warning!''' do not edit files and then enable/disable or install/uninstall an EPM. The EPM will detect the changed files and either create backups or refuse to work. You must edit the EPM and do ''Save and Return'' to re-scan the EPM's files (in Admin → EPrints Bazaar, Developer Tools).
−
−	~~==Creating a blank EPM==~~
−
−	Under Admin (System Tools) → EPrints Bazaar (Developer Tools), enter a unique name for the package in ''Create a new EPM'' and click ''Create''. For this howto we will call the extension ''biscuits''.
−
−	~~The GUI will create the lib/epm/biscuits tree for you.~~
−
−	~~===Add the blank EPM to SVN===~~
−
−	~~From your EPrints root directory create a new SVN directory and check it out over the top of the EPM-created directory tree:~~
−
−	~~svn mkdir https://mysvn.example/biscuits -m " * Biscuits"~~
−	~~svn checkout https://mysvn.example/biscuits lib/epm/biscuits~~
−
−	~~Add '''.epmi''' and '''cfg''' to SVN:~~
−
−	~~cd lib/epm/biscuits~~
−	~~svn add biscuits.epmi cfg/~~
−	~~svn commit -m " * Biscuits EPM blank"~~
−
−	~~==Adding a System-level Plugin==~~
−
−	~~We'll use the '''epm/biscuits''' directory to hold our files to be managed by SVN.~~
−
−	~~pushd lib/epm/biscuits~~
−	~~mkdir -p lib/plugins/EPrints/Plugin/Export/~~
−	~~nano lib/plugins/EPrints/Plugin/Export/Biscuits.pm # Write a basic plugin~~
−	~~svn add lib~~
−	~~svn commit -m " * Biscuits export"~~
−	~~popd~~
−
−	~~Use the ''link_lib'' argument in [[API:tools/epm]] to sym-link the plugin into your live repository:~~
−
−	~~./tools/epm link_lib biscuits~~
−
−	Finally, add your plugin to the list of files the biscuits EPM is tracking. In the Developer Tools screen for ''biscuits'' find the plugin and click to track it. (If the file does not appear you may need to refresh the file list by ''Save and Return'' and re-editing the EPM.)
−
−	~~[[File:Epm_development_files.jpg]]~~
−
−	~~This technique can be applied to any other files you want to install below lib/ (and hence be available to all repositories).~~
−
−	~~==Adding a Repository-level Config File==~~
−
−	Ensure your EPM is ''Enabled'' for the repository you are developing in. The EPM Developer Tools already created a '''cfg/cfg.d''' tree in the '''lib/epm''' directory. Add a new ''zz_biscuits.pl'' configuration file:
−
−	~~pushd lib/epm/biscuits/cfg/cfg.d~~
−	~~nano zz_biscuits.pl # $c->{plugins}->{'Export::Biscuits'}->{params}->{disable} = 0~~
−	~~svn add zz_biscuits.pl~~
−	~~svn ci -m " * zz_biscuits.pl"~~
−	~~popd~~
−
−	~~In the Developer Tools screen add zz_biscuits.pl to the files controlled by the biscuits EPM.~~
−
−	~~Normally enabling the EPM would copy the ''zz_biscuits.pl'' file into your repository but instead we want to sym-link it so we can edit it:~~
−
−	~~ln -s lib/epm/biscuits/cfg/cfg.d/zz_biscuits.pl archives/[archiveid]/cfg/cfg.d/zz_biscuits.pl~~
−
−	~~Any files you add below '''cfg/''' and are tracked by the EPM will be added to the repository when the EPM is enabled.~~

← Older revision		Revision as of 04:00, 26 September 2018
Line 1:		Line 1:
−	[[Category:~~Ruvbish~~]]	+	[[Category:Rubbish]]
		+
		+
		+	WARNING: This page has been superseded by [[My First Bazaar Package]]
		+
		+

	This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.		This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.

← Older revision		Revision as of 03:56, 26 September 2018
Line 1:		Line 1:
−	[[Category:~~EPrints Bazaar~~]]	+	[[Category:Ruvbish]]

	This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.		This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.

← Older revision		Revision as of 15:26, 16 December 2011
Line 1:		Line 1:
−	[[Category:~~EPM~~]]	+	[[Category:EPrints Bazaar]]

	This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.		This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.

@@ Line 7: / Line 7: @@
 ==Create a blank EPM==
-Under Admin (System Tools) &rarr; EPrints Bazaar (Developer Tools), enter a unique name for the package in ''Create a new EPM'' and click ''Create''. For this howto we will call the extension "biscuits".
+Under Admin (System Tools) &rarr; EPrints Bazaar (Developer Tools), enter a unique name for the package in ''Create a new EPM'' and click ''Create''. For this howto we will call the extension ''biscuits''.
 ==Add the blank EPM to SVN==

@@ Line 1: / Line 1: @@
 [[Category:EPM]]
-This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool.
+This page describes how to develop EPrints Package Management (EPM) extensions using a code versioning tool. The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live repository.
-The goal is to have your EPM source files managed through a code versioning tool and be able to edit them in a live system.
+Tracking files in EPM and SVN is more complex but allows easier development. Because you can't track individual files in SVN you must place all of your package's files under an independent directory tree and then sym-link them into the correct locations in EPrints. The [[API:tools/epm]] provides a ''link_lib'' option that makes this easier to achieve, as long as you follow the directory layout described below.
-==Create a blank EPM==
+'''Warning!''' do not edit files and then enable/disable or install/uninstall an EPM. The EPM will detect the changed files and either create backups or refuse to work. You must edit the EPM and do ''Save and Return'' to re-scan the EPM's files (in Admin &rarr; EPrints Bazaar, Developer Tools).
 Under Admin (System Tools) &rarr; EPrints Bazaar (Developer Tools), enter a unique name for the package in ''Create a new EPM'' and click ''Create''. For this howto we will call the extension ''biscuits''.
-==Add the blank EPM to SVN==
+The GUI will create the lib/epm/biscuits tree for you.
-From your EPrints root directory create a new SVN directory:
+===Add the blank EPM to SVN===
   svn mkdir https://mysvn.example/biscuits -m " * Biscuits"
@@ Line 22: / Line 26: @@
   svn commit -m " * Biscuits EPM blank"
-==Add a plugin==
+==Adding a System-level Plugin==
-We'll use the '''epm/biscuits''' directory to hold our other files to be managed by SVN.
+We'll use the '''epm/biscuits''' directory to hold our files to be managed by SVN.
-  cd lib/epm/biscuits
+  pushd lib/epm/biscuits
   mkdir -p lib/plugins/EPrints/Plugin/Export/
-  nano lib/plugins/EPrints/Plugin/Export/Biscuits.pm [ ... make a basic plugin ... ]
+  nano lib/plugins/EPrints/Plugin/Export/Biscuits.pm # Write a basic plugin
   svn add lib
   svn commit -m " * Biscuits export"
-  cd ../../..
+  popd
-Use the ''link_lib'' argument with [[API:tools/epm]] to sym-link the plugin into your live archive:
+Use the ''link_lib'' argument in [[API:tools/epm]] to sym-link the plugin into your live repository:
   ./tools/epm link_lib biscuits
@@ Line 40: / Line 44: @@
 [[File:Epm_development_files.jpg]]

← Older revision		Revision as of 13:42, 16 December 2011
Line 38:		Line 38:

	Finally, add your plugin to the list of files the biscuits EPM is tracking. In the Developer Tools screen for ''biscuits'' find the plugin and click to track it. (If the file does not appear you may need to refresh the file list by ''Save and Return'' and re-editing the EPM.)		Finally, add your plugin to the list of files the biscuits EPM is tracking. In the Developer Tools screen for ''biscuits'' find the plugin and click to track it. (If the file does not appear you may need to refresh the file list by ''Save and Return'' and re-editing the EPM.)
		+
		+	[[File:Epm_development_files.jpg]]