allink-core

allink-core is a heavily opinionated collection of django apps, django-cms plugins and other utilities. allink-core was implemented to create a standardized ecosystem for django-cms projects developed at allink AG.

allink-core is ment to be used with our boilerplate project which is hosted on the divio cloud. (feel free to send us a message if you would like to have a look.) The steps we describe here are mostly closely coupled to our setup and environment. So the described steps might not make sense to you, when you don't know our setup. Also we skip steps which we already included in the boilerplate.

Documentation

v2.0.x

Working on documentation

make docs will serve you a preview of the local docs on "http://127.0.0.1:8000". More Information on mkdocs.org or mkdocs rtd.

Workflow when making updates to allink-core repo while working on a project.

The idea is that we want to be able to make changes to the allink-core repo with real life data. This can be achieved, when we are able to switch out the installed allink-core form the requirements.in with a local allink-core repo. This way we can also maintain a proper git history.

Prepare allink-core repository

To work on the allink-core repo you first need to pull the allink-core repo. The setup expects it to be at "~/projects/allink-core". If it isn't in this location, just create a symlink which points to your allink-core repo.

  1. make sure you are up to date with the current version branch e.g "v2.0.x" and you working on your own branch.
  2. create a virtualenv virtualenv env
  3. install requirements pip install -r requiremnts_dev.txt

For the next steps, we assume you are working on the boilerplate-2.0 project, but this should work with every project which follows the same principles and have allink-core installed.

Prepare boilerplate-2.0 repository

  1. To override the already installed allink-core requirements, we have to mount the local allink-core directory as a volume into the docker container. Add - "~/projects/allink-core/allink_core:/app/allink_core:rw" to the docker-compose.yml file.
  2. To work directly on allink-core in the same directory as the boilerplate-project, we create a symlink. ln -s ~/projects/allink-core/allink_core allink_core

Make sure you do not commit these changes, as your teammates probably do not care about having a local allink-core mapped in their project.

You are all set. When you now run docker-compose up your application will run with your local allink-core repo. However if you run docker-compose build you will still be installing the allink-core repo from the requirements file.

create a new release of allink-core

  1. create a new pull request (make sure you include your changes to CHANGELOG.md)
  2. merge back to version branch e.g v2.0.x
  3. make patch or make minor depending on what version you want to create. (this will create a new commit and push the new tags to github) If you need an other version do it with bumpversion.
  4. create a new release on PyPi make publish (make sure you have the correct credentials for allink in your ~/.pypirc also for test-pypi)

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.8.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for allink from gravatar.com allink

Credits

Author: allink AG and contributors

License

BSD License (BSD License)

Classifiers

Report project as malware

Release files for allink-core 2.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for allink-core 2.2.1
File Size Uploaded
allink-core-2.2.1.tar.gz 259.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for allink-core 2.2.1
File Interpreter ABI Platform
allink_core-2.2.1-py3-none-any.whl 581.6 kB Python 3 none any Details

Total release size: 841.4 kB

Release history Release notifications | RSS feed

2.8.2

2 release files

2.8.1

2 release files

2.8.0

2 release files

2.7.2

2 release files

2.7.1

2 release files

2.7.0

2 release files

2.6.3

2 release files

2.6.2

2 release files

2.6.1

2 release files

2.6.0

2 release files

2.5.4

2 release files

2.5.3

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.5.0

2 release files

2.4.0

2 release files

2.3.3

2 release files

2.3.2

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.3

2 release files

2.2.2

2 release files

This release

2.2.1 This release

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.8

2 release files

2.0.7

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page