austinhappel / django-registration

Fork of the django-registration module. For more info on the original module, visit: https://bitbucket.org/ubernostrum/django-registration/overview

Django user registration

This is a fork of the Django-registration module written by ubernostrum found here.

Modifications I've made:

• REGISTRATION_DEFAULT_USER_NAME (commit): If you want all of your newly registered users to be in a specific group by default, add this variable to your settings file.
  • NOTE: Don't forget to create the group in django first!

Notes on the branches

• master is the lastest stable release from the original mercurial repository, with any modifications, listed above, applied.
• upstream is the raw, latest work from the original repository - no changes made.
• develop is where I'm making in-progress changes/tweaks, most likely merging in the latest commits from the upstream branch.

Installation using pip

Because this is a custom package pulled from github, the pip install statement uses a github url instead of just a normal package name.

Also, if you want to ensure that pip records this requirement correctly when you run pip freeze, you have to install with the -e flag, and add #egg=django-registration to the end. More info on that here.

General example:

pip install -e git+git://github.com/austinhappel/django-registration.git@<tag, branch, or commit SHA>#egg=django-registration

For most likely a stable install:

pip install -e git+git://github.com/austinhappel/django-registration.git@master#egg=django-registration

For bleeding edge:

pip install -e git+git://github.com/austinhappel/django-registration.git@develop#egg=django-registration

Creating the merged git/hg repository

I'm not sure if this will work on other's machines, but it's worth documenting. Because this is a hybrid mercurial/git repo, you need to do a lot of tricky stuff to get it working correctly.

1. Install git-hg

2. Clone the mercurial repo using git-hg

    git-hg clone ssh://[e-mail]/ubernostrum/django-registration
   

3. This should get all the history from the original mercurial repo and convert it to a git repository.

4. Add the remote to my repository:

    git remote add origin [e-mail]:austinhappel/django-registration.git
   

5. Rename master branch to upstream

    git branch -m master upstream
   

6. Fetch everything from my repo:

    git fetch origin
   

7. Create orphan master and develop branches, then pull them down from my repository.

    git checkout --orphan master
    git pull origin master
   
    git checkout --orphan develop
    git pull origin develop
   

8. Set the upstream branch to track the mercurial master branch:

    git config hg.tracking.upstream "master"
   

If you did everything right, your upstream branch should be identical to, or a fast-forward version of my upstream branch. When you run git pull origin upstream you should get something to the tune of "everything is up-do-date" or "your version is ahead of origin". The master and develop branches should have parity with my repository.

Now you can pull the latest code from the original mercurial repository using:

git checkout upstream
git-hg pull

Original documentation for Django-registration

========================
Django user registration
========================

This is a fairly simple user-registration application for Django,
designed to make allowing user signups as painless as possible. It
requires a functional installation of Django 1.3 or newer, but has no
other dependencies.

For installation instructions, see the file "INSTALL" in this
directory; for instructions on how to use this application, and on
what it provides, see the file "quickstart.rst" in the "docs/"
directory.