yhttp-dbmanager 2.7.0__tar.gz → 2.8.0__tar.gz

{yhttp_dbmanager-2.7.0/yhttp_dbmanager.egg-info → yhttp_dbmanager-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: yhttp-dbmanager
-Version: 2.7.0
+Version: 2.8.0
 Summary: Database manager command line interface and API for yhttp.
 Home-page: http://github.com/yhttp/yhttp-dbmanager
 Author: Vahid Mardani
@@ -26,44 +26,104 @@ Requires-Dist: yhttp<5,>=3.5.2
 Requires-Dist: dbmanager
 Requires-Dist: psycopg2
 
-# Dependencies
-install `postgreslq` brefore use of this project.
+# yhttp-dbmanager
 
+A `yhttp` extension to create and remove database(s) using command line and
+API.
 
 ## Contribution
 
+### Dependencies
+Install `postgreslq` brefore use of this project.
+```bash
+apt install postgresql
+```
+
 ### Prepare
 
-Create and grant `postgres` role with `createdb` permission:
+Create and grant the `postgresql` role with `createdb` permission to 
+authenticate the current `unix` user within `postgresql` using the peer 
+authentication.
 ```bash
 echo "CREATE USER ${USER} WITH CREATEDB" | sudo -u postgres psql
 # Or
 echo "ALTER USER ${USER} CREATEDB" | sudo -u postgres psql
 ```
 
+### Virtualenv
+
 Create virtual environment:
 ```bash
 make venv
 ```
 
+Delete virtual environment:
+```bash
+make venv-delete
+```
+
+Activate the virtual environment:
+```bash
+source ./activate.sh
+```
+
+
+### Install (editable mode)
 Install this project as editable mode and all other development dependencies:
 ```bash
 make env
 ```
 
+
 ### Tests
 Execute all tests:
 ```bash
 make test
 ```
 
+Execute specific test(s) using wildcard:
+```bash
+make test U=db*
+```
+
 Execute all tests and report coverage result:
 ```bash
 make cover
 make cover-html
 ```
 
-### Virtualenv
+
+### Distribution
+Execute these commands to create `Python`'s standard distribution packages
+at `dist` directory:
 ```bash
-source ./activate.sh
+make sdist
+make wheel
+```
+
+Or 
+```bash
+make dist
+```
+to create both `sdidst` and `wheel` packages.
+
+
+### Clean build directory
+Execute: 
+```bash
+make clean
+```
+to clean-up previous dist/* and build/* directories.
+
+
+### PyPI
+
+> **_WARNING:_** Do not do this if you'r not responsible as author and 
+> or maintainer of this project.
+
+Execute
+```bash
+make clean
+make pypi
 ```
+to upload `sdists` and `wheel` packages on [PyPI](https://pypi.org).

yhttp_dbmanager-2.8.0/README.md

@@ -0,0 +1,101 @@
+# yhttp-dbmanager
+
+A `yhttp` extension to create and remove database(s) using command line and
+API.
+
+## Contribution
+
+### Dependencies
+Install `postgreslq` brefore use of this project.
+```bash
+apt install postgresql
+```
+
+### Prepare
+
+Create and grant the `postgresql` role with `createdb` permission to 
+authenticate the current `unix` user within `postgresql` using the peer 
+authentication.
+```bash
+echo "CREATE USER ${USER} WITH CREATEDB" | sudo -u postgres psql
+# Or
+echo "ALTER USER ${USER} CREATEDB" | sudo -u postgres psql
+```
+
+### Virtualenv
+
+Create virtual environment:
+```bash
+make venv
+```
+
+Delete virtual environment:
+```bash
+make venv-delete
+```
+
+Activate the virtual environment:
+```bash
+source ./activate.sh
+```
+
+
+### Install (editable mode)
+Install this project as editable mode and all other development dependencies:
+```bash
+make env
+```
+
+
+### Tests
+Execute all tests:
+```bash
+make test
+```
+
+Execute specific test(s) using wildcard:
+```bash
+make test U=db*
+```
+
+Execute all tests and report coverage result:
+```bash
+make cover
+make cover-html
+```
+
+
+### Distribution
+Execute these commands to create `Python`'s standard distribution packages
+at `dist` directory:
+```bash
+make sdist
+make wheel
+```
+
+Or 
+```bash
+make dist
+```
+to create both `sdidst` and `wheel` packages.
+
+
+### Clean build directory
+Execute: 
+```bash
+make clean
+```
+to clean-up previous dist/* and build/* directories.
+
+
+### PyPI
+
+> **_WARNING:_** Do not do this if you'r not responsible as author and 
+> or maintainer of this project.
+
+Execute
+```bash
+make clean
+make pypi
+```
+to upload `sdists` and `wheel` packages on [PyPI](https://pypi.org).

yhttp_dbmanager-2.8.0/tests/test_dburi.py

@@ -0,0 +1,50 @@
+from yhttp.ext.dbmanager import DatabaseURI
+
+import pytest
+
+
+def test_dburi():
+    uristr = 'foo://bar:baz@qux/quux.thud'
+    uri = DatabaseURI.loads(uristr)
+
+    assert uri.provider == 'foo'
+    assert uri.user == 'bar'
+    assert uri.password == 'baz'
+    assert uri.host == 'qux'
+    assert uri.dbname == 'quux.thud'
+    assert uri.dumps() == uristr
+
+    # Invalid uri
+    uristr = 'baduri'
+    with pytest.raises(ValueError):
+        DatabaseURI.loads(uristr)
+
+    # Without password
+    uristr = 'foo://bar:@qux/quux.thud'
+    uri = DatabaseURI.loads(uristr)
+    assert uri.provider == 'foo'
+    assert uri.user == 'bar'
+    assert uri.password == ''
+    assert uri.host == 'qux'
+    assert uri.dbname == 'quux.thud'
+    assert uri.dumps() == uristr
+
+    # Without username and password
+    uristr = 'foo://:@qux/quux.thud'
+    uri = DatabaseURI.loads(uristr)
+    assert uri.provider == 'foo'
+    assert uri.user == ''
+    assert uri.password == ''
+    assert uri.host == 'qux'
+    assert uri.dbname == 'quux.thud'
+    assert uri.dumps() == uristr
+
+    # Without username, password and host
+    uristr = 'foo://:@/quux.thud'
+    uri = DatabaseURI.loads(uristr)
+    assert uri.provider == 'foo'
+    assert uri.user == ''
+    assert uri.password == ''
+    assert uri.host == ''
+    assert uri.dbname == 'quux.thud'
+    assert uri.dumps() == uristr

{yhttp_dbmanager-2.7.0 → yhttp_dbmanager-2.8.0}/yhttp/ext/dbmanager/__init__.py

@@ -5,4 +5,4 @@ from .dbmanager import PostgresqlManager
 from .uri import DatabaseURI
 
 
-__version__ = '2.7.0'
+__version__ = '2.8.0'

{yhttp_dbmanager-2.7.0 → yhttp_dbmanager-2.8.0/yhttp_dbmanager.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: yhttp-dbmanager
-Version: 2.7.0
+Version: 2.8.0
 Summary: Database manager command line interface and API for yhttp.
 Home-page: http://github.com/yhttp/yhttp-dbmanager
 Author: Vahid Mardani
@@ -26,44 +26,104 @@ Requires-Dist: yhttp<5,>=3.5.2
 Requires-Dist: dbmanager
 Requires-Dist: psycopg2
 
-# Dependencies
-install `postgreslq` brefore use of this project.
+# yhttp-dbmanager
 
+A `yhttp` extension to create and remove database(s) using command line and
+API.
 
 ## Contribution
 
+### Dependencies
+Install `postgreslq` brefore use of this project.
+```bash
+apt install postgresql
+```
+
 ### Prepare
 
-Create and grant `postgres` role with `createdb` permission:
+Create and grant the `postgresql` role with `createdb` permission to 
+authenticate the current `unix` user within `postgresql` using the peer 
+authentication.
 ```bash
 echo "CREATE USER ${USER} WITH CREATEDB" | sudo -u postgres psql
 # Or
 echo "ALTER USER ${USER} CREATEDB" | sudo -u postgres psql
 ```
 
+### Virtualenv
+
 Create virtual environment:
 ```bash
 make venv
 ```
 
+Delete virtual environment:
+```bash
+make venv-delete
+```
+
+Activate the virtual environment:
+```bash
+source ./activate.sh
+```
+
+
+### Install (editable mode)
 Install this project as editable mode and all other development dependencies:
 ```bash
 make env
 ```
 
+
 ### Tests
 Execute all tests:
 ```bash
 make test
 ```
 
+Execute specific test(s) using wildcard:
+```bash
+make test U=db*
+```
+
 Execute all tests and report coverage result:
 ```bash
 make cover
 make cover-html
 ```
 
-### Virtualenv
+
+### Distribution
+Execute these commands to create `Python`'s standard distribution packages
+at `dist` directory:
 ```bash
-source ./activate.sh
+make sdist
+make wheel
+```
+
+Or 
+```bash
+make dist
+```
+to create both `sdidst` and `wheel` packages.
+
+
+### Clean build directory
+Execute: 
+```bash
+make clean
+```
+to clean-up previous dist/* and build/* directories.
+
+
+### PyPI
+
+> **_WARNING:_** Do not do this if you'r not responsible as author and 
+> or maintainer of this project.
+
+Execute
+```bash
+make clean
+make pypi
 ```
+to upload `sdists` and `wheel` packages on [PyPI](https://pypi.org).

yhttp_dbmanager-2.7.0/README.md

@@ -1,41 +0,0 @@
-# Dependencies
-install `postgreslq` brefore use of this project.
-
-
-## Contribution
-
-### Prepare
-
-Create and grant `postgres` role with `createdb` permission:
-```bash
-echo "CREATE USER ${USER} WITH CREATEDB" | sudo -u postgres psql
-# Or
-echo "ALTER USER ${USER} CREATEDB" | sudo -u postgres psql
-```
-
-Create virtual environment:
-```bash
-make venv
-```
-
-Install this project as editable mode and all other development dependencies:
-```bash
-make env
-```
-
-### Tests
-Execute all tests:
-```bash
-make test
-```
-
-Execute all tests and report coverage result:
-```bash
-make cover
-make cover-html
-```
-
-### Virtualenv
-```bash
-source ./activate.sh
-```

yhttp_dbmanager-2.7.0/tests/test_dburi.py

@@ -1,20 +0,0 @@
-from yhttp.ext.dbmanager import DatabaseURI
-
-import pytest
-
-
-def test_dburi():
-    uristr = 'foo://bar:baz@qux/quux.thud'
-    uri = DatabaseURI.loads(uristr)
-
-    assert uri.provider == 'foo'
-    assert uri.user == 'bar'
-    assert uri.password == 'baz'
-    assert uri.host == 'qux'
-    assert uri.dbname == 'quux.thud'
-    assert uri.dumps() == uristr
-
-    # Invalid uri
-    uristr = 'baduri'
-    with pytest.raises(ValueError):
-        DatabaseURI.loads(uristr)