dpckan


Namedpckan JSON
Version 0.1.22 PyPI version JSON
download
home_pagehttps://github.com/dados-mg/dpkgckanmg
SummaryFunções para gestão de pacotes de dados no portal dados.mg.gov.br
upload_time2023-08-29 19:23:13
maintainer
docs_urlNone
authorCONTROLADORIA GERAL DO ESTADO DE MINAS GERAIS - CGE/MG
requires_python
license
keywords python ckan
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # Data package manager para CKAN (dpckan)

[![Coverage](https://img.shields.io/codecov/c/github/transparencia-mg/dpckan/dev)](https://codecov.io/gh/transparencia-mg/dpckan)

O `dpckan` é um pacote Python, acessível via interface [CLI](https://pt.wikipedia.org/wiki/Interface_de_linha_de_comandos), utilizado para criação e atualização de conjuntos de dados e recursos (documentados de acordo com o padrão de metadados [Frictionless Data](https://frictionlessdata.io/)) em uma instância do [CKAN](https://ckan.org/).

Curiosidades: Consulte a comparação do dpckan com alguns [projetos relacionados](RELATED_PROJECTS.md).

[Documentação complementar](https://dpckan.readthedocs.io/en/latest/)

## Instalação

O `dpckan` está disponível no Python Package Index - [PyPI](https://pypi.org/project/dpckan/) e pode ser instalado utilizando-se o comando abaixo:

```bash
# Antes de executar o comando abaixo lembre-se que ambiente Python deverá estar ativo
$ pip install dpckan
```

## Configuração de Variáveis de ambiente

Todos os comandos exigem a indicação de uma instância CKAN (ex: https://demo.ckan.org/) e de uma chave válida para autenticação na referida instância. Esta indicação deverá ser realizada através do cadastro de variáveis de ambiente. Para invocação CLI de qualquer comando sem a necessidade de indicar explicitamente estas variáveis recomenda-se utilização dos nomes `CKAN_HOST` e `CKAN_KEY` para cadastro de instância e chave respectivamente. Caso outros nomes sejam utilizados, necessário indicar explicitamente durante a chamada da função desejada, utilizando-se as flags "--ckan-host" e "--ckan-key", conforme demostrado abaixo e ou de maneira mais detalhada na sessão [Uso](#uso).


```bash
# CKAN_HOST=https://demo.ckan.org/
# CKAN_KEY=CC850181-6ZS9-4f4C-bf3f-fb4db7ce09f90 (Chave CKAN meramente ilustrativa)
# Utilização sem necessidade de indicar explicitamente variáveis

$ dpckan dataset create
```

```bash
# CKAN_HOST_PRODUCAO=https://demo.ckan.org/
# CKAN_KEY_PRODUCAO=CC850181-6ZS9-4f4C-bf3f-fb4db7ce09f90 (Chave CKAN meramente ilustrativa)
# Utilização indicando explicitamente variáveis, através flags --ckan-host e --ckan-key

$ dpckan --ckan-host $CKAN_HOST_PRODUCAO --ckan-key $CKAN_KEY_PRODUCAO dataset create
```

O cadastro das variáveis de ambiente `CKAN_HOST` e `CKAN_KEY`, necessárias para invocação de cada comando, deverá ser realizada conforme sistema operacional do usuário. Abaixo links de referência para tal:

  * [Windows](https://professor-falken.com/pt/windows/como-configurar-la-ruta-y-las-variables-de-entorno-en-windows-10/)
  * [Linux](https://ricardo-reis.medium.com/vari%C3%A1veis-de-ambiente-no-linux-debian-f677d6ca94c)
  * [Mac](https://support.apple.com/pt-br/guide/terminal/apd382cc5fa-4f58-4449-b20a-41c53c006f8f/mac)


Alternativamente, o cadastro destas variáveis de ambiente poderá ser realizado em arquivo ".env", na raiz do conjunto de dados, sendo necessário a inclusão deste ".env" em arquivo ".gitignore", evitando assim a sincronização e consequente publicização destas chaves em repositórios online como [github](https://github.com/), conforme demostrado abaixo:


```bash
# CUIDADO: SOMENTE UTILIZE A OPÇÃO SUGERIDA ABAIXO SE POSSUIR FAMILIARIDADE COM O ASSUNTO, EVITANDO ASSIM PROBLEMAS COM ACESSO DE TERCEIROS NÃO AUTORIZADOS EM SUA INSTÂNCIA CKAN
# CUIDADO: SOMENTE EXECUTE OS COMANDOS ABAIXO SE OS ARQUIVO ".env" e ".gitignore" NÃO EXISTIREM NA RAIZ DO CONJUNTO DE DADOS
# CUIDADO: CASO COMANDOS ABAIXO SEJAM EXECUTADOS COM ".env" e ".gitignore" EXISTENTES TODO CONTEÚDO DOS MESMOS SERÁ APAGADO

# Crie arquivo ".env" com estrutura para receber chaves CKAN_HOST e CKAN_KEY
# Após a criação, abra o arquivo e inclua os valores para cada variável

$ echo "CKAN_HOST=''\nCKAN_KEY=''" > .env
```
```bash
# Crie arquivo ".gitignore" com configuração para excluir arquivo ".env" do controle de versão git

$ echo ".env" > .gitignore
```
```bash
# Confira se configuração foi realizada com sucesso
# Comando abaixo deverá mostrar apenas criação/modificação de arquivo ".gitignore", não sendo apresentado nada para arquivo ".env"

$ git status
```

## Uso

- Antes de executar cada comando verifique:
    - Se as variáveis de ambiente estão definidas corretamente;
    - O local aonde os comandos serão executados, pois a execução no mesmo diretório do arquivo datapackage.json simplificará o trabalho;
    - Não copie e cole os comandos sugeridos abaixo cegamente, indicações entre "<>" sevirão para ilustrar variáveis a serem adequadas para a realidade do usuário.


### Acessando documentação do dpckan via terminal

```bash
# Informações gerais sobre o pacote e seus comandos
$ dpckan --help

# Informações sobre comandos dataset e resource
$ dpckan dataset --help
$ dpckan resource --help

# Informações sobre sub-comandos dataset
$ dpckan dataset create --help
$ dpckan dataset update --help

# Informações sobre sub-comandos resource
$ dpckan resource create --help
$ dpckan resource update --help
```

### Interrompendo execução em caso de erros de validação frictionless

Durante a execução dos comandos dpckan a biblioteca `frictionless` será utilizada para [validação](https://framework.frictionlessdata.io/docs/guides/validation-guide) local do conjunto de dados via `frictionless validate`. Erros durante esta validação serão informados ao usuário mas somente interromperão a execução se a flag `--stop` for passada como parâmetro, conforme demonstrado abaixo:

```bash
$ dpckan dataset create --stop
```
### Baixando conjuntos de dados publicados em instância CKAN

- Para baixar um conjunto de dados publicado em alguma instância do CKAN utilize o comando abaixo:

```bash
$ dpckan dataset get --dataset-id dataset-link
```

### Criando e atualizando um conjunto de dados via terminal

Para criar um conjunto de dados, execute o comando no diretório aonde o arquivo datapackage.json se encontra:

```bash
$ dpckan dataset create
```

E para atualizar o conjunto de dados, execute o comando no diretório aonde o arquivo datapackage.json se encontra:

```bash
$ dpckan dataset update
```

CUIDADO: A atualização de conjunto de dados presupõe:

* Criação do conjunto de dados via comando `dpckan dataset create`;
* Criação de recursos via comando `dpckan resource create`; e
* Igualdade entre o número e nome dos recursos locais e da instância CKAN.

### Criando e atualizando recursos via terminal

CUIDADO: Recursos com nomes iguais além de desrespeitar a [especificação frictionless](https://specs.frictionlessdata.io/data-resource/#metadata-properties) confundem o usuário.

Para criar um recurso, execute o seguinte comando no diretório aonde o arquivo datapackage.json se encontra.

```bash
$ dpckan resource <nome-recurso> create
```

Para atualizar um recurso, execute o seguinte comando no diretório aonde o arquivo datapackage.json se encontra.

```bash
$ dpckan resource <nome-recurso> <id-recurso> update
```

Em ambiente de homologação cadastrado na máquina,

````
$ dpckan --ckan-host $HOMOLOGA_HOST --ckan-key $HOMOLOGA_KEY resource <nome_recurso> create
````
ou 
````
$ dpckan --ckan-host $HOMOLOGA_HOST --ckan-key $HOMOLOGA_KEY resource <nome_recurso> <id-recurso> update
````
para atualizar

## Contribuições

Pré-requisitos: Python 3.9 ou superior

[Documentação de referência mostrando procedimentos necessários para contribuição em um projeto open source](https://www.dataschool.io/how-to-contribute-on-github/)

- Passos básicos:
    - Crie um fork do repositório do projeto;
    - Clone o repositório criado em seu github após o fork;
    - Navegue até o repositório clonado em sua máquina;
    - Crie e ative um ambiente virtual Python para utilizar o projeto;
    - Crie um branch para realizar as modificações necessárias;
    - Realize o push da branch criada; e
    - Abra um PR explicando os motivos da mudança e como esta auxiliará no desenvolvimento do projeto.

### Atualizar versão

Conforme relatado no [issue 6](https://github.com/dados-mg/dpkgckanmg/issues/6), atualização de versões no [Pypi](https://pypi.org/) deve seguir [estes os passos](https://github.com/dados-mg/dpckan/issues/6#issuecomment-851678297)

## Licença

O **dpckan** é licenciado sob a licença MIT.
Veja o arquivo [`LICENSE.md`](LICENSE.md) para mais detalhes.


Change Log
==========

0.1.22 (29/08/2023)
------------------
- Melhora processo de criação/atualização datastore

0.1.21 (07/03/2023)
------------------
- Possibilita atualização de conjuntos privados

0.1.20 (16/02/2023)
------------------
- Fixa versões de pacotes dependentes - erro de atualização versão frictionless 5

0.1.19 (22/11/2022)
------------------
- Melhora mensagens de log informando qual host está sendo utilizado

0.1.18 (02/04/2022)
------------------
- Adiciona flag --exit-code
- Bug Fix na chamada da função `dataset update` que não estava atualizando metadados do conjunto

0.1.17 (14/03/2022)
------------------
- Bug Fix na chamada da função `resource_update` dentro de `dataset_update`

0.1.16 (14/03/2022)
------------------
- Inclusão função `dpckan dataset get`
- Correções flag `--datastore`
- Correções `dpckan resource create`

0.1.15 (21/02/2021)
------------------
- Registra ids de recursos publicados apenas na instância CKAN e não mais no arquivo datapackage.json local
- Revisa/simplifica documentação CLI
- Modifica chamada das funções

0.1.14 (27/12/2021)
------------------
- Corrige funcionamento da flag para acionamento do datastore nunca produzir efeitos
- Altera nome da flag para acionamento do datastore durante criação e atualização de conjunto de dados de metadata para datastore

0.1.13 (22/12/2021)
------------------
-  Remove extended do nome do arquivo extended_datapackage.json durante criação de recursos datapackage.json

0.1.12 (21/12/2021)
------------------
- Adiciona Flag metadata para acionamento datastore durante criação e atualização de conjunto de dados

0.1.11 (01/12/2021)
------------------
- Adicionando encoding para subir arquivos README, CONTRIBUTING e CHANGELOG para CKAN
- Atualizando metadado do conjunto caso apenas datapackage.json sofra modificações

0.1.10 (12/11/2021)
------------------
- Dataset update primeira versão, atualizando recursos e metadados modificados
- Pequenas refatorações

0.1.9 (12/11/2021)
------------------
- Correção pacote ipdb importado erradamente

0.1.8 (12/11/2021)
------------------
- Apaga propriedade ckan_hosts apenas da instância CKAN desejada
- Expansão schema e dialetic presentes no recurso datapackage.json importados na instância CKAN

0.1.7 (11/11/2021)
------------------
- Melhoria da implementação da documentação do conjunto de dados publicados no CKAN

0.1.6 (11/11/2021)
------------------
- Validando a existência da proprieda owner_org do arquivo datapackage.json
- Validando a existência do valor da propriedade owner_org do arquivo datapackage.json na instância do CKAN desejada

0.1.5 (11/11/2021)
------------------
- Melhoria de documentação click (--help)
- Inclusão de flag --stop para interromper execução em caso de falha de validação frictionless

0.1.4 (08/11/2021)
------------------
- Separação pacotes de desenvolvimento (requirements.txt) de pacotes de utilização (setup.py)
- Inclusão frictionless validate como validações

0.1.3 (20/10/2021)
------------------
- Erro de publicação desta versão

0.1.2 (20/10/2021)
------------------
- Update python-dotenv

0.1.1 (08/09/2021)
------------------
- Revisão documentação README.md
- Revisão documentação docstrings
- Revisão estrutura testes

0.1.0 (23/08/2021)
------------------
- Criação dos comandos cli para criação e atualização de datasets
- Criação dos comandos cli para criação e atualização de recursos
- Melhoria da documentação

0.0.1.9020 (09/06/2021)
------------------
- Publicação de documentação online do pacote
- Correção de bugs e exclusão de códigos repetidos ao longo do projeto


0.0.1.9000 (06/05/2021)
------------------
- Lançamento primeira versão de teste do pacote



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/dados-mg/dpkgckanmg",
    "name": "dpckan",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "python,ckan",
    "author": "CONTROLADORIA GERAL DO ESTADO DE MINAS GERAIS - CGE/MG",
    "author_email": "dadosabertos@cge.mg.gov.br",
    "download_url": "https://files.pythonhosted.org/packages/b0/98/271b0c0330d76068ba54f3c192fb4d302ac9bf10503c1bb97a25aef28a3b/dpckan-0.1.22.tar.gz",
    "platform": null,
    "description": "# Data package manager para CKAN (dpckan)\n\n[![Coverage](https://img.shields.io/codecov/c/github/transparencia-mg/dpckan/dev)](https://codecov.io/gh/transparencia-mg/dpckan)\n\nO `dpckan` \u00e9 um pacote Python, acess\u00edvel via interface [CLI](https://pt.wikipedia.org/wiki/Interface_de_linha_de_comandos), utilizado para cria\u00e7\u00e3o e atualiza\u00e7\u00e3o de conjuntos de dados e recursos (documentados de acordo com o padr\u00e3o de metadados [Frictionless Data](https://frictionlessdata.io/)) em uma inst\u00e2ncia do [CKAN](https://ckan.org/).\n\nCuriosidades: Consulte a compara\u00e7\u00e3o do dpckan com alguns [projetos relacionados](RELATED_PROJECTS.md).\n\n[Documenta\u00e7\u00e3o complementar](https://dpckan.readthedocs.io/en/latest/)\n\n## Instala\u00e7\u00e3o\n\nO `dpckan` est\u00e1 dispon\u00edvel no Python Package Index - [PyPI](https://pypi.org/project/dpckan/) e pode ser instalado utilizando-se o comando abaixo:\n\n```bash\n# Antes de executar o comando abaixo lembre-se que ambiente Python dever\u00e1 estar ativo\n$ pip install dpckan\n```\n\n## Configura\u00e7\u00e3o de Vari\u00e1veis de ambiente\n\nTodos os comandos exigem a indica\u00e7\u00e3o de uma inst\u00e2ncia CKAN (ex: https://demo.ckan.org/) e de uma chave v\u00e1lida para autentica\u00e7\u00e3o na referida inst\u00e2ncia. Esta indica\u00e7\u00e3o dever\u00e1 ser realizada atrav\u00e9s do cadastro de vari\u00e1veis de ambiente. Para invoca\u00e7\u00e3o CLI de qualquer comando sem a necessidade de indicar explicitamente estas vari\u00e1veis recomenda-se utiliza\u00e7\u00e3o dos nomes `CKAN_HOST` e `CKAN_KEY` para cadastro de inst\u00e2ncia e chave respectivamente. Caso outros nomes sejam utilizados, necess\u00e1rio indicar explicitamente durante a chamada da fun\u00e7\u00e3o desejada, utilizando-se as flags \"--ckan-host\" e \"--ckan-key\", conforme demostrado abaixo e ou de maneira mais detalhada na sess\u00e3o [Uso](#uso).\n\n\n```bash\n# CKAN_HOST=https://demo.ckan.org/\n# CKAN_KEY=CC850181-6ZS9-4f4C-bf3f-fb4db7ce09f90 (Chave CKAN meramente ilustrativa)\n# Utiliza\u00e7\u00e3o sem necessidade de indicar explicitamente vari\u00e1veis\n\n$ dpckan dataset create\n```\n\n```bash\n# CKAN_HOST_PRODUCAO=https://demo.ckan.org/\n# CKAN_KEY_PRODUCAO=CC850181-6ZS9-4f4C-bf3f-fb4db7ce09f90 (Chave CKAN meramente ilustrativa)\n# Utiliza\u00e7\u00e3o indicando explicitamente vari\u00e1veis, atrav\u00e9s flags --ckan-host e --ckan-key\n\n$ dpckan --ckan-host $CKAN_HOST_PRODUCAO --ckan-key $CKAN_KEY_PRODUCAO dataset create\n```\n\nO cadastro das vari\u00e1veis de ambiente `CKAN_HOST` e `CKAN_KEY`, necess\u00e1rias para invoca\u00e7\u00e3o de cada comando, dever\u00e1 ser realizada conforme sistema operacional do usu\u00e1rio. Abaixo links de refer\u00eancia para tal:\n\n  * [Windows](https://professor-falken.com/pt/windows/como-configurar-la-ruta-y-las-variables-de-entorno-en-windows-10/)\n  * [Linux](https://ricardo-reis.medium.com/vari%C3%A1veis-de-ambiente-no-linux-debian-f677d6ca94c)\n  * [Mac](https://support.apple.com/pt-br/guide/terminal/apd382cc5fa-4f58-4449-b20a-41c53c006f8f/mac)\n\n\nAlternativamente, o cadastro destas vari\u00e1veis de ambiente poder\u00e1 ser realizado em arquivo \".env\", na raiz do conjunto de dados, sendo necess\u00e1rio a inclus\u00e3o deste \".env\" em arquivo \".gitignore\", evitando assim a sincroniza\u00e7\u00e3o e consequente publiciza\u00e7\u00e3o destas chaves em reposit\u00f3rios online como [github](https://github.com/), conforme demostrado abaixo:\n\n\n```bash\n# CUIDADO: SOMENTE UTILIZE A OP\u00c7\u00c3O SUGERIDA ABAIXO SE POSSUIR FAMILIARIDADE COM O ASSUNTO, EVITANDO ASSIM PROBLEMAS COM ACESSO DE TERCEIROS N\u00c3O AUTORIZADOS EM SUA INST\u00c2NCIA CKAN\n# CUIDADO: SOMENTE EXECUTE OS COMANDOS ABAIXO SE OS ARQUIVO \".env\" e \".gitignore\" N\u00c3O EXISTIREM NA RAIZ DO CONJUNTO DE DADOS\n# CUIDADO: CASO COMANDOS ABAIXO SEJAM EXECUTADOS COM \".env\" e \".gitignore\" EXISTENTES TODO CONTE\u00daDO DOS MESMOS SER\u00c1 APAGADO\n\n# Crie arquivo \".env\" com estrutura para receber chaves CKAN_HOST e CKAN_KEY\n# Ap\u00f3s a cria\u00e7\u00e3o, abra o arquivo e inclua os valores para cada vari\u00e1vel\n\n$ echo \"CKAN_HOST=''\\nCKAN_KEY=''\" > .env\n```\n```bash\n# Crie arquivo \".gitignore\" com configura\u00e7\u00e3o para excluir arquivo \".env\" do controle de vers\u00e3o git\n\n$ echo \".env\" > .gitignore\n```\n```bash\n# Confira se configura\u00e7\u00e3o foi realizada com sucesso\n# Comando abaixo dever\u00e1 mostrar apenas cria\u00e7\u00e3o/modifica\u00e7\u00e3o de arquivo \".gitignore\", n\u00e3o sendo apresentado nada para arquivo \".env\"\n\n$ git status\n```\n\n## Uso\n\n- Antes de executar cada comando verifique:\n    - Se as vari\u00e1veis de ambiente est\u00e3o definidas corretamente;\n    - O local aonde os comandos ser\u00e3o executados, pois a execu\u00e7\u00e3o no mesmo diret\u00f3rio do arquivo datapackage.json simplificar\u00e1 o trabalho;\n    - N\u00e3o copie e cole os comandos sugeridos abaixo cegamente, indica\u00e7\u00f5es entre \"<>\" sevir\u00e3o para ilustrar vari\u00e1veis a serem adequadas para a realidade do usu\u00e1rio.\n\n\n### Acessando documenta\u00e7\u00e3o do dpckan via terminal\n\n```bash\n# Informa\u00e7\u00f5es gerais sobre o pacote e seus comandos\n$ dpckan --help\n\n# Informa\u00e7\u00f5es sobre comandos dataset e resource\n$ dpckan dataset --help\n$ dpckan resource --help\n\n# Informa\u00e7\u00f5es sobre sub-comandos dataset\n$ dpckan dataset create --help\n$ dpckan dataset update --help\n\n# Informa\u00e7\u00f5es sobre sub-comandos resource\n$ dpckan resource create --help\n$ dpckan resource update --help\n```\n\n### Interrompendo execu\u00e7\u00e3o em caso de erros de valida\u00e7\u00e3o frictionless\n\nDurante a execu\u00e7\u00e3o dos comandos dpckan a biblioteca `frictionless` ser\u00e1 utilizada para [valida\u00e7\u00e3o](https://framework.frictionlessdata.io/docs/guides/validation-guide) local do conjunto de dados via `frictionless validate`. Erros durante esta valida\u00e7\u00e3o ser\u00e3o informados ao usu\u00e1rio mas somente interromper\u00e3o a execu\u00e7\u00e3o se a flag `--stop` for passada como par\u00e2metro, conforme demonstrado abaixo:\n\n```bash\n$ dpckan dataset create --stop\n```\n### Baixando conjuntos de dados publicados em inst\u00e2ncia CKAN\n\n- Para baixar um conjunto de dados publicado em alguma inst\u00e2ncia do CKAN utilize o comando abaixo:\n\n```bash\n$ dpckan dataset get --dataset-id dataset-link\n```\n\n### Criando e atualizando um conjunto de dados via terminal\n\nPara criar um conjunto de dados, execute o comando no diret\u00f3rio aonde o arquivo datapackage.json se encontra:\n\n```bash\n$ dpckan dataset create\n```\n\nE para atualizar o conjunto de dados, execute o comando no diret\u00f3rio aonde o arquivo datapackage.json se encontra:\n\n```bash\n$ dpckan dataset update\n```\n\nCUIDADO: A atualiza\u00e7\u00e3o de conjunto de dados presup\u00f5e:\n\n* Cria\u00e7\u00e3o do conjunto de dados via comando `dpckan dataset create`;\n* Cria\u00e7\u00e3o de recursos via comando `dpckan resource create`; e\n* Igualdade entre o n\u00famero e nome dos recursos locais e da inst\u00e2ncia CKAN.\n\n### Criando e atualizando recursos via terminal\n\nCUIDADO: Recursos com nomes iguais al\u00e9m de desrespeitar a [especifica\u00e7\u00e3o frictionless](https://specs.frictionlessdata.io/data-resource/#metadata-properties) confundem o usu\u00e1rio.\n\nPara criar um recurso, execute o seguinte comando no diret\u00f3rio aonde o arquivo datapackage.json se encontra.\n\n```bash\n$ dpckan resource <nome-recurso> create\n```\n\nPara atualizar um recurso, execute o seguinte comando no diret\u00f3rio aonde o arquivo datapackage.json se encontra.\n\n```bash\n$ dpckan resource <nome-recurso> <id-recurso> update\n```\n\nEm ambiente de homologa\u00e7\u00e3o cadastrado na m\u00e1quina,\n\n````\n$ dpckan --ckan-host $HOMOLOGA_HOST --ckan-key $HOMOLOGA_KEY resource <nome_recurso> create\n````\nou \n````\n$ dpckan --ckan-host $HOMOLOGA_HOST --ckan-key $HOMOLOGA_KEY resource <nome_recurso> <id-recurso> update\n````\npara atualizar\n\n## Contribui\u00e7\u00f5es\n\nPr\u00e9-requisitos: Python 3.9 ou superior\n\n[Documenta\u00e7\u00e3o de refer\u00eancia mostrando procedimentos necess\u00e1rios para contribui\u00e7\u00e3o em um projeto open source](https://www.dataschool.io/how-to-contribute-on-github/)\n\n- Passos b\u00e1sicos:\n    - Crie um fork do reposit\u00f3rio do projeto;\n    - Clone o reposit\u00f3rio criado em seu github ap\u00f3s o fork;\n    - Navegue at\u00e9 o reposit\u00f3rio clonado em sua m\u00e1quina;\n    - Crie e ative um ambiente virtual Python para utilizar o projeto;\n    - Crie um branch para realizar as modifica\u00e7\u00f5es necess\u00e1rias;\n    - Realize o push da branch criada; e\n    - Abra um PR explicando os motivos da mudan\u00e7a e como esta auxiliar\u00e1 no desenvolvimento do projeto.\n\n### Atualizar vers\u00e3o\n\nConforme relatado no [issue 6](https://github.com/dados-mg/dpkgckanmg/issues/6), atualiza\u00e7\u00e3o de vers\u00f5es no [Pypi](https://pypi.org/) deve seguir [estes os passos](https://github.com/dados-mg/dpckan/issues/6#issuecomment-851678297)\n\n## Licen\u00e7a\n\nO **dpckan** \u00e9 licenciado sob a licen\u00e7a MIT.\nVeja o arquivo [`LICENSE.md`](LICENSE.md) para mais detalhes.\n\n\nChange Log\n==========\n\n0.1.22 (29/08/2023)\n------------------\n- Melhora processo de cria\u00e7\u00e3o/atualiza\u00e7\u00e3o datastore\n\n0.1.21 (07/03/2023)\n------------------\n- Possibilita atualiza\u00e7\u00e3o de conjuntos privados\n\n0.1.20 (16/02/2023)\n------------------\n- Fixa vers\u00f5es de pacotes dependentes - erro de atualiza\u00e7\u00e3o vers\u00e3o frictionless 5\n\n0.1.19 (22/11/2022)\n------------------\n- Melhora mensagens de log informando qual host est\u00e1 sendo utilizado\n\n0.1.18 (02/04/2022)\n------------------\n- Adiciona flag --exit-code\n- Bug Fix na chamada da fun\u00e7\u00e3o `dataset update` que n\u00e3o estava atualizando metadados do conjunto\n\n0.1.17 (14/03/2022)\n------------------\n- Bug Fix na chamada da fun\u00e7\u00e3o `resource_update` dentro de `dataset_update`\n\n0.1.16 (14/03/2022)\n------------------\n- Inclus\u00e3o fun\u00e7\u00e3o `dpckan dataset get`\n- Corre\u00e7\u00f5es flag `--datastore`\n- Corre\u00e7\u00f5es `dpckan resource create`\n\n0.1.15 (21/02/2021)\n------------------\n- Registra ids de recursos publicados apenas na inst\u00e2ncia CKAN e n\u00e3o mais no arquivo datapackage.json local\n- Revisa/simplifica documenta\u00e7\u00e3o CLI\n- Modifica chamada das fun\u00e7\u00f5es\n\n0.1.14 (27/12/2021)\n------------------\n- Corrige funcionamento da flag para acionamento do datastore nunca produzir efeitos\n- Altera nome da flag para acionamento do datastore durante cria\u00e7\u00e3o e atualiza\u00e7\u00e3o de conjunto de dados de metadata para datastore\n\n0.1.13 (22/12/2021)\n------------------\n-  Remove extended do nome do arquivo extended_datapackage.json durante cria\u00e7\u00e3o de recursos datapackage.json\n\n0.1.12 (21/12/2021)\n------------------\n- Adiciona Flag metadata para acionamento datastore durante cria\u00e7\u00e3o e atualiza\u00e7\u00e3o de conjunto de dados\n\n0.1.11 (01/12/2021)\n------------------\n- Adicionando encoding para subir arquivos README, CONTRIBUTING e CHANGELOG para CKAN\n- Atualizando metadado do conjunto caso apenas datapackage.json sofra modifica\u00e7\u00f5es\n\n0.1.10 (12/11/2021)\n------------------\n- Dataset update primeira vers\u00e3o, atualizando recursos e metadados modificados\n- Pequenas refatora\u00e7\u00f5es\n\n0.1.9 (12/11/2021)\n------------------\n- Corre\u00e7\u00e3o pacote ipdb importado erradamente\n\n0.1.8 (12/11/2021)\n------------------\n- Apaga propriedade ckan_hosts apenas da inst\u00e2ncia CKAN desejada\n- Expans\u00e3o schema e dialetic presentes no recurso datapackage.json importados na inst\u00e2ncia CKAN\n\n0.1.7 (11/11/2021)\n------------------\n- Melhoria da implementa\u00e7\u00e3o da documenta\u00e7\u00e3o do conjunto de dados publicados no CKAN\n\n0.1.6 (11/11/2021)\n------------------\n- Validando a exist\u00eancia da proprieda owner_org do arquivo datapackage.json\n- Validando a exist\u00eancia do valor da propriedade owner_org do arquivo datapackage.json na inst\u00e2ncia do CKAN desejada\n\n0.1.5 (11/11/2021)\n------------------\n- Melhoria de documenta\u00e7\u00e3o click (--help)\n- Inclus\u00e3o de flag --stop para interromper execu\u00e7\u00e3o em caso de falha de valida\u00e7\u00e3o frictionless\n\n0.1.4 (08/11/2021)\n------------------\n- Separa\u00e7\u00e3o pacotes de desenvolvimento (requirements.txt) de pacotes de utiliza\u00e7\u00e3o (setup.py)\n- Inclus\u00e3o frictionless validate como valida\u00e7\u00f5es\n\n0.1.3 (20/10/2021)\n------------------\n- Erro de publica\u00e7\u00e3o desta vers\u00e3o\n\n0.1.2 (20/10/2021)\n------------------\n- Update python-dotenv\n\n0.1.1 (08/09/2021)\n------------------\n- Revis\u00e3o documenta\u00e7\u00e3o README.md\n- Revis\u00e3o documenta\u00e7\u00e3o docstrings\n- Revis\u00e3o estrutura testes\n\n0.1.0 (23/08/2021)\n------------------\n- Cria\u00e7\u00e3o dos comandos cli para cria\u00e7\u00e3o e atualiza\u00e7\u00e3o de datasets\n- Cria\u00e7\u00e3o dos comandos cli para cria\u00e7\u00e3o e atualiza\u00e7\u00e3o de recursos\n- Melhoria da documenta\u00e7\u00e3o\n\n0.0.1.9020 (09/06/2021)\n------------------\n- Publica\u00e7\u00e3o de documenta\u00e7\u00e3o online do pacote\n- Corre\u00e7\u00e3o de bugs e exclus\u00e3o de c\u00f3digos repetidos ao longo do projeto\n\n\n0.0.1.9000 (06/05/2021)\n------------------\n- Lan\u00e7amento primeira vers\u00e3o de teste do pacote\n\n\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Fun\u00e7\u00f5es para gest\u00e3o de pacotes de dados no portal dados.mg.gov.br",
    "version": "0.1.22",
    "project_urls": {
        "Homepage": "https://github.com/dados-mg/dpkgckanmg"
    },
    "split_keywords": [
        "python",
        "ckan"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "400be44ce746a6a5165ece451780097e5bed4f882934cbc4cbe09282005b86dc",
                "md5": "1e2487cd20a9cc99fe705581006ff6ca",
                "sha256": "7d22dd918692fa82e4c1481e5200a6b64c745edceaaccf431b85eb35ee3a73ee"
            },
            "downloads": -1,
            "filename": "dpckan-0.1.22-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1e2487cd20a9cc99fe705581006ff6ca",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 19668,
            "upload_time": "2023-08-29T19:22:58",
            "upload_time_iso_8601": "2023-08-29T19:22:58.646256Z",
            "url": "https://files.pythonhosted.org/packages/40/0b/e44ce746a6a5165ece451780097e5bed4f882934cbc4cbe09282005b86dc/dpckan-0.1.22-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b098271b0c0330d76068ba54f3c192fb4d302ac9bf10503c1bb97a25aef28a3b",
                "md5": "c29c935aa25e006c501b7de892cee079",
                "sha256": "06e690ee9c63a644eb2902f14064df1878450d39cbc840ddcf4556bd73a32a80"
            },
            "downloads": -1,
            "filename": "dpckan-0.1.22.tar.gz",
            "has_sig": false,
            "md5_digest": "c29c935aa25e006c501b7de892cee079",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 14905730,
            "upload_time": "2023-08-29T19:23:13",
            "upload_time_iso_8601": "2023-08-29T19:23:13.681359Z",
            "url": "https://files.pythonhosted.org/packages/b0/98/271b0c0330d76068ba54f3c192fb4d302ac9bf10503c1bb97a25aef28a3b/dpckan-0.1.22.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-29 19:23:13",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "dados-mg",
    "github_project": "dpkgckanmg",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "lcname": "dpckan"
}
        
Elapsed time: 0.14967s