FusionForge

Difference between revisions of "Import Export Plugin"

From FusionForge Wiki
Jump to: navigation, search
(building blocks: mediawiki)
(Building blocks: google code. Added empty lines for better rendering)
Line 34: Line 34:
  
 
GitHub provides an [https://developer.github.com/v3/ API] for developers to access the public or private repositories of its users, as well as all their metadata.
 
GitHub provides an [https://developer.github.com/v3/ API] for developers to access the public or private repositories of its users, as well as all their metadata.
 +
 
Access to the API is via HTTP GET requests and the user authentication can be realised via basic authentication (username, password) or OAuth2 authentication.
 
Access to the API is via HTTP GET requests and the user authentication can be realised via basic authentication (username, password) or OAuth2 authentication.
 +
 
The format of the response can be returned in JSON among other. More information about [https://developer.github.com/v3/media/ media types].
 
The format of the response can be returned in JSON among other. More information about [https://developer.github.com/v3/media/ media types].
  
Line 43: Line 45:
 
=== MediaWiki ===
 
=== MediaWiki ===
  
As stated in the [https://fusionforge.org/plugins/mediawiki/wiki/fusionforge/index.php?title=Project_Import/Export_Plugin#Related_tasks related tasks] section, mediawiki pages should also be available for export. The current method of exportation is defined in the [https://fusionforge.org/plugins/mediawiki/wiki/fusionforge/index.php?title=Mediawiki_Plugin#Data_Export mediawiki plugin page]
+
As stated in the [https://fusionforge.org/plugins/mediawiki/wiki/fusionforge/index.php?title=Project_Import/Export_Plugin#Related_tasks related tasks] section, mediawiki pages should also be available for export.
 +
 
 +
The current method of exportation is defined in the [https://fusionforge.org/plugins/mediawiki/wiki/fusionforge/index.php?title=Mediawiki_Plugin#Data_Export mediawiki plugin page]
 +
 
 +
=== Google Code ===
 +
 
 +
Currently there are many different types of plugins available for extracting the project metadata from Google Code web-site.
 +
 
 +
A few of these project can be found with a simple search ([https://github.com/mconf/google-code-export GitHub project], [https://gitorious.org/forgeplucker forgeplucker on gitorious]).
 +
 
 +
There is also an API provided by Google for the issue trackers, but as stated on the official documentation it has been [https://code.google.com/p/support/wiki/IssueTrackerAPI declared as deprecated].
 +
 
 +
===== Interesting links =====
  
 +
* [https://github.com/arthur-debert/google-code-issues-migrator google code issues migrator] Project that exports issues stored in google code and imports them on a github users repository.
 +
* [https://github.com/JetBrains/youtrack-rest-python-library youTrack python library]youTrack's python import library for issues of different platforms
  
 
[[Category:Plugin]]
 
[[Category:Plugin]]

Revision as of 09:56, 28 May 2014

Name
Project Import/Export Plugin
Description
The import/export plugin aims to ease the migration of project data between forges. Goal is to allow interoperability between projects hosted on different forges. As data in these forges are usually locked, which means that its quite easy to start a new project but it is not as easy if the project is already mature and the developers decide to migrate to a different forge system.This project will try to solve the following use cases:
  • Export a project from FusionForge, along with all its information (issues, trackers, etc.).
  • Import a project to FusionForge that has been exported from another forge.
  • Ideally define a common standard to represent the data in such way to be easily consumable by other services.

The project will make use of the OSLC format as it was defined by the COCLICO project. More details can be found in the specification; also take a look at ForgePlucker (and the coclico fork).

Directory
/plugins/project_import-export
Plugin Changelog
Plugin Changelog for project_import-export
Maintainer(s)
Status
in development
Compatibility
Matrix by Fusionforge Version and by Linux Distribution
distribution\version 4.8.x 5.0.x 5.1.x 5.2.x 5.3.x 6.0.x master
Debian undefined undefined undefined undefined undefined undefined undefined
CentOS undefined undefined undefined undefined undefined undefined undefined



Related tasks

  • import/export for Mediawiki_Plugin, including for private projets (currently: daily XML export for public projects only)
  • import/export for Mailman users and configuration
  • mass import/export for Mailman archives (currently: only per-month archive mbox with e-mail obfuscation)

Useful links and resources

Building blocks

The import export plugin will have to support different formats as exported from the different types of platforms.

GitHub

GitHub provides an API for developers to access the public or private repositories of its users, as well as all their metadata.

Access to the API is via HTTP GET requests and the user authentication can be realised via basic authentication (username, password) or OAuth2 authentication.

The format of the response can be returned in JSON among other. More information about media types.

An example cURL request to retrieve all the issues of the project redcarpet of user vmg.

$ curl -i "https://api.github.com/repos/vmg/redcarpet/issues"

MediaWiki

As stated in the related tasks section, mediawiki pages should also be available for export.

The current method of exportation is defined in the mediawiki plugin page

Google Code

Currently there are many different types of plugins available for extracting the project metadata from Google Code web-site.

A few of these project can be found with a simple search (GitHub project, forgeplucker on gitorious).

There is also an API provided by Google for the issue trackers, but as stated on the official documentation it has been declared as deprecated.

Interesting links