Getting Started with LiquidBT¶
Getting started is relatively simple. Just install, configure, and use.
LiquidBT requires Python 3.4 or later to be installed on your system.
To install, execute the command listed under your system's name:
sudo python3 -m pip install --upgrade liquidbt
python3 -m pip install --upgrade --user liquidbt
python -m pip install --upgrade --user liquidbt
Migrating From setuptools¶
If you are using setuptools right now, you can change over pretty easily.
- Install LiquidBT.
- Change the directory that the source is in (not the root directory)'s name to include a
.sat the end. Don't make it a file, just add the
.ssuffix to the folder's name. This tells LiquidBT that you want this to be the source directory.
- You will need to basically rewrite your
setup.pyto fit LiquidBT's API. First, copy the arguments you pass to
setuptools.setup, and save it somewhere you can use it. You will need them later. Once you do this, you can delete the contents of your
setup.py, and proceed to step 4.
- If your saved setuptools config has any of these fields, remove them from your backup:
- Add this code, replacing the placeholders with your own actual data:
import liquidbt # the build plugin contains the core functionality from liquidbt.build_tools.typeClasses import ( PackageConfig, SourceDist, WheelBinaryDist ) # most packages opt to make source dists and wheel dists package_one = BuildConfiguration( "name-of-package-for-pypi", # PASTE the setuptools args you saved here # set the dist formats to build: formats=[SourceDist(), WheelBinaryDist()] ) """ The plugins all handle functionality, liquidbt.main is just a wrapper to delegate tasks to the loaded plugins. You can also add any plugins to this list after build, since most plugins require the build plugin to be in memory for one reason or another. """ liquidbt.main(package_one)
You have now migrated. You can now run
setup.py to build, and if you add any plugins that add commands you will be able to run