semvec/pypi-packages huggingface dataset:
gitmiller 0.1.5
A tool to run a Jupyter Notebook from a (partial) Github repository.
Requires Python: >=3.6

# GitMiller

This description can be found [on GitHub here](https://github.com/UtrechtUniversity/GitMiller)

GitMiller is a tool for running Jupyter Notebooks from a (partial) Github repository. It downloads the repository in your temp folder, runs a designated notebook within it, and 
removes all downloaded files afterwards.

## Installation

`$ pip install gitmiller`

After installation you can use the `gitmiller` command-line tool to run your github notebooks.

## Usage

The command-line interface takes the following input parameters:

<table>
<tr>
    <th>parameter</th>
    <th>description</th>
</tr>
<tr>
    <td nowrap>-u, --username</td>
    <td>Username to gain access to GitHub repository</td>
</tr>
<tr>
    <td nowrap>-p, --password</td>
    <td>Password Github repository</td>
</tr>
<tr>
    <td nowrap>-t, --token</td>
    <td>Or use a Github token</td>
</tr>
<tr>
    <td nowrap>-r, --repository</td>
    <td>URL of GitHub repository (can be a subfolder)</td>
</tr>
<tr>
    <td nowrap>-n, --notebook</td>
    <td>filename of notebook you wish to execute, this file must exist in the root folder of the (partially) downloaded folder structure.
    </td>
</tr>
<tr>
    <td nowrap>-o, --output</td>
    <td>local path where GitMiller will put the executed version of your notebook</td>
</tr>
<tr>
    <td nowrap>-c, --config</td>
    <td>local path of YAML file in which you can add all mentioned paramaters</td>
</tr>
</table>

GitMiller uses [Papermill](https://github.com/nteract/papermill) to run your remote notebook. Besides executing, Papermill also enables you to parameterize notebooks. If you would like to override certain variables in your notebook, add the variables and values in the config YAML file under the `papermill` key. See example below.

This repository contains a folder `example` in which a notebook `test.ipynb` exists. If you would like to run this notebook with GitMiller, use either:

```
$ gitmiller -u <GITHUB USERNAME> -p <GITHUB PASSWORD>, -r https://github.com/UtrechtUniversity/GitMiller/tree/master/example, -n test.ipynb, -o <LOCAL OUTPUT-PATH>
```
or create the following YAML file:
```
repository: https://github.com/UtrechtUniversity/GitMiller/tree/master/example
username: <GITHUB USERNAME>
password: <GITHUB PASSWORD>
notebook: test.ipynb
output: <LOCAL OUTPUT-PATH>

papermill:
  a: 10
  b: 60
```
and run with:
```
$ gitmiller -c <PATH TO YAML-FILE>
```

## Note for Windows users
The script isn't able to remove the temp-folder after the Notebook has been processed on *Windows* machines. I have tried a lot of things, but couldn't find a solution. Manually removing also turned out to be impossible when using a terminal. I give up. At the end a message is printed in which the path of the folder is mentioned so you can remove it yourself.
sds011 0.2.0
A python 3 interface to a sds011 fine dust sensor
Requires Python: >=3.6
Keywords: fine dust sensor nova sds011

# sds011

This module is a Python3 based client for the sds011 fine dust (smog) sensor.
The sds011 is a cheap sensor from  [Nova Fitness Co., Ltd.](https://www.inovafitness.com) capable to measure pm2.5 and pm10 particle density in the air.
See the [Spec Sheet](https://cdn.sparkfun.com/assets/parts/1/2/2/7/5/Laser_Dust_Sensor_Control_Protocol_V1.3.pdf) for further info.

## some things to know about the sensor

* It is active fan and takes about 100mA when the fan is running.
* The critical component is the laser diode inside which has a lifetime of a few 1000 hours, so if using the sensor for permanent measurements, it will not last a year. 
  Setting the working period to about 5 minutes is a decent choice for granularity and lifetime.
* The sensor usually comes with a chinese CH341 USB2.0 serial adapter which is not a problem for linux systems but for windows and mac as the drivers sometimes are hard to get.
  In case you're planning to use the sensor on windows, get an FTDI USB to 5V-TTL converter cable.
* The sensor has 2 basic modes of operation "active" and "query".
  Only "active" mode has been tested. The low level commands for "query" are implemented are untested.
  In active mode the sensor makes a measurement every working period and sends that measurement.
  This leads to the behaviour that the sensor does not necessarily start measure after the object is generated. It stays in it's working period.

# basic gui

A PyQt5 APP provides basic sensor information and a plot function.

```
python3 sds011_pyqt5app.pyw
```
or running the script as executable

![SDS011Plot](resources/sds011_plot.png)



## how to use the module

define a serial port usually a "ttyUSB" or a "com" port
```
port = "/dev/ttyUSB0"
```
make an instance of the SDS011 class
```
sds = SDS011(port=port)
```
get some info on the sensor to check if it's working fine
```
print(sds)
```
set a working period for the sensor 
```
sds.set_working_period(rate=5)
```
get a dictionary with the keys "timestamp","pm2.5","pm10","devid" from the measurement queue
```
meas = sds.read_measurement()
```
This is a blocking function, so it waits until a measurement is received from the sensor, which can take some time depending on the working period. 

## getting values by socket

If the module is called with socket option,
```
sds = SDS011(port=port,use_socket=True,socket_portnum=9999)

```
it will open a socket on localhost and the given port which defaults to 9999.
You can check the output via netcat
```
nc localhost 9999
```
which outputs timestamp, pm2.5, pm10, device id
```
2018-06-02 10:36:04.980272,33.5,53.6,43897
2018-06-02 10:41:04.981235,39.5,145.3,43897
2018-06-02 10:54:14.573174,29.5,61.4,43897
```

## database option
If the module is called with database option,
```
sds = SDS011(port=port,use_database=True)
```
it will write values to an sqlite database.
jsonbase 10.0.10
jsonbase is a module that can help you use json as database
Requires Python: >=3.6

# **JSONBASE**
## Description:
### jsonbase is a simple database module
### you can use it to store a small amount of data
### but that doesn't mean that you can store a big amount of data

#
![Preview](https://i.ibb.co/tXQkprn/image.png)
#
## `Why use jsonbase?`
### jsonbase is simple and easy to use

## `Will my data safe?`
### We have used json for over 1 month
### and yes, your data will safe
#
## Usage
```py
import jsonbase

database = jsonbase.database('my_database')
database.create()
```
```py
data = database.get()

data['Variable'] = 'value'
data['List'] = ['element','item']
data['Dict'] = {'key':'value'}
database.save(data)
```
#
## Quick Link
### [Docs](https://hackmd.io/@WinXpDev/BJ52SUeJu)