Changeset - b777b096d9a2
Parent rev.
Child rev.
[Not reviewed]
stable
0 5 0
Mads Kiilerich - 9 years ago 2017-05-14 01:12:56
mads@kiilerich.com
setup: don't use setuptools 34 - it has indirect conflicts with the celery version supported on the stable branch (Issue #266)

Setuptools==34 requires packaging>=16.8 which has an unconstrained requirement
of pyparsing ... but actually it doesn't work with pyparsing==1.5.7 ... which
is required by celery<2.3 ... which this version of Kallithea requires.

Celery has been upgraded on the development branch but we don't want to do that
on the stable branch.
5 files changed with 6 insertions and 5 deletions:
docs/contributing.rst
1
1
docs/installation.rst
2
2
docs/installation_win.rst
1
1
docs/installation_win_old.rst
1
1
setup.py
1
0 comments (0 inline, 0 general)
docs/contributing.rst
➞
Show inline comments
 
@@ -25,25 +25,25 @@ To register, you can use your Bitbucket
 
for more details.
 

			




	
	
	
		
 

			




	
	
	
		
 
Getting started

			




	
	
	
		
 
---------------

			




	
	
	
		
 

			




	
	
	
		
 
To get started with development::

			




	
	
	
		
 

			




	
	
	
		
 
        hg clone https://kallithea-scm.org/repos/kallithea

			




	
	
	
		
 
        cd kallithea

			




	
	
	
		
 
        virtualenv ../kallithea-venv

			




	
	
	
		
 
        source ../kallithea-venv/bin/activate

			




	
	
	
		
 
        pip install --upgrade pip setuptools

			




	
	
	
		
 
        pip install --upgrade pip "setuptools<34"

			




	
	
	
		
 
        pip install -e .

			




	
	
	
		
 
        paster make-config Kallithea my.ini

			




	
	
	
		
 
        paster setup-db my.ini --user=user --email=user@example.com --password=password --repos=/tmp

			




	
	
	
		
 
        paster serve my.ini --reload &

			




	
	
	
		
 
        firefox http://127.0.0.1:5000/

			




	
	
	
		
 

			




	
	
	
		
 
You can also start out by forking https://bitbucket.org/conservancy/kallithea

			




	
	
	
		
 
on Bitbucket_ and create a local clone of your own fork.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Running tests

			




	
	
	
		
 
-------------

			




        

    


    
    

    

        

                

                    docs/installation.rst
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
		
 
@@ -30,25 +30,25 @@ The following describes three different 

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Installation from repository source

			




	
	
	
		
 
-----------------------------------

			




	
	
	
		
 

			




	
	
	
		
 
To install Kallithea in a virtualenv_ using the stable branch of the development

			




	
	
	
		
 
repository, follow the instructions below::

			




	
	
	
		
 

			




	
	
	
		
 
        hg clone https://kallithea-scm.org/repos/kallithea -u stable

			




	
	
	
		
 
        cd kallithea

			




	
	
	
		
 
        virtualenv ../kallithea-venv

			




	
	
	
		
 
        source ../kallithea-venv/bin/activate

			




	
	
	
		
 
        pip install --upgrade pip setuptools

			




	
	
	
		
 
        pip install --upgrade pip "setuptools<34"

			




	
	
	
		
 
        pip install -e .

			




	
	
	
		
 
        python2 setup.py compile_catalog   # for translation of the UI

			




	
	
	
		
 

			




	
	
	
		
 
You can now proceed to :ref:`setup`.

			




	
	
	
		
 

			




	
	
	
		
 
To upgrade, simply update the repository with ``hg pull -u`` and restart the

			




	
	
	
		
 
server.

			




	
	
	
		
 

			




	
	
	
		
 
.. _installation-virtualenv:

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
Installing a released version in a virtualenv

			




	
	
		
 
