Removing global configurations

.github/workflows/pythonpackage.yml

@@ -23,30 +23,21 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirements.txt
-
-    # - name: Lint with flake8
-    #   run: |
-    #     pip install flake8
-    #     # stop the build if there are Python syntax errors or undefined names
-    #     flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
-    #     # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
-    #     flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+        pip install poetry
+        poetry install
 
     - name: Test with pytest
       run: |
-        pip install pytest
-        pytest
+        poetry run pytest
 
     - name: Install condax
       run: |
-        pip install .
-        condax ensure-path
+        poetry run condax ensure-path
         mkdir -p "${HOME}/.local/bin"
 
     - name: Install black via condax
       run: |
-        condax install black
+        poetry run condax install black
 
     - name: Run black --help
       run: |
@@ -56,4 +47,4 @@ jobs:
 
     - name: Remove black from condax environments
       run: |
-        condax remove black
+        poetry run condax remove black

README.md

@@ -2,48 +2,63 @@
 
 ## What is this?
 
-`condax` is a package manager exclusively for installing commands from conda distribution channels. `condax` frees you from activating and deactivating conda environments while keeping programs in separate environments.
+`condax` is a package manager exclusively for installing commands. `condax`, built on top of `conda` variants, frees you from activating and deactivating conda environments while keeping programs in separate environments.
 
-`condax` was originally developed by [Marius van Niekerk ](https://github.com/mariusvniekerk/condax). I'm adding features here after the version 0.0.5.
+`condax` was originally developed by [Marius van Niekerk ](https://github.com/mariusvniekerk/condax). More features have been added here after the version 0.0.5.
 
 
 ## Examples
 
-Here is how to install `node`, and execute it.
+Here is how you can install `node`. You can just execute it without activating its associated environment. `node` still lives in its own environment so there is no worry about dependencies.
 
 ```shell
 condax install nodejs
+
+# Then node is ready to run.
 node --version
 ```
 
-This operation is equivalent to the following; `condax` just keeps track of conda environments for commands.
+There is no magic about the operation, and you can even do the same without having `condax`; the trick is to use `conda run` (or `micromamba run`) which is effectively sandwitching a command with `conda activate` and `conda deactivate`.
 
 ```shell
-conda env create -c conda-forge -n nodejs nodejs
-conda run -n nodejs 'node --version'
+# Create an environent `nodejs`.
+mamba env create -c conda-forge -n nodejs nodejs
+
+# Run `node --verion` within the nodejs environment.
+micromamba run -n nodejs node --version
 ```
 
-## How to install `condax`
+`condax` just creates scripts like this, by default in `~/.local/bin`, and manages them together with conda environments. It's simple, yet quite convenient when you deal with many commands from conda channels. (I'm looking at you, [`bioconda`](https://bioconda.github.io/) users 🤗.)
+
+
+## How to install and setup `condax`
 
 Use `pip` or `pipx` to install directly from this repository.
 
-```
+```shell
 $ pip install git+https://github.com/yamaton/condax
 
 # Or, pipx install git+https://github.com/yamaton/condax if pipx is available.
 ```
 
+Then add `~/.local/bin` to your `$PATH` if not done already. This command will modify shell configuration. You may skip this if you manage `$PATH` by yourself.
+
+```shell
+condax ensure-path
+```
+
 
 ## Changes since the original [`condax 0.0.5`](https://github.com/mariusvniekerk/condax/)
 
 - Supports `condax list` to display installed executables.
-- Uses `mamba` internally if available.
+- Uses `mamba` to manipulate environments if available.
+- Uses `micromamba` to run commands.
 - Supports installing a package with version constraints, like `condax install ipython=8.3`.
     - See [package match specifications](https://docs.conda.io/projects/conda/en/latest/user-guide/concepts/pkg-specs.html#package-match-specifications) for the detail.
 - Supports injecting/uninjecting packages onto/from an existing environment.
 - Supports configuring via environment variables, or by passing a config file.
-- Supports exporting and importing conda environments (only the ones managed by `condax`).
-- Internally, this fork creates scripts calling `conda run` instead of creating symbolic links.
+- Supports exporting and importing condax environments for reproducibility.
+- Internally, this fork creates scripts calling `micromamba run` instead of creating symbolic links.
     - ➡️ Solves [the issue](https://github.com/mariusvniekerk/condax/issues/13) with non-Python packages
 - Follows [XDG Base Directory Specification](https://stackoverflow.com/questions/1024114/location-of-ini-config-files-in-linux-unix) for directory and file locations:
     - Environments are created in `~/.local/share/condax/envs`. (Previously `~/.condax`.)
@@ -53,14 +68,13 @@ $ pip install git+https://github.com/yamaton/condax
 
 ## Known issues
 
-- ``ERROR conda.cli.main_run:execute(49): `conda run XXX` failed (see above for error)`` appears whenever a command returns a nonzero exit code.
 - Support of Windows platform is imperfect, though it should work fine on WSL.
 
 
 ## Migrating environments from `condax` v0.0.5
 
 This forked version has changed the locations of the environments and the config file. If you have already installed packages with the original `condax`, please run the following, just once, to sort out.
 
-```bash
+```shell
 condax repair --migrate
 ```

condax/__init__.py

@@ -1 +1,9 @@
-__version__ = "0.0.6"
+import sys
+
+
+if sys.version_info >= (3, 8):
+    import importlib.metadata as _metadata
+else:
+    import importlib_metadata as _metadata
+
+__version__ = _metadata.version(__package__)