Skip to content

Commit 7429b97

Browse files
committed
packaged for pypi
1 parent 0ac03b5 commit 7429b97

File tree

2 files changed

+61
-21
lines changed

2 files changed

+61
-21
lines changed

README.rst

Lines changed: 55 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,83 @@
1-
=========
2-
django-cv
3-
=========
1+
==============
2+
django-vitae
3+
==============
44

5-
Django-CV is a CV generator that can be used with the `Django`_ web framework.
5+
Django-Vitae is a CV generator that can be used with the `Django`_ web framework.
66

77
.. _Django: https://docs.djangoproject.com/
88

9-
Many academics have trouble keeping CVs up to date. Django-CV was created to streamline this process. Django-CV allows users to make highly customizable curricula vitae for use on their websites. The application provides models for common entries on curricula vitae such as education, employment, publications, teaching, and service. Django-CV eliminates many of the repetitive tasks related to producing curricula vitae. The included templates provide a complete CV "out of the box", but allows researchers who might be interested in customizing the format using Django templating language.
9+
Many academics have trouble keeping CVs up to date. Django-Vitae was created to streamline this process. Django-Vitae allows users to make highly customizable curricula vitae for use on their websites. The application provides models for common entries on curricula vitae such as education, employment, publications, teaching, and service. Django-Vitae eliminates many of the repetitive tasks related to producing curricula vitae. The included templates provide a complete CV "out of the box", but allows researchers who might be interested in customizing the format using Django templating language.
1010

11-
Django-CV uses `semantic versioning`_. Though it aims to provide a complete suite to create a CV, the project does not been tested extensively (and **you** can contribute to that effort!) and pieces might still throw errors. See notes below for quirks and errors in usage that must be resolved.
11+
Django-Vitae uses `semantic versioning`_. Though it aims to provide a complete suite to create a CV, the project does not been tested extensively (and **you** can contribute to that effort!) and pieces might still throw errors. See notes below for quirks and errors in usage that must be resolved.
1212

1313
.. _semantic versioning: http://semver.org/
1414

1515

1616
Requirements
1717
------------
1818

19-
Django-CV is developed and tested in Python 3. It depends on several external packages (other than Django):
19+
Django-Vitae is developed and tested in Python 3. It depends on several external packages (other than Django):
2020

2121
* `Markdown <https://pypi.org/project/Markdown/>`_ (makes pretty HTML with simple text entries)
22-
* `Nose`_ & `django-nose`_ (used for testing suite)
23-
* `Coverage`_ (used to document testing coverage)
2422
* `citeproc-py <https://pypi.org/project/citeproc-py/>`_ (creates citations formatted according to desired `CSL`_ styles [not yet implemented])
2523
* `citeproc-py-styles <https://pypi.org/project/citeproc-py-styles/>`_ (adds library of `CSL`_ styles)
2624

2725
.. _CSL: http://citationstyles.org/
26+
27+
Installation
28+
------------
29+
From `PyPI <https://pypi.org/>`_ for the latest version::
30+
31+
pip install django-vitae
32+
33+
For the latest development version:
34+
35+
::
36+
37+
git clone https://github.com/mikebader/django-vitae
38+
cd django-vitae
39+
python setup.py install
40+
41+
42+
43+
Documentation
44+
-------------
45+
46+
Limited documentation is available in the ``docs`` directory.
47+
48+
Testing
49+
-------
50+
To test, you need to install the following packages:
51+
52+
* `Nose`_ & `django-nose`_ (used for testing suite)
53+
* `Coverage`_ (used to document testing coverage)
54+
2855
.. _Nose: https://pypi.org/project/nose/
2956
.. _django-nose: https://pypi.org/project/nose/
3057
.. _Coverage: https://pypi.org/project/coverage/
3158

32-
Testing
33-
-------
34-
An incomplete test suite can be found in the ``tests/`` directory. With `Nose`_ and `Coverage`_ installed, you may run the tests with ``runtests.py``.
59+
::
60+
61+
pip install nose
62+
pip install django-nose
63+
pip install coverage
64+
65+
An incomplete test suite can be found in the ``tests/`` directory. With `Nose`_ and `Coverage`_ installed, you may run the tests with ``runtests.py``. From the ``django-vitae`` root directory:
66+
67+
::
68+
69+
./runtests.py
70+
71+
72+
To test only a single model, you may use the flag ``--attr=<model_name>`` for the model (not implemented for all models). For example, to test books, you would use:
73+
74+
::
75+
76+
./runtests.py --attr=book
77+
3578

3679

3780
Use Issues
3881
----------
3982

4083
At present, you will have the best luck editing model instances in the ``admin`` interface. You should be able to edit some models in interface implemented in the default templates, but many do not work or are not fully implemented.
41-
42-
You may find limited documentation in the ``docs/`` directory.
43-

setup.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,21 @@
44
long_description = f.read()
55

66
setuptools.setup(
7-
name='django-cv',
8-
version='0.0.2.1',
7+
name='django-vitae',
8+
version='0.0.1',
99
author='Michael Bader',
1010
author_email='michaeldmbader@gmail.com',
1111
description='A CV generator built for the Django web framework.',
1212
long_description=long_description,
1313
long_description_content_type='text/markdown',
14-
url='https://github.com/mikebader/django-cv',
14+
url='https://github.com/mikebader/django-vitae',
1515
packages=setuptools.find_packages(),
1616
install_requires=[
1717
'django>=1.11',
18-
'markdown>=2.6',
19-
'citeproc-py>=0.4',
18+
'markdown>=2.6.11',
19+
'citeproc-py>=0.4.0',
2020
'citeproc-py-styles>=0.1.1',
21-
'django-widgets>=0.1.16'
21+
'django-widgets>=-0.1.16'
2222
],
2323
classifiers=[
2424
'Development Status :: 3 - Alpha',

0 commit comments

Comments
 (0)