@@ -60,25 +60,25 @@ main Python installation and other appli

			




	
	
	
		
 
problematic when upgrading the system or Kallithea.

			




	
	
	
		
 
An additional benefit of virtualenv_ is that it doesn't require root privileges.

			




	
	
	
		
 

			




	
	
	
		
 
- Assuming you have installed virtualenv_, create a new virtual environment

			




	
	
	
		
 
  for example, in `/srv/kallithea/venv`, using the virtualenv command::

			




	
	
	
		
 

			




	
	
	
		
 
    virtualenv /srv/kallithea/venv

			




	
	
	
		
 

			




	
	
	
		
 
- Activate the virtualenv_ in your current shell session and make sure the

			




	
	
	
		
 
  basic requirements are up-to-date by running::

			




	
	
	
		
 

			




	
	
	
		
 
    source /srv/kallithea/venv/bin/activate

			




	
	
	
		
 
    pip install --upgrade pip setuptools

			




	
	
	
		
 
    pip install --upgrade pip "setuptools<34"

			




	
	
	
		
 

			




	
	
	
		
 
.. note:: You can't use UNIX ``sudo`` to source the ``virtualenv`` script; it

			




	
	
	
		
 
   will "activate" a shell that terminates immediately. It is also perfectly

			




	
	
	
		
 
   acceptable (and desirable) to create a virtualenv as a normal user.

			




	
	
	
		
 

			




	
	
	
		
 
.. note:: Some dependencies are optional. If you need them, install them in

			




	
	
	
		
 
   the virtualenv too::

			




	
	
	
		
 

			




	
	
	
		
 
     pip install psycopg2

			




	
	
	
		
 
     pip install python-ldap

			




	
	
	
		
 

			




	
	
	
		
 
   This might require installation of development packages using your

			




        

    


    
    

    

        

                

                    docs/installation_win.rst
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
		
 
@@ -125,25 +125,25 @@ In order to install Kallithea, you need 

			




	
	
	
		
 
Some Python packages use managed code and need to be compiled.

			




	
	
	
		
 
This can be done on Linux without any special steps. On Windows, you will need to install Microsoft Visual C++ compiler for Python 2.7.

			




	
	
	
		
 

			




	
	
	
		
 
Download and install "Microsoft Visual C++ Compiler for Python 2.7" from http://aka.ms/vcpython27

			




	
	
	
		
 

			




	
	
	
		
 
.. note::

			




	
	
	
		
 
  You can also install the dependencies using already compiled Windows binaries packages. A good source of compiled Python packages is http://www.lfd.uci.edu/~gohlke/pythonlibs/. However, not all of the necessary packages for Kallithea are on this site and some are hard to find, so we will stick with using the compiler.

			




	
	
	
		
 

			




	
	
	
		
 
In a command prompt type (adapting paths if necessary)::

			




	
	
	
		
 

			




	
	
	
		
 
  cd C:\Kallithea\Env\Scripts

			




	
	
	
		
 
  activate

			




	
	
	
		
 
  pip install --upgrade pip setuptools

			




	
	
	
		
 
  pip install --upgrade pip "setuptools<34"

			




	
	
	
		
 

			




	
	
	
		
 
The prompt will change into "(Env) C:\\Kallithea\\Env\\Scripts" or similar

			




	
	
	
		
 
(depending of your folder structure). Then type::

			




	
	
	
		
 

			




	
	
	
		
 
  pip install kallithea

			




	
	
	
		
 

			




	
	
	
		
 
.. note:: This will take some time. Please wait patiently until it is fully

			




	
	
	
		
 
          complete. Some warnings will appear. Don't worry, they are

			




	
	
	
		
 
          normal.

			




	
	
	
		
 

			




	
	
	
		
 
