معرفی شرکت ها

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

توضیحات

Shared components library for Great services.

ویژگی	مقدار
سیستم عامل	-
نام فایل	directory-components-9.9.0
نام	directory-components
نسخه کتابخانه	9.9.0
نگهدارنده	[]
ایمیل نگهدارنده	[]
نویسنده	Department for Business and Trade
ایمیل نویسنده	-
آدرس صفحه اصلی	https://github.com/uktrade/directory-components
آدرس اینترنتی	https://pypi.org/project/directory-components/
مجوز	MIT

# directory-components [![code-climate-image]][code-climate] [![circle-ci-image]][circle-ci] [![codecov-image]][codecov] [![pypi-image]][pypi] [![semver-image]][semver] **Reusable components used across the GREAT platform for the Department for Business and Trade.** --- ## Installation pip install directory-components ## Development $ git clone https://github.com/uktrade/directory-components $ cd directory-components $ [create virtual environment and activate] $ make install_requirements To test cookies locally add this to your /etc/hosts: ``` 127.0.0.1 components.trade.great ``` Then visit the demo at `components.trade.great:9013` ### Commands | Command | Description | | ----------------------------- | ------------| | make clean | Delete pyc files | | make pytest | Run all tests. Run `pip install .[test] first` | | make pytest test_foo.py | Run all tests in file called test_foo.py | | make pytest -- --last-failed` | Run the last tests to fail | | make pytest -- -k foo | Run the test called foo | | make pytest -- <foo> | Run arbitrary pytest command | | make flake8 | Run linting | | make manage <foo> | Run arbitrary management command | | make webserver | Run the demo development web server. Run `pip install .[demo] first` | | make requirements | Compile the requirements file | | make install_requirements | Installed the compile requirements file | | make css | Compile scss to css | | make publish | Publish the package to PyPI | ## Features ### Environment variables | Environment variable | Notes | |--------------------------------------------------- |------------------------------------------------| | `FEATURE_MAINTENANCE_MODE_ENABLED` | Controls `MaintenanceModeMiddleware`. | | `FEATURE_FLAGS` | Place to store the service's feature flags. | | `DIRECTORY_COMPONENTS_VAULT_DOMAIN` | Hashicorp vault domain. For diffing vaults. | | `DIRECTORY_COMPONENTS_VAULT_ROOT_PATH` | Hashicorp vault root path. For diffing vaults. | | `DIRECTORY_COMPONENTS_VAULT_PROJECT` | Hashicorp vault project. For diffing vaults. | | `DIRECTORY_COMPONENTS_VAULT_IGNORE_SETTINGS_REGEX` | Settings to ignore when diffing vaults. | ### Middleware Middleware can be found in `directory_components.middleware.FooBar`. | Middleware | Notes | |------------|-------| | `MaintenanceModeMiddleware` | Redirects to http://sorry.great.gov.uk if `FEATURE_MAINTENANCE_MODE_ENABLED` is `true`.| | `NoCacheMiddlware` | Prevents any page in the service from caching pages of logged in users. | | `PrefixUrlMiddleware` | Redirects use from unprefixed url to prefixed url. | ### Context processors Middleware can be found in `directory_components.context_processors.foo_bar`. | Processor | Context variable name | Notes | |-----------|-----------------------|-------| | `sso_processor` | | Exposes the state of the SSO user. | | `analytics` | `directory_components_analytics` | GA details. Used by base template. | | `header_footer_processor` | `header_footer_urls` | Urls used by base template's header and footer. | | `urls_processor` | `directory_components_urls` | More urls used by base template's header and footer. | | `feature_flags` | `feature_flags` | Exposes the service's feature flags. | ### Exception handlers Add the following to your urls.py for directory components templates to be used on 404 and 500 ``` handler404 = 'directory_components.views.handler404' handler500 = 'directory_components.views.handler500' ``` Without doing this the 500 and 400 pages would not receive context data provided by context processors ## Settings janitor Management commands are provided to assist in the maintenance of settings. Install by `pip install directory-components[janitor]` and then add the following to `settings.py`: if some_predicate_is_met: # feature flagged so it's not used in prod INSTALLED_APPS.append('directory_components.janitor') ### Diff vaults You can diff the vaults of two environments by running the following. manage.py vault_diff \ --token=<token> \ --domain=<domain> \ --root=<root> \ --project=<project> \ --environment_a=<environment_a> \ --environment_b=<environment_b> For simplicity once you set the `DIRECTORY_COMPONENTS_VAULT_DOMAIN`, `DIRECTORY_COMPONENTS_VAULT_PROJECT`, and `DIRECTORY_COMPONENTS_VAULT_ROOT_PATH` that simplifies to manage.py environment_diff \ --token=<token> \ --environment_a=<environment_a> \ --environment_b=<environment_b> ### Update vaults You can batch update the vaults of all your environments by running the following manage.py vault_update -- \ --token=<token> \ --domain=<domain> \ --root=<root> \ --mutator='path.to.function' `mutator` is the path to a function relative to the project root. The call signature is `secrets=dict, path=str`. The return dict will be uploaded to vault. For simplicity once you set the `DIRECTORY_COMPONENTS_VAULT_DOMAIN`, and `DIRECTORY_COMPONENTS_VAULT_ROOT_PATH` that simplifies to: manage.py vault_update \ --token=<token> \ --mutator='path.to.function' ### Detect settings orphans You can detect settings that are either unused in the codebase, redundant because they're explicitly set to the default django value, or obsolete because they're set in the vault but not used anywhere: manage.py settings_shake \ --token=<token> \ --root=<root> \ --domain=<domain> \ --project=<project> \ --environment=<environment> For simplicity once you set the `DIRECTORY_COMPONENTS_VAULT_DOMAIN`, `DIRECTORY_COMPONENTS_VAULT_PROJECT`, and `DIRECTORY_COMPONENTS_VAULT_ROOT_PATH` that simplifies to manage.py settings_shake \ --token=<token> \ --environment=<environment> ## Publish to PyPI The package should be published to PyPI on merge to master. If you need to do it locally then get the credentials from rattic and add the environment variables to your host machine: | Setting | | ----------------------------- | | `DIRECTORY_PYPI_USERNAME` | | `DIRECTORY_PYPI_PASSWORD` | Then run the following command: make publish [code-climate-image]: https://codeclimate.com/github/uktrade/directory-components/badges/issue_count.svg [code-climate]: https://codeclimate.com/github/uktrade/directory-components [circle-ci-image]: https://circleci.com/gh/uktrade/directory-components/tree/master.svg?style=shield [circle-ci]: https://circleci.com/gh/uktrade/directory-components/tree/master [codecov-image]: https://codecov.io/gh/uktrade/directory-components/branch/master/graph/badge.svg [codecov]: https://codecov.io/gh/uktrade/directory-components [pypi-image]: https://badge.fury.io/py/directory-components.svg [pypi]: https://badge.fury.io/py/directory-components [semver-image]: https://img.shields.io/badge/Versioning%20strategy-SemVer-5FBB1C.svg [semver]: https://semver.org

نیازمندی

مقدار	نام
<4.0.0,>=1.11	django
<5.0.0,>=4.6.0	beautifulsoup4
<24.0.0,>=23.0.0	directory-constants
<4.0.0,>=3.0.1	jsonschema
==0.1.1	lorem
==0.4.5	django-environ
==19.5.0	gunicorn
==3.3.1	whitenoise
==0.3.0	django-pygments
<1.0.0,>=0.9.5	hvac
<2.0.0,>=1.0.0	vulture
<2.0.0,>=1.1.8	ansicolors
==0.1.1	lorem
==1.1.8	ansicolors
==2.1.9	codecov
==5.0.4	flake8
==2.6.1	pytest-cov
==3.3.0	pytest-django
-	pytest-sugar
==3.6.0	pytest
==0.8.0	requests-toolbelt
==2.18.1	requests
<2.0.0,>=1.11.0	twine
<1.0.0,>=0.31.0	wheel
<39.0.0,>=38.6.0	setuptools

نحوه نصب

نصب پکیج whl directory-components-9.9.0:

pip install directory-components-9.9.0.whl

نصب پکیج tar.gz directory-components-9.9.0:

pip install directory-components-9.9.0.tar.gz