feat: add utils for creating files

[Yelinz]

avoids forgetting to set encryption_status

[winged]

Code LGTM, but a few things to note:

• Rename the utils.py to api.py (similar to Caluma, where the public python API is also in an api module)
• Add some docstrings to explain what the functions do
• Add some documentation (README.md or create a new file PYTHON_API.md or similar)

[winged]

Thought about the whole thing some more, and I think for a "public" API, we need to refine it a bit more. Good work so far though!

[winged]

Since there are some required arguments, it may make sense to have them listed directly in the arguments. That way, it's clear without even needing to document them.

The file arguments could be renamed, so as to show which ones are required as well. Maybe something like this:

Suggested change

	def create_document_file(user, group, document_attributes, file_attributes):
	def create_document_file(
	user,
	group,
	category,
	title,
	file_name,
	file_content,
	mime_type,
	file_size,
	additional_attributes=None,
	additional_file_attributes=None
	):
	additional_attributes = additional_attributes or {}
	additional_file_attributes = additional_file_attributes or {}

[winged]

I would suggest renaming the **attributes / **file_attributes to **additional_attributes, to further show that they're additional to the regular ones.

Otherwise, the PR looks good now, and ready to merge

[Yelinz]

Done

[winged]

Thought about the whole thing some more, and I think for a "public" API, we need to refine it a bit more. Good work so far though!

Yet another thought: some of the functionality could probably be put into django signal handlers instead (before_save for determining a file's size, post_save for creating the thumbnail).

[Yelinz]

Thought about the whole thing some more, and I think for a "public" API, we need to refine it a bit more. Good work so far though!

Yet another thought: some of the functionality could probably be put into django signal handlers instead (before_save for determining a file's size, post_save for creating the thumbnail).

Could be considered for a seperate PR, as that would introduce some more code overhaul. We can open an issue for this.
Changed the api to be more explicit, previously I kept it with dicts, to be more flexible(category or category_id).

[winged]

Nice work! Please squash before merge though, we don't need all intra-PR fixes in the history