MetaProject 0.4.9
MetaProject (formerly XForge) is a library that allows interaction with various project hosting servers, issue trackers, SCMs and SCM browsers through a common API.
MetaProject also includes is a Quick Release System (QRS) for [RubyForge, SourceForge and other SourceForge clones] (commonly referred to as XForge throughout the documentation) as well as RAA and Freshmeat. QRS support for other hosts is in the pipe.
Feature overview
RSCM related
-
Obtain preconfigured RSCM:rscm.rubyforge.org objects.
SCM browser related
-
Obtain preconfigured SCM browser proxy objects that can generate various links with a simple API.
-
Treat files in the SCM browser just as stdlib Pathname object (only a subset is provided)
QRS related
-
QRS: Create/Upload new releases (with multiple files if desired).
-
Rake integration (use the QRS from Rake scripts).
-
Publish XForge news items for a project.
-
Publish on RAA (SOAP under the hood)
-
Publish on Freshmeat (XMLRPC under the hood)
Issue tracker related
-
Close and comment on issues
-
Recognise issue ids and create links in e.g. SCM commit messages
-
Patois parsing, a DSL for issue and release management.
XForge related
-
Look up XForge projects by unix name (no need to worry about group_id or package_id).
-
Also see QRS related
-
Query home page URLs for a project.
Download/Installation
The latest version of MetaProject can be found at
Download and install MetaProject with the following.
gem install
(You may need administrative privileges (sudo) for this).
Usage
QRS
MetaProject itself is released with MetaProject’s QRS Rake tasks, so check out MetaProject’s own Rakefile (tinyurl.com/a23u5) and CHANGES (tinyurl.com/9qxxf) files for the best examples on how to use it.
XForge can parse release summary and changes from CHANGES if you format it the way XForge’s own CHANGES is formatted. Also make sure your Rakefile’s PKG_VERSION is in sync with the latest version specified in the CHANGES file.
Other parts of the API
If you’re writing an application that interacts with MetaProject, please refer to the RDoc API and the RSpec:rspec.rubyforge.org specifications in the CVS source tree (kinda like unit tests, just better.)
FAQ
I don’t have a CHANGES file that MetaProject’s Rake tasks understands. How do I disable it?
When using the Rake tasks Rake::XForge::Release and Rake::XForge::NewsPublisher, you can omit parsing of the CHANGES file by telling the task to omit it. In this case, you also have to specify release_notes
and release_changes
to the task. Example:
task :release_files => [:gem] do
release_files = FileList[
"pkg/#{PKG_FILE_NAME}.gem"
]
Rake::XForge::Release.new(MetaProject::Project::XForge::RubyForge.new('xforge')) do |release|
# If you omit user_name and/or password, you'll be prompted at the command line.
release.user_name = ENV['RUBYFORGE_USER']
release.password = ENV['RUBYFORGE_PASSWORD']
release.files = release_files.to_a
release.release_name = "MetaProject #{PKG_VERSION}"
# The code below is for disabling parsing of CHANGES
release.changes_file = nil
release.release_notes = "This is release notes. They will show up at the release summary"
release.release_changes = ["This is", "a list of String", "and will also show up", "under the release summary"]
end
end
Credits
(In alphabetical order)
- Aslak Hellesoy
-
Maintainer of this project.
- David Heinemeier Hansson
-
For the HTTP POST code and the idea to parse XForge ids from project pages.
- Jim Weirich
-
For Rake and feedback on some problems with the Rake tasks.
- Thomas Leitner
-
For Freshmeat and RAA support.
Support
The MetaProject homepage is xforge.rubyforge.org. You can find the MetaProject RubyForge page at rubyforge.org/projects/xforge.
Feel free to submit patches, bug reports or feature requests via MetaProject’s issue tracker on RubyForge.
For discussions and questions, please use the mailing list: rubyforge.org/mail/?group_id=801
License
MetaProject is available under an MIT-style license.
:include: MIT-LICENSE