SC2Mapster.com

SC2Mapster.com Wiki

Repositories / Repository FAQ

Can anyone get a repository?

As long as you have an account on the Curse Network and are able to get a project approved, you'll be able to get your own repository.

How do I get my own code repository?

  1. Create a project if you haven't already, wait for an admin to approve your project.
  2. On your project page, you should go to Repository Actions -> Edit Repository.
  3. For "Repository Type", select the one you want. Currently Subversion, Git, and Mercurial are supported.
  4. In "Package As", put the name of your project's main folder. For World of Warcraft, this will be the same as your Addon's TOC.
  5. Wait roughly a minute, and your repository should be created.

How do I actually use my repository now?

Subversion

  1. You have the option of using a simple SVN password. SSH keys are far more secure, but harder to set up.
  2. To use SSH keys, follow the instructions of the article about SSH Public Keys and use the "Development url" starting with svn+ssh://.
  3. To use simple SVN password, go to http://www.curseforge.com/home/repository-authorization/edit/ and setup your SVN password. Then use the "Development url" starting with svn:// that should contains your username in lowercase. Enter your password when told to do so.
  4. svn checkout svn+ssh://svn@svn.curseforge.net/wow/my-project/mainline/trunk MyProject (Replace with your "Development url" and project name)
  5. cd MyProject
  6. Add whatever files you want
  7. svn add *
  8. svn commit -m "Your commit message"