Step 8 -- Install git (optional)

			




	
	
	
		
 
--------------------------------

			




        

    


    
    

    

        

                

                    docs/installation_win_old.rst
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
		
 
@@ -174,25 +174,25 @@ Command Prompt (**IMPORTANT!!**). To do 

			




	
	
	
		
 
Change commandline from::

			




	
	
	
		
 

			




	
	
	
		
 
%comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" x86

			




	
	
	
		
 

			




	
	
	
		
 
to::

			




	
	
	
		
 

			




	
	
	
		
 
%comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" amd64

			




	
	
	
		
 

			




	
	
	
		
 
In that CMD (loaded with VS2008 PATHs) type::

			




	
	
	
		
 

			




	
	
	
		
 
  cd C:\Kallithea\Env\Scripts (or similar)

			




	
	
	
		
 
  activate

			




	
	
	
		
 
  pip install --upgrade pip setuptools

			




	
	
	
		
 
  pip install --upgrade pip "setuptools<34"

			




	
	
	
		
 

			




	
	
	
		
 
The prompt will change into "(Env) C:\\Kallithea\\Env\\Scripts" or similar

			




	
	
	
		
 
(depending of your folder structure). Then type::

			




	
	
	
		
 

			




	
	
	
		
 
 pip install kallithea

			




	
	
	
		
 

			




	
	
	
		
 
(long step, please wait until fully complete)

			




	
	
	
		
 

			




	
	
	
		
 
Some warnings will appear, don't worry as they are normal.

			




	
	
	
		
 

			




	
	
	
		
 
Step 8 -- Configuring Kallithea

			




	
	
	
		
 
-------------------------------

			




        

    


    
    

    

        

                

                    setup.py
                

                

                  
                      
                        

                      ➞

                      
                        
                  

                  
                      
                  
                      
                  
                      
                  
                      
                  
                  
                

                

                    Show inline comments
                    
                

        

        

            



	
	
		
 
@@ -26,24 +26,25 @@ _meta.close()

			




	
	
	
		
 

			




	
	
	
		
 
callback = lambda V: ('.'.join(map(str, V[:3])) + '.'.join(V[3:]))

			




	
	
	
		
 
__version__ = _get_meta_var('VERSION', _metadata, callback)

			




	
	
	
		
 
__license__ = _get_meta_var('__license__', _metadata)

			




	
	
	
		
 
__author__ = _get_meta_var('__author__', _metadata)

			




	
	
	
		
 
__url__ = _get_meta_var('__url__', _metadata)

			




	
	
	
		
 
# defines current platform

			




	
	
	
		
 
__platform__ = platform.system()

			




	
	
	
		
 

			




	
	
	
		
 
is_windows = __platform__ in ['Windows']

			




	
	
	
		
 

			




	
	
	
		
 
requirements = [

			




	
	
	
		
 
    "setuptools<34", # setuptools==34 has an undeclared requirement of pyparsing >=2.1, but celery<2.3 requires pyparsing<2

			




	
	
	
		
 
    "waitress==0.8.8",

			




	
	
	
		
 
    "webob>=1.0.8,<=1.1.1",

			




	
	
	
		
 
    "webtest==1.4.3",

			




	
	
	
		
 
    "Pylons>=1.0.0,<=1.0.2",

			




	
	
	
		
 
    "Beaker==1.6.4",

			




	
	
	
		
 
    "WebHelpers==1.3",

			




	
	
	
		
 
    "formencode>=1.2.4,<=1.2.6",

			




	
	
	
		
 
    "SQLAlchemy==0.7.10",

			




	
	
	
		
 
    "Mako>=0.9.0,<=1.0.0",

			




	
	
	
		
 
    "pygments>=1.5",

			




	
	
	
		
 
    "whoosh>=2.4.0,<=2.5.7",

			




	
	
	
		
 
    "celery>=2.2.5,<2.3",

			




        

    



    


    



    



      

      





    
    0 comments (0 inline, 0 general)
    





    


  

  







  


    




    








    
        
    
    
        This site is powered by
            Kallithea 0.7.0,
        which is
        © 2010–2025 by various authors & licensed under GPLv3.