openscvx 0.1.1__tar.gz → 0.1.2__tar.gz

openscvx-0.1.2/.github/release-drafter.yml

@@ -0,0 +1,55 @@
+name-template: 'v$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+categories:
+  - title: '🚀 Features'
+    labels:
+      - 'feature'
+      - 'enhancement'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'fix'
+      - 'bugfix'
+      - 'bug'
+  - title: '🧰 Maintenance'
+    labels:
+      - 'chore'
+      - 'refactor'
+      - 'documentation'
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
+version-resolver:
+  major:
+    labels:
+      - 'major'
+  minor:
+    labels:
+      - 'minor'
+  patch:
+    labels:
+      - 'patch'
+  default: patch
+autolabeler:
+  - label: 'enhancement'
+    branch:
+      - '/^[Ff]eature\/.+/'
+  - label: 'bug'
+    branch:
+      - '/^[Ff]ix\/.+/'
+  - label: 'chore'
+    branch:
+      - '/^[Cc]hore\/.+/'
+  - label: 'refactor'
+    branch:
+      - '/^[Rr]efactor\/.+/'
+  - label: 'documentation'
+    branch:
+      - '/^[Dd]ocumentation\/.+/'
+      - '/^[Dd]oc\/.+/'
+template: |
+  ## What's Changed
+
+  $CHANGES
+
+  ---
+
+  **Full Changelog:** [`$PREVIOUS_TAG...$NEXT_PATCH_VERSION`](https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...$NEXT_PATCH_VERSION)

openscvx-0.1.1/.github/workflows/main.yml → openscvx-0.1.2/.github/workflows/ci.yml

@@ -1,4 +1,4 @@
-name: CI
+name: ⚙️ CI
 
 on:
   push:
@@ -12,8 +12,8 @@ jobs:
   build:
     strategy:
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.10', '3.11', '3.12', '3.13']
 
     runs-on: ${{ matrix.os }}
 

openscvx-0.1.2/.github/workflows/nightly.yml

