README

   1
   2 g-pypi
   3 ======
   4
   5
   6 `http://code.google.com/p/g-pypi/ <http://code.google.com/p/g-pypi/>`_
   7
   8 g-pypi creates Python package ebuilds for Gentoo Linux by querying The Cheese Shop.
   9
  10 Although it's in the early stages of development, testing has generated over 1,200 ebuilds automatically.
  11
  12 Note: g-pypi will only be as good at creating ebuilds as The Python Package Index information is. People can leave out a lot of information when submitting info to PyPI, making ebuild creation impossible.
  13
  14 Basic Usage
  15 ===========
  16
  17 Output ebuild to stdout:
  18
  19 ::
  20
  21   g-pypi -p package_name
  22
  23
  24 Write ebuild to your overlay:
  25
  26 ::
  27
  28   g-pypi package_name
  29
  30 Create live svn ebuild (if subversion URI is listed in PyPI):
  31
  32 ::
  33
  34   g-pypi -s package_name
  35
  36 By default your first overlay listed in /etc/make.conf PORTDIR_OVERLAY
  37 is used. If you want to use a different one, edit ~/.g-pypirc
  38
  39 By default your first KEYWORD listed in /etc/make.conf KEYWORDS
  40 is used. If you want to use a different one, edit ~/.g-pypirc or prefix your command with ACCEPT_KEYWORDS e.g.
  41
  42 ::
  43
  44    $ ACCEPT_KEYWORDS='~amd64' g-pypi foopkg
  45
  46
  47 You can over-ride some variables if g-pypi can't figure out the
  48 PN, PV etc.
  49
  50
  51 ::
  52
  53    -n or --PN=package-name
  54
  55    -v or --PV=version
  56
  57    --MY_P=my_p
  58
  59    --MY_PN=my_pn
  60
  61    --MY_PV=my_pv
  62
  63
  64 If you don't specify a portage category with '-c' the ebuild will be
  65 placed in dev-python
  66
  67 Use '-V' for verbose output for debugging.
  68
  69
  70 INSTALL
  71 =======
  72
  73 g-pypi is available in my overlay directory:
  74
  75 If you haven't emerged and configured app-portage/layman:
  76
  77 ::
  78
  79    emerge layman
  80    echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf
  81    layman --add pythonhead
  82    emerge g-pypi
  83
  84 Subversion
  85 ==========
  86
  87 `subversion repository <http://g-pypi.googlecode.com/svn/trunk/#egg=g-pypi-dev>`_
  88
  89 Hint: You can use to create a live svn ebuild for g-pypi ;)
  90
  91 ::
  92
  93   g-pypi -s g-pypi
  94
  95