Skip to content

webqueue2-api repository plan #196

Closed
benne238 opened this issue Feb 22, 2021 · 3 comments
Closed

webqueue2-api repository plan #196

benne238 opened this issue Feb 22, 2021 · 3 comments
Assignees
Labels
documentation Related to the writing documentation or the tools used to generate docs
Projects

Comments

@benne238
Copy link
Collaborator

To make development easier, the backend will (eventually) be completely moved to a new repository. This presents a number of configuration changes including:

  • Development tools, specifically creating new scripts to replace npm
  • Versioning and being able to install the backend from github in production
  • How to implement "nested" git directories in the frontend (potentially, however this might be more of a front end issue)

The biggest of these issues is being able to allow the backend to be easily installed for production via pip most likely.

Next steps

  • Determining how github python packages work and being able to answer these specific questions:

    • what version of a package is installed by default?
    • how does installing via pip from a github repo affect the version number when running pip freeze?
    • is it possible to specify a version of a python package to install when installing from github, and is it possible to do this without using tags as mentioned in this comment?
    • determine a work flow for the frontend when installing the backend in regard to different versions of the backend being accessible, so communicating what changes occur from version to version is important
  • Creating (a) custom script(s) that replace npm to:

    • Create, reset, and delete the virtual environment
    • Activate and deactivate the virtual environment (possibly)
    • Run the api locally to test changes
@campb303
Copy link
Collaborator

Some comments:

How to implement "nested" git directories in the frontend (potentially, however this might be more of a front end issue)

Look into git sub-modules.

is it possible to specify a version of a python package to install when installing from github, and is it possible to do this without using tags as mentioned in this comment?

Why not use tags? We'd talked about the want for version numbers to match release versions but this can be done just by using the same version number in the Python package and in the git tag.

determine a work flow for the frontend when installing the backend in regard to different versions of the backend being accessible, so communicating what changes occur from version to version is important

Versioning can and should be done via a requirements file for pip. Communicating changes can be done via release notes.

Activate and deactivate the virtual environment (possibly)

This shouldn't be necessary as VSCode understands virtual environments and auto activates during debugging and it is a single source path/to/venv/bin/activate command to activate manually.

@campb303
Copy link
Collaborator

campb303 commented Mar 5, 2021

Current work for this is being tracked in #159

@campb303 campb303 added api documentation Related to the writing documentation or the tools used to generate docs labels Mar 5, 2021
@campb303 campb303 added this to the v1-proof-of-concept milestone Mar 5, 2021
@campb303 campb303 added this to In progress in v1.0 Mar 8, 2021
@campb303
Copy link
Collaborator

The API has now been migrated to a standalone repository and can be installed via pip or a requirements file. Closing.

v1.0 automation moved this from In progress to Done Mar 12, 2021
Sign in to join this conversation on GitHub.
Labels
documentation Related to the writing documentation or the tools used to generate docs
Projects
No open projects
v1.0
  
Done
Development

No branches or pull requests

2 participants