Package: island
Lutinislandis a generic source downloader and synchronizer is a FREE software tool.It is compatible with basic format of repo-git manifest. This project is created to be easiest to read with simple interface
(no internal git usage, but user level git usage) The main point to create the "fork" is the non-support of repo of relativity
in submodule of git (submodule reference with ../xxx.git) This point is really important when you want to have a relocate
manifest and project with submodule. The simpl example is the atria-soft / generic-library / musicdsp that are available on
github, gitlab, bitbucket and personal server.)InstructionsThis is a tool to downloadgitsource repositiry in a versatile worktreeisland is under a FREE license that can be found in the LICENSE file.
Any contribution is more than welcome ;)git repositoryhttp://github.com/HeeroYui/island/Documentationhttp://HeeroYui.github.io/island/InstallationRequirements:Python >= 2.7andpipJust run:pip install islandInstall pip on debian/ubuntu:sudo apt-get install pipInstall pip on ARCH-linux:sudo pacman -S pipInstall pip on MacOs:sudo easy_install pipUsageSelect a manifest:island inithttp://github.com/atria-soft/manifest.gitDownload and synchronize the sources:island syncSelect all branch available in the work-tree: (checkout origin/dev in dev branch and track it, do nothing if the branch does not exist)island checkout devShow the status of the workspaceisland statusDevelop in local (with virtual env):see:https://setuptools.pypa.io/en/latest/userguide/development_mode.htmlCreate your development environment:# Create a virtual environmentpython-mvenv.venv# Activate the python virtual environmentsource.venv/bin/activate# Install the package in editable mode (dynamic use of files)pipinstall--editable.Run the application .island --helpManual set in production:install generic tools for deploymentpip3installtwineCreate the new version:# Clean previous packages\rm-rfdist/# Compile the packagepython3-mbuild# Upload the packagepython3-mtwineuploaddist/*TODO listWhen sync checkout the new manifeststatus: show how many time late we are on the branchsync: filter the apply of this cmdcreate snapshotuse a snapshotcommit all change in a single commit name and datepush all change in the origin branchstash/unstash all changepermit to set the pasword when requested by gitsync: show download progresssupport single project mirrorsupport submodule mirrorsupport project upstreamsupport submodule add upstreampush modilfication in all late mirorr (force mode optionnal) ==> for automatic server synchronisation in 4 linesa good documation of the format and the usageparallele download / sync / push ...License (MPL v2.0)Copyright island Edouard DUPINLicensed under the Mozilla Public License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License athttps://www.mozilla.org/MPL/2.0/Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.