/README.txt

https://bitbucket.org/schwa/hgkeychain/ · Plain Text · 53 lines · 37 code · 16 blank · 0 comment · 0 complexity · 65abf345aaa9a65a0cb86b9b0a1f89bf MD5 · raw file 

    

  1. About
    2. 

  2. =====
    3. 

  3. hgkeychain is an extension for mercurial that lets the user use the MacOS X keychain to store passwords for remote repositories.
    4. 

  4. 

  5. Requirements
    6. 

  6. ============
    7. 

  7. Mac OS X 10.5+ (should work on older OSes but only tested on 10.5 and 10.6)
    8. 

  8. Python 2.5 (should work on older versions of Python but only tested on 2.5 and 2.6)
    9. 

  9. Mercurial 0.9+ (works on 1.0 through 1.3)
    10. 

  10. My pykeychain Python Module
    11. 

  11. 

  12. Installation
    13. 

  13. ============
    14. 

  14. The easiest way to install hgkeychain is to use easy_install or pip:
    15. 

  15. 

  16. 	sudo easy_install -U pykeychain
    17. 

  17. 

  18. (The sudo command may be optional depending on your machine's set up)
    19. 

    20. 

  20. Activation
    21. 

  21. ==========
    22. 

  22. Edit your ~/.hgrc file to activate the extension:
    23. 

  23. 

  24. 	[extensions]
    25. 

  25. 	hgkeychain=
    26. 

  26. 

  27. See http://www.selenic.com/mercurial/wiki/index.cgi/UsingExtensions for more information on installing and activating mercurial extensions.
    28. 

  28. 

  29. Usage
    30. 

  30. =====
    31. 

  31. Once properly installed and activated hgkeychain will allow mercurial to store and retrieve repository passwords using the user's keychain.
    32. 

    33. 

  33. You should generally embed the remote repository's username in the repository URL when performing a clone, push or pull operation. E.g.:
    34. 

    35. 

  35. 	http://username@example.com/hg/repository
    36. 

  36. 

  37. If you try to clone, push or pull to a password protected repository mercurial will query the user's Keychain for the repository password. If no password is found, mercurial will prompt the user for the password (via the terminal) and then store the password in the Keychain.
    38. 

    39. 

  39. Configuration
    40. 

  40. =============
    41. 

  41. hgkeychain is aware of [auth] settings in your ~/.hgrc.  For example, if you have a BitBucket account, you could set this up as such:
    42. 

  42. 

  43.   [auth]
    44. 

  44.   bb.prefix = bitbucket.org/
    45. 

  45.   bb.username = {username}
    46. 

  46.   bb.schemes =  http https
    47. 

  47. 

  48. The prefix is used to store your password in keychain, so all repositories with the same prefix will share the same keychain item.  This keeps your keychain from getting cluttered up with a single keychain item per repository.  Note that [auth] requires at least Mercurial verion 1.3.  The old URL replacement regular expressions have been removed in support of [auth].
    49. 

  49. 

  50. You can turn on logging to help debug problems like so:
    51. 

  51. 

  52.   [hgkeychain]
    53. 

  53.   logging=1
    54.