Welcome to Nobinobi Staff’s documentation!¶

Contents:

Nobinobi Staff¶

Application staff for nobinobi

Documentation¶

The full documentation is at https://nobinobi-staff.readthedocs.io.

Quickstart¶

Install Nobinobi Staff:

pip install nobinobi-staff

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'nobinobi_staff.apps.NobinobiStaffConfig',
    ...
)

Add Nobinobi Staff’s URL patterns:

from nobinobi_staff import urls as nobinobi_staff_urls


urlpatterns = [
    ...
    path('', include(nobinobi_staff_urls)),
    ...
]

Features¶

TODO

Running Tests¶

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Development commands¶

pip install -r requirements_dev.txt
invoke -l

Credits¶

Tools used in rendering this package:

Installation¶

At the command line:

$ easy_install nobinobi-staff

Or, if you have virtualenvwrapper installed:

$ mkvirtualenv nobinobi-staff
$ pip install nobinobi-staff

Usage¶

To use Nobinobi Staff in a project, add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'nobinobi_staff.apps.NobinobiStaffConfig',
    ...
)

Add Nobinobi Staff’s URL patterns:

from nobinobi_staff import urls as nobinobi_staff_urls


urlpatterns = [
    ...
    path('', include(nobinobi_staff_urls)),
    ...
]

Contributing¶

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

You can contribute in many ways:

Types of Contributions¶

Report Bugs¶

Report bugs at https://github.com/prolibre-ch/nobinobi-staff/issues.

If you are reporting a bug, please include:

Your operating system name and version.
Any details about your local setup that might be helpful in troubleshooting.
Detailed steps to reproduce the bug.

Fix Bugs¶

Look through the GitHub issues for bugs. Anything tagged with “bug” is open to whoever wants to implement it.

Implement Features¶

Look through the GitHub issues for features. Anything tagged with “feature” is open to whoever wants to implement it.

Write Documentation¶

Nobinobi Staff could always use more documentation, whether as part of the official Nobinobi Staff docs, in docstrings, or even on the web in blog posts, articles, and such.

Submit Feedback¶

The best way to send feedback is to file an issue at https://github.com/prolibre-ch/nobinobi-staff/issues.

If you are proposing a feature:

Explain in detail how it would work.
Keep the scope as narrow as possible, to make it easier to implement.
Remember that this is a volunteer-driven project, and that contributions are welcome :)

Get Started!¶

Ready to contribute? Here’s how to set up nobinobi-staff for local development.

Fork the nobinobi-staff repo on GitHub.

Clone your fork locally:

$ git clone git@github.com:your_name_here/nobinobi-staff.git

Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development:
```
$ mkvirtualenv nobinobi-staff
$ cd nobinobi-staff/
$ python setup.py develop
```
Create a branch for local development:
```
$ git checkout -b name-of-your-bugfix-or-feature
```
Now you can make your changes locally.
When you’re done making changes, check that your changes pass flake8 and the tests, including testing other Python versions with tox:
```
$ flake8 nobinobi_staff tests
$ python setup.py test
$ tox
```
To get flake8 and tox, just pip install them into your virtualenv.

Commit your changes and push your branch to GitHub:

$ git add .
$ git commit -m "Your detailed description of your changes."
$ git push origin name-of-your-bugfix-or-feature

Submit a pull request through the GitHub website.

Pull Request Guidelines¶

Before you submit a pull request, check that it meets these guidelines:

The pull request should include tests.
If the pull request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.rst.
The pull request should work for Python 2.6, 2.7, and 3.3, and for PyPy. Check https://travis-ci.org/prolibre-ch/nobinobi-staff/pull_requests and make sure that the tests pass for all supported Python versions.

Tips¶

To run a subset of tests:

$ python -m unittest tests.test_nobinobi_staff

Credits¶

Development Lead¶

Florian Alu <alu@prolibre.com>

Contributors¶

None yet. Why not be the first?

History¶

0.1.6.10 (2023-06-19)¶

Update requirements

0.1.6.9 (2023-06-14)¶

Update requirements

0.1.6.8 (2021-12-23)¶

879490a - filter on choice staff absence only active staff
d04ba24 - Fix bug when save staff for training

0.1.6.7 (2021-12-22)¶

c19f6cb - Filter by default to staff active in list admin
dd97bda - Fix requirements

0.1.6.6 (2021-12-14)¶

7562c55 - Change str format in full name by last_name - first_name
78bf3e3 - Fix error import
Update requirements

0.1.6.5.2 (2021-09-29)¶

022c118 - Fix import missing in commands
Update requirements

0.1.6.5.1 (2021-09-17)¶

002cb4c - fix bug with search field icontains

0.1.6.5 (2021-09-17)¶

c4dd7a1 - Add search field for training
3a28df3 - Fix error with generate command when staffs args filled

0.1.6.4 (2021-09-17)¶

7599706 - Update traduction
0581582 - Update system to generate and update training auto
a60c325 - Add default_auto_field

0.1.6.3 (2021-09-16)¶

4d973ec - Update “update command” for training
184406d - Change signals to update training when absence
88245dd - Change admin display in training add select related in staff
2a0b8f8 - Add method to get datetime_range in model add tracker in absence to get previous date

0.1.6.2 (2021-09-14)¶

Update requirements.
2fb2bfa - Add signal when absence is saved and training not created

0.1.6.1 (2021-06-07)¶

Update requirements.
Update django for security fix

0.1.6 (2021-04-13)¶

186a796 - Fix upload publish
Update requirements.

0.1.5 (2021-03-12)¶

Add an export function for Absence
Update requirements.
Update traduction FR.

0.1.4 (2020-10-29)¶

Add fields [“picture”, “nationality”, “civil_status”, “status”, “status_modified”, “created”, “modified”].
Rename field “avs” to “social_security_number”.
Rename field “active” to “active_status”.
Add method to archive staff when select in admin staff list.
Update search_field, list_display, list_filter fields.
Remove load absence_type auto, now you have to load data.
Update traduction FR.

0.1.3.1 (2020-09-08)¶

Update for staff

0.1.3 (2020-08-28)¶

Update

0.1.0 (2020-08-20)¶

First release on PyPI.