Support creating local VCS components using API

[nijel]

Is your feature request related to a problem? Please describe.
The component creation API right now supports only creating components from remote VCS. It should also support no remote VCS setup where initial file is either created by Weblate or provided by upload.

In other words, it should support following workflows supported in the UI:

• Upload translations files - upload more files in a ZIP
• Translate document - upload main file
• Start from scratch - no file provided, starts with blank one

Describe the solution you'd like
Extend https://docs.weblate.org/en/latest/api.html#post--api-projects-(string-project)-components- to support local vcs.

Describe alternatives you've considered
Right now, this is not supported over API, but I don't think it's a viable approach.

Additional context
The related code is currently placed in the view, but should be shared for the API, not sure if it makes sense to move it to the models.

For example, creating component from scratch si here:

weblate/weblate/trans/views/create.py

Lines 54 to 72 in 9399189

	def scratch_create_component(project, name, slug, file_format):
	format_cls = FILE_FORMATS[file_format]
	template = "{}.{}".format(project.source_language.code, format_cls.extension())
	fake = Component(project=project, slug=slug, name=name)
	# Create VCS with empty file
	LocalRepository.from_files(
	fake.full_path, {template: format_cls.get_new_file_content()}
	)
	# Create component
	return Component.objects.create(
	file_format=file_format,
	filemask="*.{}".format(format_cls.extension()),
	template=template,
	vcs="local",
	repo="local:",
	project=project,
	name=name,
	slug=slug,
	)

[github-actions]

This issue has been added to the backlog. It is not scheduled on our roadmap, but it eventually might be implemented. In case you desperately need this feature, please consider helping or funding the development.

[nijel]

I've just implemented basics start from scratch in d9bfab2

[github-actions]

Thank you for your report, the issue you have reported has just been fixed.

• In case you see a problem with the fix, please comment on this issue.
• In case you see a similar problem, please open a separate issue.
• If you are happy with the outcome, consider supporting Weblate by donating.

[EpocDotFr]

Thank you!

[walhallyus]

It's there a way to create a component from scratch through the API?

Basically this is what I want to achieve through api:

• create a project through api
• create multiple components through api
• add strings to components through api
• translate this strings in weblate UI
• extract translated strings through api

I would appreciate an opinion from someone, if weblate can help me with that

[nijel]

You need to start from something - either pass zipfile or docfile in the API. The files can be blank, but adding at strings at once will perform better than adding them one by one later.