Package: ddot
DdotYour dev environment manager[[TOC]]IntroductionDdot is a devinstaller application created using the devinstaller framework.For more info read belowGetting StartedpipxrunddotrunThere needs to be a devfile in the current directory. Any one of these:devfile.tomldevfile.yamlordevfile.ymldevfile.jsonInstallationThere are two method to use the application:Using Pipx to directly run the applicationInstalling the application on your machineUsingPipxmethod is recommended.Method 1: Using PipxWhy this method is recommended?You can use Pipx to directly run the latest version of ddot without installing it in your machine. This way
your machine stays clean and you don't need to worry about updating ddot.You can also install ddot in your machine using pipx if that's what you want.Usage without installationInstall pipxOn MacOSbrewinstallpipx
pipxensurepathOther OSpython3-mpipinstall--userpipx
python3-mpipxensurepathfor more information check outPipx.Using ddotpipxrunddot<command># Example: pipx run ddot run --verbosePlease note that the commands in the section below will need thepipx runprefix with this method. Other method
doesn't require this prefix.Usage with installationpipxinstallddotMethod 2: Machine installationYou can also install ddot without pipx. Although this is discouraged as ddot may disturb your system packages.python-mpipinstallddotCommandsShow the ddot versionddot--versionShow the help menuddot--helpShow all the modules available in the devfileddotshowExecute the modulesddotrunThis command will open up a interactive prompt which you can use to navigate and select all the modules you want to execute.You select modules using your SPACEBAR key and naviage using your ARROW keys.You can also skip the interactive prompt by runningddotrun-m<modulename>Here<module name>is the name of the module in the devfile at the current directory.You can also specify the location to the devfile if it's not present in the current directory or if it's named differentlyddotrun--spec-file<specfilelocation>You can also set the verbose flag usingddotrun--verboseBy default the verbose mode is disabled, so you won't see any of the commands that are being executed but instead will see a
progress bar.But if you need to see it just run using the verbose flag.What is Devinstaller?Devinstaller is a framework to execute the devfiles.What are devfiles?Devfiles is made up of 2 file:Spec fileProg fileSpec file?The guiding principle behind the Spec file is to give a declarative and a platform agnostic way to specify a task which then can be handled by the
devinstaller application and make that happen.In Devinstaller the basic building block for anything is called a "module".And you execute/install the module to do something.ModulesWe have modules for:filefolderlinkappphonygroupfile,folderandlinkmodules
Say you want to create a file in a declarative way. For this you use the file module
and specify where and what the file is and the devinstaller will handle how to create/update/delete
the file.This way your file module is declarative and the application handles everything required to make it happen,
including on how to do it on different OS.This is how thefile,folderand thelinkmodule works.appmodule
Then we have theappmodule. App module is for system applications. Here you need to write in some imperative instructions on how
a specific application is to be installed. But the beauty behind this you can add in instructions on how to do the same on different
platforms and the overall module becomes declarative for other users.Example: You can write up the instructions to install ddot on different OS in a devfile, which an another user can import the devfile into
their devfile and it will give them a declarative way to install ddot on their machine and they don't have to worry about how it's going to
be done.phonyandgroupmodule
But we understand that not everything can be put in a declarative way so for those cases we have thegroupand thephonymodule. You can combine these modules in any fashion to translate your imperative instructions into a more
declarative way.dGenerateFor writing up spec file you can use the web applicationdGenerateor you can write it in any text editor.Using dGenerate will give you better user experience.Features of dGenerateWrite and save in any file format.
Formats supported include:TOMLYAMLJSONYou can upload existing devfile and do some changes and download it.You can share the link to your dGenerate devfile and send it to anyone. And they can go to the link make their changes and download it.dGenerate is a completely offline application and it doesn't send any data to any servers.
So you can be assured of the safety of your data. Even for generating the share link for your devfile, we don't store any data on any server.
All the data required are in the link itself. You might have probably noticed that all the share links are unusually long and now
you know the reason for it.Prog file?TODOLicenseMIT LicenseCopyright (c) 2021 Justine Kizhakkinedath