Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
tree: c0b83b64d3
Fetching contributors…

Cannot retrieve contributors at this time

118 lines (95 sloc) 3.137 kB
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">
<head>
<title>Fake CPAN FAQ: What the Fake?</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:rjbs@cpan.org"></link>
<link rel="stylesheet" href="cpan.css"></link>
</head>
<body>
<h1>Fake CPAN FAQ</h1>
<h2>What's the Fake CPAN?</h2>
<p>
The Fake CPAN is actually a collection of versioned, fake CPANs. A published
fake CPAN version should never change. When an update is available, it will
get a new URL. Starting with <tt>http://fakecpan.org/</tt>, fake CPAN URLs
look like this:
</p>
<pre>
http://fakecpan.org/fake/<strong>IDENTIFIER</strong>/<strong>VERSION</strong>/cpan
</pre>
<p>
Each fake CPAN is part of a series with a unique identifier. An identifier
is a bunch of words composed of letters and hyphens, matching the following
Perl 5 regular expression:
</p>
<pre>
/ \A (?:[a-z]+-)* [a-z]+ \z/x
</pre>
<p>
The version part is determined by the fake CPAN series, but will follow the
same semantics as a Perl <tt>$VERSION</tt> value. Putting it all together,
the package index for v1.234 of the <tt>example</tt> series would be found
at:
</p>
<pre>
http://fakecpan.org/fake/example/v1.234/cpan/modules/02packages.details.txt.gz
</pre>
<p>
The string <tt>latest</tt> may always be used in place of a version to reach
the latest version of a given fake.
</p>
<p>
Each version contains all the files you expect:
</p>
<pre>
modules/02packages.details.txt.gz
modules/03modlist.data.gz
authors/01mailrc.txt.gz
authors/id/A/AU/AUTHOR/Dist-1.00.tar.gz
...
</pre>
<p>
<p>
The following other resources are expected to exist:
</p>
<pre>
http://fakecpan.org/fake/IDENTIFIER/VERSION/...
about.txt - a description of the fake
policy.txt - a description of how the contents may be expected to change
over time (this helps users understand how to write test code
that will be forward compatible)
</pre>
<hr/>
<table width="100%">
<tr>
<td>
<div class="left">
<a href="http://validator.w3.org/check?uri=http%3A%2F%2Ffakecpan.org%2Findex.html">
<img src="images/xhtml.gif" alt="Valid XHTML 1.0!" height="31" width="88" /></a>
<a href="http://jigsaw.w3.org/css-validator/validator?uri=http%3A%2F%2Ffakecpan.org%2Findex.html"><img src="images/css.gif" alt="[Valid CSS]" height="31" width="88" /></a>
</div>
</td>
<td>
<div class="right">
<table width="100%">
<tr>
<td class="right" style='font-size:small'>
Fake CPAN site hosted by
</td>
</tr>
<tr>
<td class="right">
<a href="http://codesimply.com/">
<img src="images/codesimply.png" alt="(code (simply))" />
</a>
</td>
</tr>
</table>
</div>
</td>
</tr>
</table>
</body>
</html>
Jump to Line
Something went wrong with that request. Please try again.