Add project_title in Project and create_project

[jwijffels]

What's in the PR
Project gains attribute project_title and create_project gains argument project_title
Linked to inception-project/inception#5156

How to test manually

from pycaprio import Pycaprio
client = Pycaprio(inception_host = host, authentication = (user, password))
projects = client.api.projects()
print(projects)
projects[0].project_title

proj = client.api.create_project("hello_world", project_title = "Hello World", creator_name="other user")
proj.project_title

Automatic testing

• PR includes unit tests

Documentation

• PR updates documentation

[reckart]

@jwijffels Thanks for the PR. The linter fails. Try running make lint. I thought we had a make black as well... maybe that went missing when I changed the build setup...

I think it might be helpful if the pycaprio API mapped the fields not as in the response, but rather as what they mean:

• title -> name
• name -> slug

WDYT?

[jwijffels]

Thanks for taking over the maintenance of pycaprio!

I'll look into the linter.

About the change of title = name, name = slug, For me ok, but that's a breaking change. Not sure what is your position on breaking changes.

[reckart]

About the change of title = name, name = slug, For me ok, but that's a breaking change. Not sure what is your position on breaking changes.

I try to avoid them. That is why I didn't change the properties in the HTTP response JSON when I changed the name to be the slug and added the title. Because at the time, I couldn't make pycaprio releases and if I had made that change, it would have broken pycaprio for everybody.

However, we are pre-1.0.0. Also I think it is confusing if the names do not reflect the semantics.

I don't have a very strong opinion, but at some point, it needs to be changed anyway - so why not now?

If you have a better idea or different opinion, glad to hear it.

[jwijffels]

My preference is to always be backwards compatible where possible to avoid breaking changes but if you intend to have a lot more changes planned, yes it makes sense to do them. This slug/name also already got me confused as well :)