@@ -0,0 +1,45 @@
+name: 🌙 Nightly
+
+permissions:
+  contents: write
+
+on:
+  push:
+    branches:
+      - main
+  schedule:
+    - cron: '0 0 * * *'   # daily at midnight UTC
+
+concurrency:
+  group: nightly
+  cancel-in-progress: true
+
+jobs:
+  nightly:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 0 }
+
+      - uses: actions/setup-python@v4
+        with: { python-version: '3.x' }
+
+      - name: Install build tools
+        run: pip install --upgrade pip build twine setuptools-scm
+
+      - name: Build distributions
+        run: |
+          rm -rf dist
+          python -m build
+
+      - name: Publish to TestPyPI
+        env:
+          TWINE_USERNAME: ${{ secrets.TEST_PYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.TEST_PYPI_PASSWORD }}
+        run: |
+          twine upload \
+            --repository testpypi \
+            --non-interactive \
+            --verbose \
+            --skip-existing \
+            dist/*

openscvx-0.1.2/.github/workflows/release-drafter.yml

@@ -0,0 +1,42 @@
+name: 📝 Release Drafter
+
+on:
+  push:
+    # branches to consider in the event; optional, defaults to all
+    branches:
+      - main
+
+  # pull_request event is required only for autolabeler
+  pull_request:
+    # Only following types are handled by the action, but one can default to all as well
+    types: [opened, reopened, synchronize]
+  # pull_request_target event is required for autolabeler to support PRs from forks
+  # pull_request_target:
+  #   types: [opened, reopened, synchronize]
+
+permissions:
+  contents: read
+
+jobs:
+  release-drafter:
+    permissions:
+      # write permission is required to create a github release
+      contents: write
+      # write permission is required for autolabeler
+      # otherwise, read permission is required at least
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      # (Optional) GitHub Enterprise requires GHE_HOST variable set
+      #- name: Set GHE_HOST
+      #  run: |
+      #    echo "GHE_HOST=${GITHUB_SERVER_URL##https:\/\/}" >> $GITHUB_ENV
+
+      # Drafts your next Release notes as Pull Requests are merged into "main"
+      - uses: release-drafter/release-drafter@v6
+        # (Optional) specify config name to use, relative to .github/. Default: release-drafter.yml
+        # with:
+        #   config-name: my-config.yml
+        #   disable-autolabeler: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

openscvx-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,41 @@
+name: 🚀 Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Install build tools
+        run: pip install --upgrade pip build twine setuptools-scm
+
+      - name: Build distributions
+        run: |
+          rm -rf dist
+          python -m build
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+        run: |
+          twine upload \
+            --non-interactive \
+            --verbose \
+            --skip-existing \
+            dist/*
+
+      - name: Upload Release Assets
+        if: ${{ always() }}
+        run: |
+          gh release upload "${{ github.event.release.tag_name }}" dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{openscvx-0.1.1/openscvx.egg-info → openscvx-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openscvx
-Version: 0.1.1
+Version: 0.1.2
 Summary: A general Python-based successive convexification implementation which uses a JAX backend.
 Home-page: https://haynec.github.io/openscvx/
 Author: Chris Hayner and Griffin Norris
@@ -26,10 +26,15 @@ Dynamic: license-file
 
 <img src="figures/openscvx_logo.svg" width="1200"/>
 <p align="center">
-    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/main.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/main.yml/badge.svg"/></a>
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/website.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/website.yml/badge.svg"/></a>
     <a href="https://arxiv.org/abs/2410.22596"><img src="http://img.shields.io/badge/arXiv-2410.22596-B31B1B.svg"/></a>
     <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"/></a>
 </p>
+<p align="center">
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/ci.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/ci.yml/badge.svg"/></a>
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/nightly.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/nightly.yml/badge.svg"/></a>
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/release.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/release.yml/badge.svg"/></a>
+</p>
 
 <!-- PROJECT LOGO -->
 <br />
@@ -37,20 +42,50 @@ Dynamic: license-file
 <!-- GETTING STARTED -->
 ## Getting Started
 
-
 ### Installation
+
+To grab the latest stable release simply run
+
+```sh
+pip install openscvx
+```
+
+to install OpenSCVx in your python environment.
+
+<details>
+<summary>Install Development / Nightly Version</summary>
+
+If you want the pre-release version, you can install the latest `nightly` build with:
+
+```sh
+python3 -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ --pre --upgrade openscvx
+```
+
+This command will also upgrade an existing `nightly` install to the latest version
+Or if you want a specific pre-release version this can be installed with
+
+```sh
+python3 -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ openscvx==1.2.3.dev45
+```
+
+where `1.2.3.dev45 => <major>.<minor>.<patch>.dev<XY>` corresponds to your exact version
+</details>
+
+
+#### Dependencies
+
 The main packages are:
-- ```cvxpy``` - is used to formulate and solve the convex subproblems
-- ```jax``` - is used for determining the Jacobians using automatic differentiation, vectorization, and ahead-of-time (AOT) compilation of the dynamics and their Jacobians 
-- ```numpy``` - is used for numerical operations
-- ```diffrax``` - is used for the numerical integration of the dynamics
-- ```termcolor``` - is used for pretty command line output
-- ```plotly``` - is used for all visualizations
 
+- `cvxpy` - is used to formulate and solve the convex subproblems
+- `jax` - is used for determining the Jacobians using automatic differentiation, vectorization, and ahead-of-time (AOT) compilation of the dynamics and their Jacobians 
+- `numpy` - is used for numerical operations
+- `diffrax` - is used for the numerical integration of the dynamics
+- `termcolor` - is used for pretty command line output
+- `plotly` - is used for all visualizations
 
-These can be installed via conda or pip.
+These will be installed automatically, but can be installed via conda or pip if you are building from source.
 <details>
-<summary>Via Conda (Recommended) </summary>
+<summary>Via Conda</summary>
 
 1. Clone the repo
    ```sh
@@ -87,11 +122,11 @@ These can be installed via conda or pip.
 See `examples/` folder for several example trajectory optimization problems.
 To run a problem simply run `examples/main.py` with:
 
-```bash
-python3 -m examples.main
+```sh
+python3 examples/main.py
 ```
 
-To change which example is run by `main` simply replace the `params` import line:
+To change which example is run by `main` simply replace the `problem` import line:
 
 ```python
 # other imports
@@ -99,10 +134,11 @@ from examples.params.dr_vp import problem
 # rest of code
 ```
 
+and adjust the plotting as needed.
 Check out the problem definitions inside `examples/params` to see how to define your own problems.
 
-
 ## ToDos
+
 - [X] Standardized Vehicle and Constraint classes
 - [X] Implement QOCOGen with CVPYGEN
 - [X] Non-Dilated Time Propagation 
@@ -110,8 +146,12 @@ Check out the problem definitions inside `examples/params` to see how to define
 - [ ] Compiled at the subproblem level with JAX
 - [ ] Save and reload the compiled JAX code
 - [ ] Single Shot propagation
+- [ ] Unified Mathematical Interface
+
 ## What is implemented
+
 This repo has the following features:
+
 1. Free Final Time
 2. Fully adaptive time dilation (```s``` is appended to the control vector)
 3. Continuous-Time Constraint Satisfaction
@@ -122,11 +162,14 @@ This repo has the following features:
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
 ## Acknowledgements
+
 This work was supported by a NASA Space Technology Graduate Research Opportunity and the Office of Naval Research under grant N00014-17-1-2433. The authors would like to acknowledge Natalia Pavlasek, Samuel Buckner, Abhi Kamath, Govind Chari, and Purnanand Elango as well as the other Autonomous Controls Laboratory members, for their many helpful discussions and support throughout this work.
 
 ## Citation
+
 Please cite the following works if you use the repository,
-```
+
+```tex
 @ARTICLE{hayner2025los,
         author={Hayner, Christopher R. and Carson III, John M. and Açıkmeşe, Behçet and Leung, Karen},
         journal={IEEE Robotics and Automation Letters}, 
@@ -139,7 +182,7 @@ Please cite the following works if you use the repository,
         doi={10.1109/LRA.2025.3545299}}
 ```
 
-```
+```tex
 @misc{elango2024ctscvx,
       title={Successive Convexification for Trajectory Optimization with Continuous-Time Constraint Satisfaction}, 
       author={Purnanand Elango and Dayou Luo and Abhinav G. Kamath and Samet Uzun and Taewan Kim and Behçet Açıkmeşe},

{openscvx-0.1.1 → openscvx-0.1.2}/README.md

@@ -2,10 +2,15 @@
 
 <img src="figures/openscvx_logo.svg" width="1200"/>
 <p align="center">
-    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/main.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/main.yml/badge.svg"/></a>
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/website.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/website.yml/badge.svg"/></a>
     <a href="https://arxiv.org/abs/2410.22596"><img src="http://img.shields.io/badge/arXiv-2410.22596-B31B1B.svg"/></a>
     <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"/></a>
 </p>
+<p align="center">
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/ci.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/ci.yml/badge.svg"/></a>
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/nightly.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/nightly.yml/badge.svg"/></a>
+    <a href="https://github.com//haynec/OpenSCvx/actions/workflows/release.yml/badge.svg"><img src="https://github.com//haynec/OpenSCvx/actions/workflows/release.yml/badge.svg"/></a>
+</p>
 
 <!-- PROJECT LOGO -->
 <br />
@@ -13,20 +18,50 @@
 <!-- GETTING STARTED -->
 ## Getting Started
 
-
 ### Installation
+
+To grab the latest stable release simply run
+
+```sh
+pip install openscvx
+```
+
+to install OpenSCVx in your python environment.
+
+<details>
+<summary>Install Development / Nightly Version</summary>
+
+If you want the pre-release version, you can install the latest `nightly` build with:
+
+```sh
+python3 -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ --pre --upgrade openscvx
+```
+
+This command will also upgrade an existing `nightly` install to the latest version
+Or if you want a specific pre-release version this can be installed with
+
+```sh
+python3 -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ openscvx==1.2.3.dev45
+```
+
+where `1.2.3.dev45 => <major>.<minor>.<patch>.dev<XY>` corresponds to your exact version
+</details>
+
+
+#### Dependencies
+
 The main packages are:
-- ```cvxpy``` - is used to formulate and solve the convex subproblems
-- ```jax``` - is used for determining the Jacobians using automatic differentiation, vectorization, and ahead-of-time (AOT) compilation of the dynamics and their Jacobians 
-- ```numpy``` - is used for numerical operations
-- ```diffrax``` - is used for the numerical integration of the dynamics
-- ```termcolor``` - is used for pretty command line output
-- ```plotly``` - is used for all visualizations
 
+- `cvxpy` - is used to formulate and solve the convex subproblems
+- `jax` - is used for determining the Jacobians using automatic differentiation, vectorization, and ahead-of-time (AOT) compilation of the dynamics and their Jacobians 
+- `numpy` - is used for numerical operations
+- `diffrax` - is used for the numerical integration of the dynamics
+- `termcolor` - is used for pretty command line output
+- `plotly` - is used for all visualizations
 
-These can be installed via conda or pip.
+These will be installed automatically, but can be installed via conda or pip if you are building from source.
 <details>
-<summary>Via Conda (Recommended) </summary>
+<summary>Via Conda</summary>
 
 1. Clone the repo
    ```sh
@@ -63,11 +98,11 @@ These can be installed via conda or pip.
 See `examples/` folder for several example trajectory optimization problems.
 To run a problem simply run `examples/main.py` with:
 
-```bash
-python3 -m examples.main
+```sh
+python3 examples/main.py
 ```
 
-To change which example is run by `main` simply replace the `params` import line:
+To change which example is run by `main` simply replace the `problem` import line:
 
 ```python
 # other imports
@@ -75,10 +110,11 @@ from examples.params.dr_vp import problem
 # rest of code
 ```
 
+and adjust the plotting as needed.
 Check out the problem definitions inside `examples/params` to see how to define your own problems.
 
-
 ## ToDos
+
 - [X] Standardized Vehicle and Constraint classes
 - [X] Implement QOCOGen with CVPYGEN
 - [X] Non-Dilated Time Propagation 
@@ -86,8 +122,12 @@ Check out the problem definitions inside `examples/params` to see how to define
 - [ ] Compiled at the subproblem level with JAX
 - [ ] Save and reload the compiled JAX code
 - [ ] Single Shot propagation
+- [ ] Unified Mathematical Interface
+
 ## What is implemented
+
 This repo has the following features:
+
 1. Free Final Time
 2. Fully adaptive time dilation (```s``` is appended to the control vector)
 3. Continuous-Time Constraint Satisfaction
@@ -98,11 +138,14 @@ This repo has the following features:
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
 ## Acknowledgements
+
 This work was supported by a NASA Space Technology Graduate Research Opportunity and the Office of Naval Research under grant N00014-17-1-2433. The authors would like to acknowledge Natalia Pavlasek, Samuel Buckner, Abhi Kamath, Govind Chari, and Purnanand Elango as well as the other Autonomous Controls Laboratory members, for their many helpful discussions and support throughout this work.
 
 ## Citation
+
 Please cite the following works if you use the repository,
-```
+
+```tex
 @ARTICLE{hayner2025los,
         author={Hayner, Christopher R. and Carson III, John M. and Açıkmeşe, Behçet and Leung, Karen},
         journal={IEEE Robotics and Automation Letters}, 
@@ -115,7 +158,7 @@ Please cite the following works if you use the repository,
         doi={10.1109/LRA.2025.3545299}}
 ```
 
-```
+```tex
 @misc{elango2024ctscvx,
       title={Successive Convexification for Trajectory Optimization with Continuous-Time Constraint Satisfaction}, 
       author={Purnanand Elango and Dayou Luo and Abhinav G. Kamath and Samet Uzun and Taewan Kim and Behçet Açıkmeşe},

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/cinema_vp.py

@@ -3,6 +3,7 @@ import numpy.linalg as la
 import jax.numpy as jnp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.utils import qdcm, SSMP, SSM, get_kp_pose
 from openscvx.constraints import boundary, ctcs
 
@@ -54,6 +55,7 @@ norm_type = np.inf  # Norm Type
 R_sb = jnp.array([[0, 1, 0], [0, 0, 1], [1, 0, 0]])
 
 
+@dynamics
 def dynamics(x, u):
     m = 1.0  # Mass of the drone
     g_const = -9.18

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/dr_vp.py

@@ -4,6 +4,7 @@ import cvxpy as cp
 import jax.numpy as jnp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.utils import qdcm, SSMP, SSM, rot, gen_vertices
 from openscvx.constraints import boundary, ctcs, nodal
 
@@ -107,6 +108,7 @@ for node, cen in zip(gate_nodes, A_gate_cen):
     )  # use local variables inside the lambda function
 
 
+@dynamics
 def dynamics(x, u):
     m = 1.0  # Mass of the drone
     g_const = -9.18

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/dr_vp_nodal.py

@@ -4,6 +4,7 @@ import cvxpy as cp
 import jax.numpy as jnp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.utils import qdcm, SSMP, SSM, rot, gen_vertices
 from openscvx.constraints import boundary, nodal
 
@@ -111,6 +112,7 @@ for node, cen in zip(gate_nodes, A_gate_cen):
     )  # use local variables inside the lambda function
 
 
+@dynamics
 def dynamics(x, u):
     m = 1.0  # Mass of the drone
     g_const = -9.81

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/dr_vp_polytope.py

@@ -4,6 +4,7 @@ import jax.numpy as jnp
 import cvxpy as cp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.utils import qdcm, SSMP, SSM, rot, gen_vertices
 from openscvx.constraints import boundary, ctcs, nodal
 
@@ -131,6 +132,7 @@ for node, cen in zip(gate_nodes, A_gate_cen):
     )  # use local variables inside the lambda function
 
 
+@dynamics
 def dynamics(x, u):
     m = 1.0  # Mass of the drone
     g_const = -9.18

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/drone_racing.py

@@ -3,6 +3,7 @@ import jax.numpy as jnp
 import cvxpy as cp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.constraints import boundary, ctcs, nodal
 from openscvx.utils import qdcm, SSMP, SSM, rot, gen_vertices
 
@@ -80,6 +81,7 @@ for node, cen in zip(gate_nodes, A_gate_cen):
     )  # use local variables inside the lambda function
 
 
+@dynamics
 def dynamics(x, u):
     # Unpack the state and control vectors
     v = x[3:6]

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/obstacle_avoidance.py

@@ -2,6 +2,7 @@ import numpy as np
 import jax.numpy as jnp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.constraints import boundary, ctcs
 from openscvx.utils import qdcm, SSMP, SSM, generate_orthogonal_unit_vectors
 
@@ -23,6 +24,7 @@ final_state.type[13] = "Minimize"
 initial_control = np.array([0.0, 0, 50, 0, 0, 0])
 
 
+@dynamics
 def dynamics(x, u):
     m = 1.0  # Mass of the drone
     g_const = -9.18

{openscvx-0.1.1 → openscvx-0.1.2}/examples/params/obstacle_avoidance_nodal.py

@@ -2,6 +2,7 @@ import numpy as np
 import jax.numpy as jnp
 
 from openscvx.trajoptproblem import TrajOptProblem
+from openscvx.dynamics import dynamics
 from openscvx.constraints import boundary, ctcs, nodal
 from openscvx.utils import qdcm, SSMP, SSM, generate_orthogonal_unit_vectors
 
@@ -23,6 +24,7 @@ final_state.type[13] = "Minimize"
 initial_control = np.array([0., 0., 50., 0., 0., 0.])
 
 
+@dynamics
 def dynamics(x, u):
     m = 1.0  # Mass of the drone
     g_const = -9.18

{openscvx-0.1.1 → openscvx-0.1.2}/openscvx/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.1.1'
-__version_tuple__ = version_tuple = (0, 1, 1)
+__version__ = version = '0.1.2'
+__version_tuple__ = version_tuple = (0, 1, 2)