Git

  1. Follow the instructions of the article about SSH Public Keys.
  2. Go to your project page and it will list your "Development url". This is what you will be pushing to. ''Note: If you have a pre-1.6.2 version of Git, you can't clone the repository if it's empty, you'll have to push to it first.''
  3. mkdir MyProject (Or whatever your project's name is)
  4. cd MyProject
  5. git init
  6. git remote add origin git@git.curseforge.net:wow/my-project/mainline.git (Whatever your "Development url" actually is)
  7. Add whatever files you want, commit it locally
  8. git push origin master
  9. Add some more files, commit locally
  10. git push (You only have to do this from now on)

Mercurial (HG)

  1. Follow the instructions of the article about SSH Public Keys.
  2. Go to your project page and it will list your "Development url". This is what you will be pushing to.
  3. hg clone ssh://hg.curseforge.net/wow/my-project/mainline MyProject (Replace with your "Development url" and project name)
  4. cd MyProject
  5. Edit whatever files you want, commit locally
  6. hg push

How do I get the packager to make a release or beta

You need to create a tag with your repository.

Subversion

Something along the lines of

 svn cp svn://svn.curseforge.net/wow/my-project/mainline/trunk svn://svn.curseforge.net/wow/my-project/mainline/tags/v0.1 -m "Tagging as v0.1"

Except replace 

svn:~//svn.curseforge.net/wow/my-project/mainline

with your repository url and 

v0.1

with the tag you want.

Git

 cd MyProject
 git tag -a v0.1 -m "Tagging as v0.1"
 git push origin master tag v0.1

Mercurial

 hg tag -m "Tagging as v0.1" v0.1
 hg push

Through the website

Go to your project page's repository section, and there will be a "tag repository" link on the side panel. Put in the name you want for your tag, and it will tag it for you.

How does the packager know whether a tag is a release or a beta?

It checks if the tag name matches the regex ^v?[0-9\.\-_]+$|release|stable. In layman's terms, it is a release if either:

  • It optionally starts with "v" and has only numbers, dots, dashes, or underscores.
  • It has 'release' in the name
  • It has 'stable' in the name

How can I specify externals? (a.k.a. embeds/libraries)

See .pkgmeta file

I tagged my project, but I don't see a file made!

Relax. The packager only runs on set intervals (approximately every 20 minutes), at which point it packages any new tags that were created since its last run. If you tag your project, give it up to 30 minutes or so (on the outside) to build the zip.

Changes to packager settings won't affect whether the packager detects a tag or not - only whether it actually packages it. If you change your packager settings before a tag is built, the new packager settings will be in effect when it goes to build the tag. There's no need to recommit a tag if you change your packaging settings, unless the tag was already built.

How do I import an existing repository?

Subversion

  1. svn checkout svn+ssh://svn@svn.curseforge.net/wow/my-project/mainline/trunk MyProject (Replace with your "Development url" and project name)
  2. cd MyProject
  3. Add whatever files you want
  4. svn add *
  5. svn commit -m "Your commit message"

Git

  1. git clone git@git.curseforge.net:wow/my-project/mainline.git
  2. Add whatever files locally and commit them.
  3. git push

Mercurial (HG)

  1. hg clone ssh://hg.curseforge.net/wow/my-project/mainline MyProject (Replace with your "Development url" and project name)
  2. cd MyProject
  3. Edit whatever files you want, commit locally
  4. hg push

Error Messages

Git

fatal: The remote end hung up unexpectedly

Replace the git://git.curseforge.net:wow/my-project/mainline.git with git@git.curseforge.net:wow/my-project/mainline.git. The git://... protocol is read-only access.

Repository hooks

Your .pkgmeta file is invalid: Git repository not found: 'git://git.curseforge.net/wow/...'

Apart from the obvious problem of malformed URLs, this can also be caused by a repository that has not been pushed to yet. If you created a new library and are trying to refer to it in an external, check if you pushed any commits to the library's repository.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of arith arith Mon, 23 Aug 2010 08:38:47

    I find the answer.

    Roles

    Artist

    • Manage project images

    Author

    • Clone closed repository
    • Commit to code repository
    • Manage english project translations
    • Manage files
    • Manage project components
    • Manage project images
    • Manage project milestones
    • Manage project pages
    • Manage project polls
    • Manage project ticket templates
    • Manage project tickets
    • Manage relationships
    • Translate project
    • View code repository

    Contributor

    • View code repository

    Documenter

    • Manage project pages

    Former author

    Maintainer

    • Clone closed repository
    • Commit to code repository
    • Manage english project translations
    • Manage files
    • Manage project components
    • Manage project images
    • Manage project milestones
    • Manage project pages
    • Manage project polls
    • Manage project ticket templates
    • Manage project tickets
    • Manage relationships
    • Translate project
    • View code repository

    Manager

    • Abandon project
    • Delete repository
    • Manage english project translations
    • Manage files
    • Manage project
    • Manage project components
    • Manage project donation info
    • Manage project images
    • Manage project milestones
    • Manage project pages
    • Manage project polls
    • Manage project reward splits
    • Manage project ticket templates
    • Manage project tickets
    • Manage relationships
    • Manage remote sync
    • Manage repository
    • Manage roles
    • Merge project
    • Resubmit project for approval
    • Translate project
    • View code repository

    Tester

    • View code repository

    Ticket Manager

    • Manage project ticket templates
    • Manage project tickets

    Translator

    • Translate project
  • Avatar of arith arith Mon, 23 Aug 2010 02:48:25

    What's the relationship between project roles and repository permission if the repository is set to private? In what project role the team member can also upload files to the repository?

  • Avatar of OrionShock OrionShock Mon, 30 Nov 2009 02:30:40

    it should be noted for git some basics:

    > git config --global user.name "Your Name Comes Here"

> git config --global user.email you@yourdomain.example.com

    to set your uid and email

    Last edited on 30 Nov 2009 by OrionShock
  • Avatar of Arrowmaster Arrowmaster Tue, 08 Sep 2009 23:23:20
    Quote from watchout:

    to me it seems that actually it's not the tag name that is parsed, but the commit message of the tagging commit, could this be true?

    No.

  • Avatar of watchout watchout Wed, 24 Jun 2009 23:36:28
    Quote:

    How does the packager know whether a tag is a release or a beta?

    It checks if the tag name matches the regex ^v?[0-9\.\-_]+$|release|stable. In layman's terms, it is a release if either:

    • It optionally starts with "v" and has only numbers, dots, dashes, or underscores.
    • It has 'release' in the name
    • It has 'stable' in the name

    to me it seems that actually it's not the tag name that is parsed, but the commit message of the tagging commit, could this be true?

  • Avatar of mikk mikk Sat, 22 Nov 2008 15:21:22

    This is not hard, and it is not our job to educate you on how to use SVN.

    1. My WoWAce -> Repository Authorization. Set your password.

    2. Connect. Type in your username and the password you set in 1.

    3. Et voila.

  • Avatar of ZacWolf ZacWolf Tue, 18 Nov 2008 21:05:15

    Come on...

    Is anyone going to answer these posts?

    Can we get a step by step guide for Tortois SVN?

    I try with command line SVN and I keep getting "Authorization failed"

    This process can't continue to be this difficult. Who has time for it?

    -ZacWolf

  • Avatar of Azethoth Azethoth Wed, 29 Oct 2008 19:28:07

    Just go to the project web site, click repositories, on the right click make a tag, type in the tag name and you are done.

  • Avatar of ZacWolf ZacWolf Sun, 26 Oct 2008 01:19:36

    OK, needless to say I am lost...

    It's like you took the worst of both Curse and Ace and created something even MORE worse...

    ANYWAY...

    I use Tortoise SVN, can anyone tell me how to add a tag?

    I used to specify a property: tsvn:logtemplate [addonname]: -

    But that doesn't seem to be working now.

  • Avatar of Zikko Zikko Wed, 15 Oct 2008 19:47:50

    Is there a reason why in the tagging section under "Through the website" you can find a link to cartographer3s tagging page (which throws a 403)?

Table of contents

  1. 1 Can anyone get a repository?
  2. 2 How do I get my own code repository?
  3. 3 How do I actually use my repository now?
    1. 3.1 Subversion
    2. 3.2 Git
    3. 3.3 Mercurial (HG)
  4. 4 How do I get the packager to make a release or beta
    1. 4.1 Subversion
    2. 4.2 Git
    3. 4.3 Mercurial
    4. 4.4 Through the website
  5. 5 How does the packager know whether a tag is a release or a beta?
  6. 6 How can I specify externals? (a.k.a. embeds/libraries)
  7. 7 I tagged my project, but I don't see a file made!
  8. 8 How do I import an existing repository?
    1. 8.1 Subversion
    2. 8.2 Git
    3. 8.3 Mercurial (HG)
  9. 9 Error Messages
    1. 9.1 Git
      1. 9.1.1 fatal: The remote end hung up unexpectedly
    2. 9.2 Repository hooks
      1. 9.2.1 Your .pkgmeta file is invalid: Git repository not found: 'git://git.curseforge.net/wow/...'

Facts

Date created
05 Jan 2009
Last updated
07 Aug 2009

Authors