Metadata-Version: 2.0
Name: QueryOEM
Version: 1.0.3
Summary: Query OEM for product informations
Home-page: https://github.com/FRReinert/StationScrapping
Author: Fabricio Roberto reinert
Author-email: fabricio.reinert@live.com
License: MIT license
Description-Content-Type: UNKNOWN
Keywords: OEM,Dell,Python,Web,Scrapping,JSON
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: beautifulsoup4
Requires-Dist: requests

# QueryOEM
Query OEM for information about workstations, laptops, servers and others.

# How to Install
Just issue ```pip install QueryOEM```

# Supported OEM's
Only DELL is supported at this moment

# Usage

## CLI usage

You can use it directly on the terminal

### Query a single tag
You can query a single tag using ```python3 -m QueryOEM.cli --tag <vendor> <servicetag>

Arguments
    - (Required) tag - Tag code
    - (Required) vendor - OEM name. Default is Dell

Example
```python
python  -m QueryOEM.cli --tag dell A2DA3CR
```

### Query using a text file

You can also create a tags.txt file, add 1 tag per line and query them in one single shot

Arguments
    - (Required) origin - Path to file containing service tags (1 per line)
    - (Required) output - Path to output file: Path to save output file
    - (Optional) vendor - Vendor - Default Dell
    - (Optional) format - Output format - Default JSON 

```python3 -m QueryOEM.cli --file origin=<text_file> output=<c:/temp/myfile>

Example:

tags.txt
```
ABC1234
QWE1234
IOP4321
```

```python -m QueryOEM.cli --file origin=tags.txt output=c:/temp/my_assets```

## Embedded to your code

There are two diferent classes. **QueryOEM** will query a single equipment and **MultipleQueryOEM** is a wrapper
which will return a list of **QueryOEM** instances.

Check the following usage for both classes:

### Quering a single equipment
```python
import QueryOEM

my_laptop = QueryOEM.QueryOEM(PART_NUMBER="XXXXXX")
my_laptop.get_from_dell()

# Return a dictionary
print(my_laptop.dell_data)

# Return a JSON and save it into a file
fopen = open('c:/temp/my_laptop.json', 'w')
fopen.write(my_laptop.json_from_dell())
fopen.close()
```

### Quering multiple equipments
```python
import QueryOEM

assets_list = MultipleQueryOEM(['XXXXXX','YYYYYY','WWWWWW','ZZZZZZ'])
assets_list.get_from_dell()

# Loop over the queried equipments
for i in assets_list.results:
  print(i)

# Retrieve a JSON containing all equipments
JSON = assets_list.json_from_dell()
fopen = open('c:/temp/assets_list.json', 'w')
fopen.write(JSON)
fopen.close()
```


# QueryOEM
Query OEM for information about workstations, laptops, servers and others.

1.0.0 First Release, 07/04/2017
- Installable module
- Support Dell OEM
- Query single/multuple service tags
- Export to json

1.0.1 07/05/2017
- Dell: Added Send date from vendor on the response

1.0.2 12/09/2017
- Added CLI support by using python -m QueryOEM.cli

1.0.3 12/09/2017
- Small changes on CLI help text

