|pypi| |actions| |coverage|
edc-search
----------
Add a slug field to models using the model mixin ``SearchSlugModelMixin``. Specify the fields and/or properties to include in the ``slug`` in ``search_slug_fields``:
.. code-block:: python
class TestModel(SearchSlugModelMixin, models.Model):
search_slug_fields = ['f1', 'f2', 'f3']
f1 = models.CharField(max_length=25, null=True)
f2 = models.DateTimeField(null=True)
f3 = models.IntegerField(null=True)
f4 = models.CharField(max_length=25, null=True)
Fields in the ``search_slug_fields`` are converted to string in the slug:
.. code-block:: python
>>> obj = TestModel.objects.create(f1='run rabbit run!', f2=get_utcnow(), f3=12345)
>>> obj.slug
'run-rabbit-run!|2017-06-02 19:08:32.163520+00:00|12345'
Fields not listed are not included:
.. code-block:: python
>>> obj = TestModel.objects.create(f1='slug me', f4='don\'t slug me')
>>> obj.slug
'slug-me||'
``Null`` fields are converted to ``''``:
.. code-block:: python
>>> obj = TestModel.objects.create()
>>> obj.slug
'||'
You can use dotted syntax:
.. code-block:: python
class TestModel(SearchSlugModelMixin, models.Model):
search_slug_fields = ['f1', 'name.first', 'name.last']
f1 = models.CharField(max_length=25, null=True)
def name(self):
return FullName(first='Gore', last='Vidal')
>>> obj = TestModel.objects.create()
>>> obj.slug
'|Gore|Vidal'
.. |pypi| image:: https://img.shields.io/pypi/v/edc-search.svg
:target: https://pypi.python.org/pypi/edc-search
.. |actions| image:: https://github.com/clinicedc/edc-search/workflows/build/badge.svg?branch=develop
:target: https://github.com/clinicedc/edc-search/actions?query=workflow:build
.. |coverage| image:: https://coveralls.io/repos/github/clinicedc/edc-search/badge.svg?branch=develop
:target: https://coveralls.io/github/clinicedc/edc-search?branch=develop
Raw data
{
"_id": null,
"home_page": "https://github.com/clinicedc/edc-search",
"name": "edc-search",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "django Edc search,clinicedc,clinical trials",
"author": "Erik van Widenfelt",
"author_email": "ew2789@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/87/12/b8f42d8117633001ea818b73960c1c648f5f34ca7d46a937acb319f5d967/edc-search-0.3.11.tar.gz",
"platform": null,
"description": "|pypi| |actions| |coverage|\n\nedc-search\n----------\n\nAdd a slug field to models using the model mixin ``SearchSlugModelMixin``. Specify the fields and/or properties to include in the ``slug`` in ``search_slug_fields``:\n\n\n.. code-block:: python\n\n class TestModel(SearchSlugModelMixin, models.Model):\n\n search_slug_fields = ['f1', 'f2', 'f3']\n\n f1 = models.CharField(max_length=25, null=True)\n f2 = models.DateTimeField(null=True)\n f3 = models.IntegerField(null=True)\n f4 = models.CharField(max_length=25, null=True)\n\nFields in the ``search_slug_fields`` are converted to string in the slug:\n\n.. code-block:: python\n\n >>> obj = TestModel.objects.create(f1='run rabbit run!', f2=get_utcnow(), f3=12345)\n >>> obj.slug\n 'run-rabbit-run!|2017-06-02 19:08:32.163520+00:00|12345'\n\nFields not listed are not included:\n\n.. code-block:: python\n\n >>> obj = TestModel.objects.create(f1='slug me', f4='don\\'t slug me')\n >>> obj.slug\n 'slug-me||'\n\n``Null`` fields are converted to ``''``:\n\n.. code-block:: python\n\n >>> obj = TestModel.objects.create()\n >>> obj.slug\n '||'\n\nYou can use dotted syntax:\n\n.. code-block:: python\n\n class TestModel(SearchSlugModelMixin, models.Model):\n\n search_slug_fields = ['f1', 'name.first', 'name.last']\n\n f1 = models.CharField(max_length=25, null=True)\n\n def name(self):\n return FullName(first='Gore', last='Vidal')\n\n >>> obj = TestModel.objects.create()\n >>> obj.slug\n '|Gore|Vidal'\n\n\n.. |pypi| image:: https://img.shields.io/pypi/v/edc-search.svg\n :target: https://pypi.python.org/pypi/edc-search\n\n.. |actions| image:: https://github.com/clinicedc/edc-search/workflows/build/badge.svg?branch=develop\n :target: https://github.com/clinicedc/edc-search/actions?query=workflow:build\n\n.. |coverage| image:: https://coveralls.io/repos/github/clinicedc/edc-search/badge.svg?branch=develop\n :target: https://coveralls.io/github/clinicedc/edc-search?branch=develop\n",
"bugtrack_url": null,
"license": "GPL license, see LICENSE",
"summary": "Simple edc-search forms and view mixins for the clinicedc/edc",
"version": "0.3.11",
"project_urls": {
"Homepage": "https://github.com/clinicedc/edc-search"
},
"split_keywords": [
"django edc search",
"clinicedc",
"clinical trials"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "33f34895a2572b25b456996bef0e88adf6dcbd3926202deef13b10659fe55bb4",
"md5": "fa58f2dbaccb0d0cb1d410ccdbed0863",
"sha256": "08386e4e56556b665f7f66bdf8c60c9371cdd4005df4fec80bebe06596b90557"
},
"downloads": -1,
"filename": "edc_search-0.3.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fa58f2dbaccb0d0cb1d410ccdbed0863",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 25742,
"upload_time": "2024-02-13T17:44:51",
"upload_time_iso_8601": "2024-02-13T17:44:51.041403Z",
"url": "https://files.pythonhosted.org/packages/33/f3/4895a2572b25b456996bef0e88adf6dcbd3926202deef13b10659fe55bb4/edc_search-0.3.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8712b8f42d8117633001ea818b73960c1c648f5f34ca7d46a937acb319f5d967",
"md5": "4076eec4329909b4968c71d91b844edd",
"sha256": "c4ee4fc3f6c234c0fa31fd2ee579adb128306d9c78d101977a73ea5631ec9682"
},
"downloads": -1,
"filename": "edc-search-0.3.11.tar.gz",
"has_sig": false,
"md5_digest": "4076eec4329909b4968c71d91b844edd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 28143,
"upload_time": "2024-02-13T17:44:53",
"upload_time_iso_8601": "2024-02-13T17:44:53.001696Z",
"url": "https://files.pythonhosted.org/packages/87/12/b8f42d8117633001ea818b73960c1c648f5f34ca7d46a937acb319f5d967/edc-search-0.3.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-13 17:44:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "clinicedc",
"github_project": "edc-search",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "edc-search"
}